電子メール活動テーブル

[アーティクル]
07/07/2022

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

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

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

Dataverse Web サービスでは、メール活動の以下のアクションを実行できます:

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

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

注意

Dataverse では、Email.StatusCode 属性を null にできません。

電子メール広告

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

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

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

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

電子メール添付ファイルとは、電子メールメッセージまたは電子メールテンプレートに添付できるファイルです。 Office Outlook ドキュメント、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 列の値を指定する必要はありません。

電子メール活動テーブル

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

電子メール広告

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

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

関連項目

フィードバック