다음을 통해 공유

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 인스턴스에 대해 활성화됩니다. 웹 클라이언트 또는 Outlook용 Microsoft Dynamics 365을 사용하여 폴더 수준 추적을 사용할 수 있습니다.추가 정보:TechNet: 폴더 수준 추적 구성

  • 추적 중인 폴더는 Exchange의 받은 편지함 폴더 아래 있습니다.받은 편지함 폴더 아래에 없는 폴더의 전자 메일은 추적되지 않습니다.

이 항목의 내용

폴더 수준 추적 규칙 만들기 및 관리

사서함에 대한 폴더 수준 추적 규칙 검색

폴더 수준 추적 규칙 만들기 및 관리

MailboxTrackingFolder 엔터티를 사용하여 폴더 수준 추적 규칙을 프로그래밍 방식으로 구성하고 관리합니다. 추적 규칙을 설정하려면 다음 특성을 사용합니다.

특성

설명

MailboxTrackingFolder.ExchangeFolderId

매핑하려는 Exchange 폴더 ID를 지정합니다.Exchange 웹 서비스(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개의 폴더 수준 추적 규칙을 만들 수 있습니다.Exchange 폴더의 폴더 ID는 SDK를 사용하여 매핑을 만들 때 유효성을 검사할 수 없습니다. 그러나 매핑 규칙을 만드는 즉시 폴더 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(사서함 자동 추적 폴더) 엔터티 메시지 및 메서드
Mailbox 엔터티 메시지 및 메서드
TechNet: 폴더 수준 추적 구성
서버 쪽 동기화 엔터티

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보