設定 Exchange 資料夾等級追蹤規則

 

發行︰ 2017年1月

適用於: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

設定資料夾等級追蹤規則,將 Microsoft Exchange 收件匣資料夾對應至 Microsoft Dynamics 365 記錄,讓 Exchange 資料夾中的所有電子郵件自動根據 Dynamics 365 中的對應記錄進行追蹤。 電子郵件的資料夾等級追蹤只有在下列情況下才會運作:

  • 已啟用 Dynamics 365 執行個體的資料夾等級追蹤功能。 您可以使用 Web 用戶端或 Microsoft Dynamics 365 for Outlook 啟用資料夾等級追蹤。其他資訊:TechNet:設定資料夾等級追蹤

  • 您追蹤的資料夾位於 Exchange 中的 [收件匣] 資料夾下。 不在 [收件匣] 資料夾下的資料夾中的電子郵件則不會追蹤。

本主題內容

建立並管理資料夾等級追蹤規則

擷取信箱的資料夾等級追蹤規則

建立並管理資料夾等級追蹤規則

使用 MailboxTrackingFolder 實體透過程式設計的方式設定及管理您的資料夾等級追蹤規則。 若要設定追蹤規則,請使用下列屬性。

屬性

描述

MailboxTrackingFolder.ExchangeFolderId

指定您要對應的 Exchange 資料夾 ID。 您可以使用 Exchange Web 服務 (EWS) 擷取 [收件匣] 資料夾下某一個資料夾的 ID。 如需詳細資訊,請參閱 MSDN:如何:使用 Exchange 中的 EWS 處理資料夾。 這是必要的屬性。

MailboxTrackingFolder.MailboxId

在 Dynamics 365 中指定要建立規則的信箱 ID。 這是必要的屬性。

MailboxTrackingFolder.RegardingObjectId

設定 Dynamics 365 中指定的 Exchange 資料夾所要對應的相關物件。 這是選擇性屬性。

下列範例指令碼將顯示如何建立資料夾等級追蹤規則。

// Create a folder-level tracking rule
MailboxTrackingFolder newTrackingFolder = new MailboxTrackingFolder();

// Set the required attributes
newTrackingFolder.ExchangeFolderId = "123456"; // Sample value. Retrieve this value using Exchange Web Services (EWS)
newTrackingFolder.MailboxId = new EntityReference(Mailbox.EntityLogicalName, _mailboxId);

// Set the optional attributes
newTrackingFolder.RegardingObjectId = new EntityReference(Account.EntityLogicalName, _accountId);
newTrackingFolder.RegardingObjectId.Name = _accountName;
newTrackingFolder.ExchangeFolderName = "Sample Exchange Folder";

// Execute the request to create the rule 
_folderTrackingId = _serviceProxy.Create(newTrackingFolder);
Console.WriteLine("Created folder-level tracking rule for '{0}'.\n", _mailboxName);

您最多可以為每個信箱建立 25 項資料夾等級追蹤規則。 使用 SDK 建立對應時,無法驗證 Exchange 資料夾的資料夾 ID。 不過,一旦您建立了對應規則,而資料夾 ID 無效,就會在 Dynamics 365 的 UI 中顯示,表示對應無效。

對追蹤的活動記錄 (因資料夾等級追蹤規則而在 Dynamics 365 中建立) 中相關物件所做的任何手動變更,將在下一次伺服器端同步發生時覆寫。 例如,如果您已在 Adventure Works 資料夾和 Adventure Works 帳戶之間設定對應,Adventure WorksExchange 資料夾中的所有電子郵件將會在 Dynamics 365 中做為活動追蹤,且相關物件會設為 Adventure Works 帳戶記錄。 如果您將某些活動的相關物件變更為任何其他記錄,就會自動在下次進行伺服器端同步處理時覆寫。

擷取信箱的資料夾等級追蹤規則

您可以使用 RetrieveMailboxTrackingFoldersRequest 訊息擷取信箱的所有資料夾等級追蹤規則。 將您要擷取其規則的信箱 ID 傳遞至 RetrieveMailboxTrackingFoldersRequest.MailboxId 屬性中,然後執行訊息。

下列範例指令碼將顯示如何擷取信箱的資料夾等級追蹤規則。

// Retrieve the folder mapping rules for a mailbox
RetrieveMailboxTrackingFoldersRequest req = new RetrieveMailboxTrackingFoldersRequest
{
    MailboxId = _mailboxId.ToString()
};

RetrieveMailboxTrackingFoldersResponse resp = (RetrieveMailboxTrackingFoldersResponse_serviceProxy.Execute(req);
Console.WriteLine("Retrieved folder-level tracking rules for {0}:", _mailboxName);
int n = 1;
foreach (var folderMapping in resp.MailboxTrackingFolderMappings)
{
    Console.WriteLine("\tRule {0}: '{1}' is mapped to '{2}'.", 
        n, folderMapping.ExchangeFolderName, folderMapping.RegardingObjectName);
    n++;
}

另請參閱

MailboxTrackingFolder (信箱自動追蹤資料夾) 實體訊息和方法
Mailbox 實體訊息和方法
TechNet:設定資料夾等級追蹤
伺服器端同步處理實體

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有,並保留一切權利。 著作權