電子メール活動エンティティ

[アーティクル]
05/09/2023

電子メール活動を使用すると、顧客との電子メール通信を追跡および管理できます。 Dynamics 365 Customer Engagement (on-premises) には、Dynamics 365 Customer Engagement (on-premises) との間のメールのルーティングを管理するメールルーターソフトウェアが含まれています。電子メール活動は、電子メールプロトコルを使用して配信されます。電子メールルーターは、Exchange Web サービス、POP3、および SMTP の電子メールプロトコルをサポートしています。電子メールルーターに加え、電子メール活動は Dynamics 365 for Outlook を使用して配信することもできます。

電子メール活動のアクション

Dynamics 365 Customer Engagement Web サービスを使用して、メール活動の以下のアクションを実行できます。

電子メール活動を作成、取得、更新、削除する。
電子メールメッセージを送信する。または電子メールテンプレート (Template) を使用して電子メールメッセージを送信する。電子メールテンプレートの詳細については、テンプレートエンティティを参照してください。
(ActivityMimeAttachment) 属性を使用して電子メールにファイルを添付する。
大量の電子メールを一括で送信する。
着信した電子メールメッセージが Microsoft Exchange Server からユーザーまたはキューへ配信されるようにする、または発信するメッセージがユーザーまたはキューから Microsoft Exchange Server へ送信されるようにする。キューに対して着信の電子メールメッセージを構成する方法については、受信メッセージ用電子メールを構成するを参照してください。

Organization.RequireApprovalForuserEmail と Organization.RequireApprovalForQueueEmail (承認されたユーザー/キューに関してだけ電子メールを処理する) 組織属性が true (1)、に設定されている場合、電子メールメッセージはユーザー/キューの既定電子メールアドレスが承認されている場合に限ってユーザー/キューから配信または送信されます。 SystemUser.EmailRouterAccessApproval と Queue.EmailRouterAccessApproval 属性は、それぞれユーザーとキューの既定電子メールアドレスのステータスを示し、値を 1 に設定する必要があります。それ以外の場合は、受信メッセージと送信メッセージがブロックされます。まだ承認状態でない場合、現在使用しているユーザーアカウントに prvApproveRejectEmailAddress 権限が割り当てられていれば、ユーザーまたはキューレコードを更新してこの属性値を変更できます。

Note

Dynamics 365 for Customer Engagement では、Email.StatusCode 属性を null にすることはできません。

電子メール広告

Dynamics 365 Customer Engagement (on-premises) は、メールの一括メール要求を通じて大きな受信者リストにメールを送信する機能をサポートしています。メールの一括処理要求が Dynamics 365 Customer Engagement (on-premises) に送られると、非同期サービスキュー内に非同期処理が作成され、それがバックグラウンドプロセスを使用してそのすべてのメールメッセージを送信します。これでシステムパフォーマンスが向上します。

電子メールメッセージの一括送信には SendBulkMailRequest メッセージと BackgroundSendEmailRequest メッセージが使用されます。電子メールの一括送信のシーケンスは次のとおりです。

SendBulkMail 要求を実行します。この要求は、対象となる電子メールの受信者を選択するクエリと、個々の電子メールを作成するための電子メールテンプレートで構成されます。
非同期サービスが受信者ごとに電子メール活動を作成します。
非同期サービスが各電子メールメッセージを送信します。これらの電子メールメッセージの送信状態は "保留中" とされます。
メールルーター、Dynamics 365 for Outlook、またはサードパーティのメール送信コンポーネントが Dynamics 365 Customer Engagement (on-premises) にポーリングを行い、保留中のメールメッセージがないかどうかを調べます。保留中のメールメッセージが見つかった場合は、BackgroundSendEmail 要求を使用してメールメッセージをダウンロードします。
BackgroundSendEmail 要求によって、保留中の電子メールメッセージが存在するかどうかがチェックされ、BackgroundSendEmailRequest メッセージの呼び出し元に電子メールがダウンロードされます。呼び出し元が複数の場合はダウンロードが同時に行われます。
BackgroundSendEmailRequest メッセージの発信者は、ダウンロードされた電子メールメッセージを受け取り、送信します。

電子メールの添付ファイル

電子メール添付ファイルとは、電子メールメッセージまたは電子メールテンプレートに添付できるファイルです。 Office Word ドキュメント、Office Excel スプレッドシート、CAD ファイル、PDF ファイルなど、標準形式の任意のコンピューターファイルを添付ファイルとすることができます。複数のファイルを電子メール添付ファイルとして電子メールまたは電子メールテンプレートに添付できます。アップロードできる最大ファイルサイズは、Organization.MaxUploadFileSize プロパティによって決まります。このプロパティは、Dynamics 365 アプリケーションのシステム設定の電子メールタブで設定します。この設定で電子メールメッセージ、メモ、および Web リソースに添付できるファイルのサイズを制限します。既定の設定は 5 MB です。

電子メール添付ファイルを電子メールメッセージまたはテンプレートに添付するには、活動 MIME 添付ファイルを作成または更新するときに、ActivityMimeAttachment.ObjectId 属性と ActivityMimeAttachment.ObjectTypeCode 属性を使用します。

次のコードサンプルは、電子メール添付ファイルを電子メールに添付する方法を示しています。

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

同様に、電子メール添付ファイルを電子メールの代わりにテンプレートに添付するには、上記のコードに示されているように ActivityMimeAttachment.ObjectId 属性と ActivityMimeAttachment.ObjectTypeCode 属性の値を次のように置き換えます。

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

電子メールアタッチメントを作成する方法の完全なサンプルコードは、サンプル: 電子メールの添付ファイルの作成、取得、更新、および削除を参照してください。

電子メール添付ファイルの再利用

電子メール添付ファイルレコードを作成すると、添付ファイルはファイル BLOB として保存されます。ファイル BLOB は、電子メール添付ファイルレコードの ActivityMimeAttachment.AttachmentId 属性によって一意に識別されます。したがって、他の電子メールレコードや電子メールテンプレートレコードで添付ファイルを再利用できるため、データベースに同じファイルのコピーを複数保持する必要はありません。

既存の添付ファイルを再利用するには

再利用する添付ファイルを含む ActivityMimeAttachment レコードを取得します。次にコード例を示します。

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

新しい電子メール添付ファイルレコードを作成し、必要な電子メールまたは電子メールテンプレートレコードと関連付けて、取得した ActivityMimeAttachment レコードの添付ファイルを参照するように設定します。次にコード例を示します。
```
ActivityMimeAttachment _reuseAttachment = new ActivityMimeAttachment{  
    ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),  
    ObjectTypeCode = Email.EntityLogicalName,  
    Subject = "Sample Attachment”,  
    AttachmentId = retrievedAttachment.AttachmentId};  
```
既存の添付ファイルを再利用するので、電子メール添付ファイルレコードを作成して電子メールまたは電子メールテンプレートに関連付けるときに、ActivityMimeAttachment.Body 属性と ActivityMimeAttachment.FileName 属性の値を指定する必要はありません。

次の方法で共有

電子メール活動エンティティ

電子メール活動のアクション

電子メール広告

電子メールの添付ファイル

電子メール添付ファイルの再利用

関連項目

フィードバック

その他のリソース