電子郵件活動實體

文章
03/04/2017

發佈日期： 2017年1月

適用對象： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

電子郵件活動可讓您追蹤和管理客戶的電子郵件通訊。Microsoft Dynamics 365 包含電子郵件路由器軟體，可管理電子郵件與 Microsoft Dynamics 365 之間往來的路由。電子郵件活動是使用電子郵件通訊協定傳送。電子郵件路由器支援下列電子郵件通訊協定：Exchange Web 服務、POP3 和 SMTP。除了電子郵件路由器軟體之外，也可以使用 Microsoft Dynamics 365 for Outlook 傳遞電子郵件活動。

本主題內容

電子郵件活動的動作

大量電子郵件

電子郵件附件

電子郵件活動的動作

使用 Microsoft Dynamics 365 SDK，您可以執行以下電子郵件活動的動作：

建立、擷取、更新，以及刪除電子郵件活動。
傳送電子郵件訊息，或是使用電子郵件範本 (Template) 傳送電子郵件訊息。如需更多關於電子郵件範本的資訊，請參閱 Template (電子郵件範本) 實體訊息和方法。
在電子郵件訊息中使用 (ActivityMimeAttachment) 屬性將檔案加為附件。
傳送大量電子郵件訊息。
設定來自 Microsoft Exchange Server 的電子郵件訊息至任何使用者或佇列、或是來自任何使用者或佇列為 Microsoft Exchange Server。如需關於如何設定接收佇列的電子郵件訊息之詳細資訊，請見設定接收訊息的電子郵件。

如果 Organization.RequireApprovalForuserEmail 和 Organization.RequireApprovalForQueueEmail (僅為核准使用者和佇列處理電子郵件) 組織屬性會設為 true (1)，則會發生下列狀況：電子郵件訊息只會在使用者或佇列的主要電子郵件地址受到核准，才會傳遞或發送。SystemUser.EmailRouterAccessApproval 和 Queue.EmailRouterAccessApproval 屬性分別指出使用者和佇列的主要電子郵件地址的狀態，且值必須設為 1。否則會封鎖接收和寄出訊息的能力。您可以更新使用者或佇列記錄變更屬性值，如果尚未在核准狀態，則假設您的使用者帳戶已指派 prvApproveRejectEmailAddress 權限。如需詳細資訊，請參閱資訊安全角色 UI 與權限的對應。

備註

在 Microsoft Dynamics 365 (線上和內部部署) 中，Email.StatusCode 屬性不可為 null。

大量電子郵件

Microsoft Dynamics 365 支援透過大量電子郵件傳送電子郵件給大量收件者清單。當大量電子郵件請求送至 Microsoft Dynamics 365 時，非同步作業就會建立在非同步服務佇列，將會透過使用背景處理方式傳送電子郵件訊息。這會改善系統效能。

SendBulkMailRequest 和 BackgroundSendEmailRequest 訊息會用於傳送大量電子郵件。下列清單列出傳送大量電子郵件的順序：

執行 SendBulkMail 請求。此請求包含選擇目標電子郵件收件人以及電子郵件使用的範本查詢。
非同步服務為每位收件者建立電子郵件活動。
非同步服務傳送每個電子郵件訊息。電子郵件訊息含有「擱置中」的傳送狀態。
電子郵件路由器、Microsoft Dynamics 365 for Outlook，或協力廠商的電子郵件為擱置郵件訊息傳送元件輪詢 Microsoft Dynamics 365，及如果找到對方，則使用 BackgroundSendEmail 請求下載之。
BackgroundSendEmail 請求會執行下列作業：檢查擱置的電子郵件訊息是否存在、下載電子郵件到 BackgroundSendEmailRequest 訊息的來電者，以及在多個來電者時同步下載。
BackgroundSendEmailRequest 訊息接收下載的電子郵件訊息並送出。

電子郵件附件

電子郵件附件是可附加至電子郵件訊息或電子郵件範本中的檔案。附加檔案可以是任何標準的電腦檔案格式，例如 Microsoft Office Word 文件、Microsoft Office Excel 試算表、CAD 檔案和 PDF 檔案。您可以附加多個檔案做為至電子郵件或電子郵件範本中做為電子郵件附件。可上傳的檔案大小上限是由 Organization.MaxUploadFileSize 屬性所決定。此屬性是在 Dynamics 365 應用程式中 [系統設定] 的 [電子郵件] 索引標籤上進行設定。此設定限制可附加至電子郵件訊息、附註和 Web 資源的檔案大小。預設設定是 5 MB。

如要在電子郵件或範本中附加一個電子郵件附件，您可以使用 ActivityMimeAttachment.ObjectId 和 ActivityMimeAttachment.ObjectTypeCode 屬性，當您要建立或更新活動 MIME 附件紀錄。

下列程式碼範例顯示如何附加至電子郵件的電子郵件附件：

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。電子郵件附件記錄的 ActivityMimeAttachment.AttachmentId 屬性唯一識別檔案 BLOB。利於檔案附件的重新使用，搭配其他電子郵件和電子郵件範本，而不建立並在資料庫中儲存相同檔案的多個複本。

如要使用現有檔案附件：

擷取您要重新使用且包含附件檔案的 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 屬性值。

另請參閱

活動實體
 活動實體的範例程式碼
 Email 實體訊息和方法
 ActivityMimeAttachment (電子郵件附件) 實體訊息和方法

Microsoft Dynamics 365

分享方式：

電子郵件活動實體

本主題內容

電子郵件活動的動作

大量電子郵件

電子郵件附件

重新使用電子郵件附件

另請參閱

更多資源