配置 Exchange 文件夹级别的跟踪规则

项目
03/04/2017

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

配置文件夹级别的跟踪规则以将 Microsoft Exchange 收件箱文件夹映射到 Microsoft Dynamics 365 记录中，以便对照 Dynamics 365 中映射的记录自动跟踪 Exchange 文件夹中的所有邮件。电子邮件的文件夹级别的跟踪仅在以下情况下工作：

文件夹级别的跟踪功能为您的 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	在要将指定的 Exchange 文件夹映射到其中的 Dynamics 365 中设置相关的对象。这是一种可选属性。

以下示例代码显示如何创建文件夹级别的跟踪规则。

// 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 无效，此 ID 则会显示在 Dynamics 365 的 UI 中指示映射无效。

下次服务器端同步时，对跟踪活动记录中由于文件夹级别的跟踪规则在 Dynamics 365 中创建的相关对象进行的所有手动更改，将被覆盖。例如，如果已经在 Adventure Works 文件夹和 Adventure Works 帐户之间设置了映射，Adventure WorksExchange 文件夹中的所有电子邮件都将在其相关设置为 Adventure Works 帐户记录的 Dynamics 365 中被作为活动跟踪。如果您把某些活动的相关项更改到任何其他记录，在下次服务器端出现同步时，它将会自动被替代。

检索邮箱的文件夹级别的跟踪规则

可以通过使用 RetrieveMailboxTrackingFoldersRequest 消息检索邮箱的所有文件夹级别的跟踪规则。传递要在 RetrieveMailboxTrackingFoldersRequest.MailboxId 属性中为其检索规则的邮箱 ID，并执行此消息。

以下示例代码显示如何检索邮箱的文件夹级别的跟踪规则。

// 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（邮箱自动跟踪文件夹）实体消息和方法
 邮箱实体消息和方法
 TechNet：配置文件夹级别的跟踪
 服务器端同步实体

Microsoft Dynamics 365

配置 Exchange 文件夹级别的跟踪规则

本主题内容

创建和管理文件夹级别的跟踪规则

检索邮箱的文件夹级别的跟踪规则

另请参阅

其他资源