Tabele działań poczty e-mail

Tabela działań poczty e-mail ułatwia śledzenie komunikacji e-mail i zarządzanie nią z klientami.

Akcje dotyczące działania poczty e-mail

Za pomocą usług internetowych Dataverse można wykonać następujące akcje w działaniu poczty e-mail:

• Tworzenie, pobieranie, aktualizowanie i usuwanie działania poczty e-mail.

• Wysyłanie wiadomości e-mail lub wysyłanie wiadomości e-mail przy użyciu szablonów wiadomości e-mail (Template). Aby uzyskać więcej informacji na temat szablonów wiadomości e-mail, zobacz Tworzenie szablonów wiadomości e-mail.

• Dołącz pliki jako załączniki przy użyciu atrybutu (ActivityMimeAttachment) w wiadomości e-mail.

• Wysyłanie masowych lub zbiorczych wiadomości e-mail.

• Skonfiguruj przychodzące wiadomości e-mail, które mają być dostarczane z Microsoft Exchange Server do dowolnego użytkownika, kolejki lub komunikatów wychodzących, które mają być wysyłane od dowolnego użytkownika lub kolejki do Microsoft Exchange Server.

  Jeśli atrybuty organizacji i Organization.RequireApprovalForuserEmailOrganization.RequireApprovalForQueueEmail (przetwarzaj wiadomości e-mail tylko dla zatwierdzonych użytkowników/kolejek) są ustawione na wartość true (1), zachodzą następujące zdarzenia: wiadomości e-mail są dostarczane lub wysyłane od użytkownika lub kolejki tylko wtedy, gdy podstawowy adres e-mail użytkownika lub kolejki zostanie zatwierdzony. Atrybuty SystemUser.EmailRouterAccessApproval i Queue.EmailRouterAccessApproval wskazują stan podstawowego adresu e-mail użytkownika i kolejki, a wartość musi być ustawiona na 1. W przeciwnym razie komunikaty przychodzące i wychodzące są blokowane. Możesz zaktualizować rekord użytkownika lub kolejki, aby zmienić wartość atrybutu, jeśli nie jest jeszcze w stanie zatwierdzonym, pod warunkiem, że konto użytkownika ma przypisane uprawnienie prvApproveRejectEmailAddress .

Zbiorcza wiadomość e-mail

Usługa Dataverse obsługuje wysyłanie wiadomości e-mail do dużej listy adresatów za pośrednictwem zbiorczego żądania e-mail. Po wysłaniu żądania dotyczącego wysyłki masowych wiadomości e-mail do usługi Dataverse operacja asynchroniczna jest tworzona w kolejce asynchronicznej usługi, która wysyła wiadomości e-mail przy użyciu procesu w tle. Ten proces poprawia wydajność systemu.

Użyj wiadomości SendBulkMailRequest i BackgroundSendEmailRequest do wysyłania zbiorczych wiadomości e-mail. Poniższa lista zawiera opis sekwencji używanej do wysyłania zbiorczej wiadomości e-mail:

1. Wykonaj żądanie SendBulkMail . To żądanie zawiera zapytanie, które wybiera docelowych odbiorców wiadomości e-mail oraz szablon wiadomości e-mail do tworzenia każdej wiadomości e-mail.

2. Usługa asynchroniczna tworzy działania poczty e-mail dla każdego adresata.

3. Usługa asynchroniczna wysyła każdą wiadomość e-mail. Wiadomości e-mail mają status "oczekujące" wysłania.

4. Router poczty e-mail, Dynamics 365 for Outlook lub składnik innej firmy do wysyłania wiadomości e-mail sprawdza w usłudze Dataverse, czy istnieją oczekujące wiadomości e-mail. Jeśli je znajdzie, pobiera komunikat za pomocą żądania BackgroundSendEmail.

5. Żądanie BackgroundSendEmail wykonuje następujące operacje: sprawdza, czy istnieją oczekujące wiadomości e-mail, pobiera wiadomość e-mail do osoby wywołującej BackgroundSendEmailRequest wiadomość i synchronizuje pobrane pliki, jeśli jest wielu rozmówców.

   Uwaga / Notatka

   Dostawca usług poczty e-mail może mieć limity wpływające na liczbę wiadomości e-mail, które można wysłać w danym okresie. Aby uzyskać więcej informacji, zobacz Exchange Online limity wysyłania>.

6. Element wywołujący komunikat BackgroundSendEmailRequest otrzymuje pobraną wiadomość e-mail i wysyła ją.

Załączniki wiadomości e-mail

Załączniki wiadomości e-mail to pliki, które można dołączyć do wiadomości e-mail lub szablonów wiadomości e-mail. Dołączony plik może być w dowolnym standardowym formacie pliku komputera, takim jak dokumenty pakietu Office Outlook, arkusze kalkulacyjne pakietu Office Excel, pliki CAD i pliki PDF. Możesz dołączyć wiele plików jako załączniki do wiadomości e-mail lub szablonu wiadomości e-mail. Właściwość Organization.MaxUploadFileSize określa maksymalny rozmiar plików, które można przekazać. Ustaw tę właściwość na karcie Adres e-mailustawień systemowych w aplikacji Dynamics 365. To ustawienie ogranicza rozmiar plików, które można dołączać do wiadomości e-mail, notatek i zasobów internetowych. Ustawienie domyślne to 5 MB.

Aby dołączyć załącznik do wiadomości e-mail lub szablonu, użyj kolumn ActivityMimeAttachment.ObjectId i ActivityMimeAttachment.ObjectTypeCode podczas tworzenia lub aktualizowania wiersza załącznika MIME dla działania.

Poniższy przykładowy kod pokazuje, jak dołączyć załącznik wiadomości e-mail do wiadomości e-mail:

ActivityMimeAttachment _sampleAttachment = new ActivityMimeAttachment{  
    ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),  
    ObjectTypeCode = Email.EntityLogicalName,  
    Subject = "Sample Attachment",  
    Body = System.Convert.ToBase64String(new ASCIIEncoding().GetBytes("Example Attachment")),  
    FileName = "ExampleAttachment.txt"};  

Podobnie, aby dołączyć załącznik wiadomości e-mail do szablonu zamiast do wiadomości e-mail, zastąp w poprzednim kodzie wartości atrybutów ActivityMimeAttachment.ObjectId i ActivityMimeAttachment.ObjectTypeCode w następujący sposób:

ObjectId = new EntityReference(Template.EntityLogicalName, _templateId), ObjectTypeCode = Template.EntityLogicalName,  

Pełny przykładowy kod dotyczący tworzenia załączników wiadomości e-mail można znaleźć w temacie Sample: Create, retrieve, update, and delete an email attachment (Przykład: tworzenie, pobieranie, aktualizowanie i usuwanie załącznika wiadomości e-mail).

Ponowne dołączanie załączników wiadomości e-mail

Podczas tworzenia rekordu załącznika wiadomości e-mail usługa Dataverse zapisuje dołączony plik jako plik BLOB. Atrybut ActivityMimeAttachment.AttachmentId rekordu załącznika wiadomości e-mail jednoznacznie identyfikuje plik BLOB. Ten proces ułatwia ponowne używanie załączników plików z innymi rekordami szablonów wiadomości e-mail i wiadomości e-mail bez tworzenia i przechowywania wielu kopii tego samego pliku w bazie danych.

Aby ponownie użyć istniejącego pliku załącznika:

1. ActivityMimeAttachment Pobierz wiersz zawierający plik załącznika, którego chcesz użyć ponownie, jak pokazano w poniższym przykładzie kodu:

   ActivityMimeAttachment retrievedAttachment = 
       (ActivityMimeAttachment)_serviceProxy
       .Retrieve(ActivityMimeAttachment.EntityLogicalName, _emailAttachmentId, new ColumnSet(true));  
   

2. Utwórz nowy załącznik wiadomości e-mail, skojarz go z wymaganym wierszem wiadomości e-mail lub szablonem wiadomości e-mail i wskaż dołączony plik pobranego ActivityMimeAttachment wiersza, jak pokazano w poniższym przykładzie kodu:

   ActivityMimeAttachment _reuseAttachment = new ActivityMimeAttachment{  
     ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),  
     ObjectTypeCode = Email.EntityLogicalName,  
     Subject = "Sample Attachment",  
     AttachmentId = retrievedAttachment.AttachmentId};  
   

Ponieważ korzystasz z istniejącego pliku załącznika, nie musisz określać wartości kolumn ActivityMimeAttachment.Body i ActivityMimeAttachment.FileName podczas tworzenia i powiązywania wierszy załączników z wiadomościami e-mail lub szablonami wiadomości e-mail.

Przechowywanie poczty email

Opisy wiadomości e-mail (treść wiadomości e-mail) były do tej pory przechowywane w relacyjnym magazynie Dataverse. Zmienia się to podczas gdy kolumna Email.Description w tabeli działań poczty e-mail jest przenoszona do niestrukturalnego magazynu obiektów blob platformy Azure. Usługa Azure Blob Storage jest również używana do przechowywania załączników, adnotacji, plików i obrazów.

Okres przejściowy

Migracja danych z magazynu relacji usługi Dataverse do usługi Azure Blob Storage dla wszystkich klientów ma rozpocząć się w maju 2023 r. Ta migracja danych odbędzie się jako proces w tle (zadanie). Początkowe przenoszenie danych dla istniejących klientów powinno trwać od około 6 do 12 tygodni, a nawet nawet dłużej w zależności od rozmiaru danych. Po początkowym przeniesieniu danych, ewentualna pozostała migracja jest procesem ciągłym. Wszystkie opisy wiadomości e-mail starsze niż dwanaście miesięcy zostaną automatycznie przeniesione do usługi Azure Blob Storage, a ten dwunastomiesięczny okres przejściowy nie może zostać zmieniony. Nowsze wiadomości e-mail nie zostaną przeniesione, dopóki nie staną się 12-miesięczne. Zadanie migracji opisu wiadomości e-mail uruchamiane jest okresowo — około raz na 30–60 dni dla każdego najemcy.

Ta migracja danych będzie przejrzysta dla użytkownika z wyjątkiem tego, że zobaczysz zmniejszenie rozmiaru tabeli ActivityPointer po całkowitym zakończeniu procesu migracji. W centrum administracyjnym platformy Power Platform w raporcie Pojemność nowy element wiersza wiadomości e-mail będzie dostępny w obszarze Użycie pliku. Wynikiem końcowym jest wzrost ogólnego użycia magazynu plików i zmniejszenie ilości używanego magazynu bazy danych.

Ograniczenia wymienione w następnej sekcji zaczną mieć zastosowanie do wszelkich danych, które zostały już przeniesione do usługi Azure Blob Storage zarządzanej przez Dataverse, nawet jeśli cały proces przenoszenia danych nie został jeszcze zakończony.

Ograniczenia wyszukiwania i filtrowania

W przypadku opisów wiadomości e-mail (treści) przechowywanych w usłudze Azure Blob Storage niektóre ograniczenia dotyczą filtrowania, znajdowania i wyszukiwania opisów wiadomości e-mail zgodnie z opisem w poniższych sekcjach.

Filtering

Filtrowanie opisów wiadomości e-mail nie jest obsługiwane. Oto niektóre konkretne kwestie, które należy wziąć pod uwagę:

• FetchXML — nie można wyszukiwać w treści wiadomości e-mail przy użyciu narzędzia FetchXML.
• Szybkie znajdowanie i wyszukiwanie zaawansowane — nie można filtrować opisów wiadomości e-mail przy użyciu tych metod.

Wyszukiwanie

Możesz włączyć wyszukiwanie w usłudze Dataverse w opisach wiadomości e-mail w celu wyszukiwania opisów wiadomości e-mail.

Zobacz także

Tabele działań
Przykład: wysyłanie wiadomości e-mail
Tabela wiadomości e-mail
Tabela ActivityMimeAttachment