Udostępnij przez


Tabele działań poczty e-mail

Działanie poczty e-mail umożliwia śledzenie komunikacji e-mail z klientami i zarządzanie nią.

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 wiadomości przychodzące i wychodzące zostaną zablokowane. 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 .

Uwaga / Notatka

W usłudze Dataverse Email.StatusCode atrybut nie może mieć wartości null.

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. Zapewnia to lepszą wydajność systemu.

Wiadomości SendBulkMailRequest i BackgroundSendEmailRequest służą do wysyłania zbiorczych wiadomości e-mail. Poniżej znajduje się lista sekwencji używanej do wysyłania zbiorczych 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 dla Outlooka lub komponent wysyłający e-maile innej firmy monitoruje usługę Dataverse w poszukiwaniu oczekujących wiadomości e-mail, a jeśli zostanie znaleziona, pobiera ją 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, które mają wpływ na liczbę wiadomości e-mail, które można wysłać w danym okresie. Więcej informacji: Limity wysyłania w usłudze > Exchange Online.

  6. Nadawca wiadomości BackgroundSendEmailRequest otrzymuje pobraną wiadomość e-mail i przesyła ją dalej.

Załączniki wiadomości e-mail

Załączniki do wiadomości e-mail to pliki, które można dołączać 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 programu Office Outlook, arkusze kalkulacyjne programu 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. Maksymalny rozmiar plików, które można przekazać, jest określany przez właściwość Organization.MaxUploadFileSize . Ta właściwość jest ustawiana na karcie Poczta e-mail w Ustawieniach systemu w aplikacji Dynamics 365. To ustawienie ogranicza rozmiar plików, które mogą być dołączane 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, w powyższym kodzie zastąpisz wartości atrybutów ActivityMimeAttachment.ObjectId i ActivityMimeAttachment.ObjectTypeCode w następujący sposób:

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

Aby uzyskać kompletny przykładowy kod dotyczący tworzenia załączników wiadomości e-mail, zobacz Przykład: Tworzenie, pobieranie, aktualizowanie i usuwanie załącznika wiadomości e-mail.

Ponowne używanie załączników do wiadomości e-mail

Podczas tworzenia rekordu załącznika do wiadomości e-mail załączony plik jest zapisywany jako plik BLOB. Atrybut ActivityMimeAttachment.AttachmentId rekordu załącznika wiadomości e-mail jednoznacznie identyfikuje plik BLOB. Ma to na celu ułatwienie ponownego wykorzystania załączników z innymi wiadomościami e-mail i rekordami szablonów 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.

Uwaga / Notatka

Wzrost magazynu plików może być mniejszy niż to, co zostało usunięte z tabeli ActivityPointer z powodu kompresji danych plików.

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 poniższym opisem.

Filtering

Filtrowanie opisów wiadomości e-mail nie jest obsługiwane. Niektóre konkretne kwestie, które należy wziąć pod uwagę, są następujące.

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

Napiwek

W funkcji Szybkiego znajdowania, chociaż filtrowanie nie jest obsługiwane, treść wiadomości e-mail może być dodana jako kolumna zwracająca, a dane treści będą zwracane w rezultacie.

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