Freigeben über

Konfigurieren der Regeln für die Nachverfolgung auf Ordnerebene

Konfigurieren Sie Nachverfolgungsregeln auf Ordnerebene, um einen Microsoft Exchange-Posteingangsordner einem Dynamics 365 Customer Engagement (on-premises)-Datensatz zuzuordnen, sodass alle E-Mails im Exchange-Ordner automatisch gegen den zugeordneten Datensatz in Customer Engagement nachverfolgt werden. Die Nachverfolgung von E-Mails auf Ordnerebene funktioniert nur, wenn:

  • Die Nachverfolgungsfunktion auf Ordnerebene ist für Ihre Customer Engagement-Instanz aktiviert. Sie können die Nachverfolgung auf Ordnerebene aktivieren, indem Sie den Webclient oder Microsoft Dynamics 365 für Outlook verwenden. Weitere Informationen: Konfigurieren der Nachverfolgung auf Ordnerebene

  • Der Ordner, den Sie nachverfolgen, befindet sich unter dem Ordner "Posteingang" in Exchange. E-Mails in den Ordnern, die sich nicht im Ordner "Posteingang " befinden, werden nicht nachverfolgt.

Erstellen und Verwalten von Nachverfolgungsregeln auf Ordnerebene

Verwenden Sie die MailboxTrackingFolder-Entität , um Ihre Nachverfolgungsregeln auf Ordnerebene programmgesteuert zu konfigurieren und zu verwalten. Um eine Nachverfolgungsregel einzurichten, verwenden Sie die folgenden Attribute.

Merkmal BESCHREIBUNG
ExchangeFolderId Geben Sie die Exchange-Ordner-ID an, die Sie zuordnen möchten. Sie können die Exchange-Webdienste (EWS) verwenden, um die ID eines Ordners unter Ihrem Posteingangsordner abzurufen. Weitere Informationen finden Sie unter MSDN: Anleitung: Arbeiten mit Ordnern mithilfe von EWS in Exchange. Dies ist ein erforderliches Attribut.
Postfach-ID Geben Sie die Postfach-ID in Customer Engagement an, für die Sie die Regel erstellen möchten. Dies ist ein erforderliches Attribut.
RegardingObjectId Legen Sie das betreffende Objekt in Customer Engagement fest, dem der angegebene Exchange-Ordner zugeordnet werden soll. Hierbei handelt es sich um ein optionales Attribut.

Der folgende Beispielcode zeigt, wie Sie eine Nachverfolgungsregel auf Ordnerebene erstellen können.

// 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);

Sie können maximal 25 Nachverfolgungsregeln auf Ordnerebene pro Postfach erstellen. Die Ordner-ID des Exchange-Ordners kann zum Zeitpunkt der Erstellung der Zuordnung mit dem SDK nicht überprüft werden. Sobald Sie jedoch eine Zuordnungsregel erstellen und die Ordner-ID ungültig ist, wird sie auf der Benutzeroberfläche in Customer Engagement angezeigt, um anzugeben, dass die Zuordnung ungültig ist.

Alle manuellen Änderungen, die am betreffenden Objekt in den nachverfolgten Aktivitätsdatensätzen vorgenommen wurden, die in Customer Engagement als Ergebnis der Nachverfolgungsregel auf Ordnerebene erstellt wurden, werden bei der nächsten serverseitigen Synchronisierung überschrieben. Wenn Sie z.B. eine Zuordnung zwischen dem Adventure Works-Ordner und dem Adventure Works-Konto eingerichtet haben, werden alle E-Mails im Adventure WorksExchange-Ordner als Aktivitäten in Customer Engagement verfolgt, wobei der Bezug auf den Adventure Works-Kontodatensatz festgelegt ist. Wenn Sie den Bezug einiger Aktivtäten in einen anderen Datensatz ändern, wird er automatisch bei der nächsten serverseitigen Synchronisierung überschrieben.

Abrufen von Nachverfolgungsregeln auf Ordnerebene für ein Postfach

Sie können alle Nachverfolgungsregeln auf Ordnerebene für ein Postfach abrufen, indem Sie die RetrieveMailboxTrackingFoldersRequest Nachricht verwenden. Übergeben Sie die Postfach-ID, für die Sie die Regeln in der RetrieveMailboxTrackingFoldersRequestMailboxId . -Eigenschaft abrufen möchten, und führen Sie die Nachricht aus.

Der folgende Beispielcode zeigt, wie Sie Nachverfolgungsregeln auf Ordnerebene für ein Postfach abrufen können.

// 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++;  
}

Siehe auch

RetrieveMailboxTrackingFolders-Funktion
MailboxTrackingFolder-Entität
Postfach-Entität
Nachverfolgung auf Ordnerebene konfigurieren
Serverseitige Synchronisierungsentitäten