E-Mail-Aktivitätsentitäten

Artikel
05/09/2023

Mithilfe der E-Mail-Aktivität können Sie die E-Mail-Kommunikation mit Kunden nachverfolgen und verwalten. Dynamics 365 Customer Engagement (on-premises) enthält die E-Mail-Router-Software, die das Weiterleiten von E-Mails an bzw. von Dynamics 365 Customer Engagement (on-premises) steuert. Die E-Mail-Aktivität, die unter Verwendung von E-Mail-Protokollen übermittelt wird. E-Mail-Router unterstützt die folgenden E-Mail-Protokolle: Exchange-Webdienste, POP3 und SMTP. Zusätzlich zur E-Mail-Router-Software kann die E-Mail-Aktivität auch mithilfe von Dynamics 365 for Outlook übermittelt werden.

Aktionen für eine E-Mail-Aktivität

Mit den Dynamics 365 Customer Engagement Webdiensten können Sie die folgenden Aktivitäten für eine E-Mail-Aktivität durchführen:

Erstellen, Abrufen, Aktualisieren und Löschen der E-Mail-Aktivität.
Senden von E-Mail-Nachrichten, oder Senden von E-Mail-Nachrichten mithilfe von E-Mail-Vorlagen (Template). Weitere Informationen zu E-Mail-Vorlagen finden Sie unter Vorlagen-Entität.
Anfügen von Dateien als Anlagen mithilfe des (ActivityMimeAttachment) Attributs in der E-Mail-Nachricht.
Senden von Massen-E-Mail-Nachrichten.
Konfigurieren von eingehenden E-Mail-Nachrichten, sodass sie von Microsoft Exchange Server an einen Benutzer oder die Warteschlange übermittelt werden, oder ausgehende Nachrichten von einem beliebigen Benutzer oder einer Warteschlange an Microsoft Exchange Server gesendet werden können. Informationen darüber, wie Sie eingehende Nachrichten für Warteschlangen konfigurieren, finden Sie unter Konfigurieren von E-Mail für eingehende Nachrichten.

Wenn die Organisationsattribute Organization.RequireApprovalForuserEmail und Organization.RequireApprovalForQueueEmail (E-Mails nur für genehmigte Benutzer/Warteschlangen verarbeiten) auf Wahr (1) festgelegt sind, geschieht Folgendes: E-Mail-Nachrichten werden nur dann von einem Benutzer oder einer Warteschlange zugestellt oder gesendet, wenn die primäre E-Mail-Adresse des Benutzers oder der Warteschlange genehmigt ist. Die Attribute SystemUser.EmailRouterAccessApproval und Queue.EmailRouterAccessApproval geben den Status der primären E-Mail-Adresse des Benutzers bzw. der Warteschlange an, und der Wert muss auf 1 festgelegt werden. Andernfalls werden die eingehenden und ausgehenden Nachrichten blockiert. Sie können den Benutzer- oder Warteschlangendatensatz aktualisieren, um den Attributwert zu ändern, falls er noch nicht genehmigt wurde, vorausgesetzt Ihr Benutzerkonto verfügt über die Berechtigung prvApproveRejectEmailAddress.

Notiz

In Dynamics 365 for Customer Engagement kann das Attribut Email.StatusCode nicht null sein.

Massen-E-Mail

Dynamics 365 Customer Engagement (on-premises) unterstützt das Senden von E-Mails an eine Vielzahl von Empfängern durch eine Massen-E-Mail-Anforderung. Wenn eine Massen-E-Mail-Anforderung an Dynamics 365 Customer Engagement (on-premises) gesendet wird, wird in der Warteschlange „Asynchroner Dienst“, welche die E-Mail-Nachrichten mithilfe eines Hintergrundprozesses sendet, ein asynchroner Vorgang erstellt. Dadurch wird eine verbesserte Systemleistung erreicht.

Die Meldungen SendBulkMailRequest und BackgroundSendEmailRequest werden für das Senden von Massen-E-Mail-Nachrichten verwendet. Im Folgenden wird die Sequenz zum Senden von Massen-E-Mails aufgeführt:

Führen Sie SendBulkMail-Anforderung aus. Diese Anforderung enthält eine Abfrage, die die Ziel-E-Mail-Empfänger und eine E-Mail-Vorlage zum Verfassen jeder E-Mail auswählt.
Der asynchrone Dienst erstellt die E-Mail-Aktivitäten für jeden Empfänger.
Der asynchrone Dienst versendet jede E-Mail-Nachricht. Die E-Mail-Nachrichten haben den Sendestatus "Ausstehend".
Der E-Mail-Router, Dynamics 365 for Outlook oder eine Drittanbieterkomponente zum Senden von E-Mails fragt Dynamics 365 Customer Engagement (on-premises) nach ausstehenden E-Mail-Nachrichten und laden sie, wenn eine gefunden wird, mithilfe der BackgroundSendEmail-Anforderung herunter.
Die BackgroundSendEmail-Anforderung führt die folgenden Vorgänge aus: Überprüft, ob ausstehende E-Mailnachrichten vorhanden sind, lädt die E-Mail an den Aufrufer der Meldung BackgroundSendEmailRequest herunter und synchronisiert die Downloads, wenn mehrere Aufrufer vorhanden sind.
Der Aufrufer der Meldung BackgroundSendEmailRequest empfängt die heruntergeladene E-Mail-Nachricht und versendet und sie.

E-Mail-Anlagen

E-Mail-Anlagen sind Dateien, die an E-Mail-Nachrichten oder E-Mail-Vorlagen angefügt werden können. Eine angehängte Datei kann ein beliebiges Standarddateiformat haben, z.B. Office Word-Dokumente, Office Excel-Tabellen, CAD-Dateien und PDF-Dateien. Sie können mehrere Dateien als E-Mail-Anlagen an eine E-Mail oder eine E-Mail-Vorlage anfügen. Die maximale Größe für Dateien, die hochgeladen werden können, wird durch die Organization.MaxUploadFileSize-Eigenschaft bestimmt. Diese Eigenschaft wird in der Dynamics 365-Anwendung auf der Registerkarte E-Mail in den Systemeinstellungen festgelegt. Mit dieser Einstellung wird die Größe von Dateien begrenzt, die an E-Mail-Nachrichten, Notizen und Webressourcen angefügt werden können. Die Standardeinstellung ist 5 MB.

Zum Anfügen einer E-Mail-Anlage an eine E-Mail-Nachricht oder -Vorlage verwenden Sie die Attribute ActivityMimeAttachment.ObjectId und ActivityMimeAttachment.ObjectTypeCode, während Sie einen Aktivitäts-MIME-Anlagendatensatz erstellen oder aktualisieren.

Das folgende Codebeispiel zeigt, wie eine E-Mail-Anlage an eine E-Mail angefügt wird:

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"};

Um die E-Mail-Anlage an eine Vorlage anstatt an eine E-Mail anzufügen, ersetzen Sie die Werte der Attribute ActivityMimeAttachment.ObjectId und ActivityMimeAttachment.ObjectTypeCode wie folgt im obigen Code:

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

Ein vollständiges Codebeispiel, inwieweit von E-Mail-Anlagen erstellt werden, finden Sie unter Beispiel: Erstellen, Abrufen, Aktualisieren und Löschen eines E-Mail-Anhangs.

Wiederverwenden von E-Mail-Anlagen

Wenn Sie einen E-Mail-Anlagendatensatz erstellen, wird die angehängte Datei als BLOB-Datei gespeichert. Das Attribut ActivityMimeAttachment.AttachmentId des E-Mail-Anlagendatensatzes kennzeichnet eindeutig die BLOB-Datei. Dies erleichtert die erneute Verwendung der Dateianlagen mit anderen E-Mail- und E-Mail-Vorlagendatensätzen, ohne dass mehrere Kopien derselben Datei in der Datenbank erstellt und gespeichert werden müssen.

So verwenden Sie eine vorhandene Dateianlage erneut:

Rufen Sie den ActivityMimeAttachment-Datensatz ab, der die Anlagendatei enthält, die Sie erneut verwenden möchten, wie im folgenden Codebeispiel gezeigt:

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

Erstellen Sie einen neuen E-Mail-Anlagendatensatz, ordnen Sie ihn dem erforderlichen E-Mail- oder E-Mail-Vorlagendatensatz zu und verweisen Sie ihn auf die Datei des abgerufenen ActivityMimeAttachment-Datensatzes, wie im folgenden Codebeispiel gezeigt:
```
ActivityMimeAttachment _reuseAttachment = new ActivityMimeAttachment{  
    ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),  
    ObjectTypeCode = Email.EntityLogicalName,  
    Subject = "Sample Attachment”,  
    AttachmentId = retrievedAttachment.AttachmentId};  
```
Da Sie eine bestehende Anlagendatei wiederverwenden, müssen Sie die Attributwerte ActivityMimeAttachment.Body und ActivityMimeAttachment.FileName nicht festlegen, während Sie E-Mail-Anlagendatensätze zu E-Mail-Nachrichten oder E-Mail-Vorlagen erstellen und zuordnen.

Siehe auch

Aktivitätsentitäten
Beispielcode für Aktivitätsentitäten
E-Mail-Entität
ActivityMimeAttachment-Entität