Freigeben über

Konfigurieren der Regeln für die Nachverfolgung auf Ordnerebene

  • Artikel

Konfigurieren Sie Tracking-Regeln auf Ordnerebene, um einen Posteingang-Ordner mit der Nummer Microsoft Exchange einem Datensatz mit der Nummer Dynamics 365 Customer Engagement (on-premises) zuzuordnen, so dass alle E-Mails im Exchange-Ordner automatisch mit dem zugeordneten Datensatz in Customer Engagement abgeglichen werden. Nachverfolgung von E-Mails auf Ordnerebene funktioniert nur, wenn Folgendes zutrifft:

  • Die Funktion zur Verfolgung auf Ordnerebene ist für Ihre Customer Engagement-Instanz aktiviert. Sie können die Nachverfolgung auf Ordnerebene mit dem Web Client oder mit Microsoft Dynamics 365 for Outlook aktivieren. Weitere Informationen: Nachverfolgung auf Ordnerebene konfigurieren

  • Der Ordner, den Sie verfolgen, befindet sich unter dem Ordner Posteingang in Exchange. E-Mails in den Ordnern, die nicht unter dem Ordner Posteingang sind, werden nicht nachverfolgt.

Erstellen und Verwalten von Nachverfolgungsregeln auf Ordnerebene

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

Attribute Beschreibung des Dataflows
ExchangeFolderId Geben Sie die Exchange-Ordner-ID an, die Sie zuordnen möchten. Sie können Exchange Web Services (EWS) verwenden, um die ID eines Ordners unter Ihrem Posteingangsordner abzurufen. Weitere Informationen finden Sie unter MSDN: How to: Work with folders by using EWS in Exchange. Dies ist ein erforderliches Attribut.
MailboxId Geben Sie die Mailbox-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. Dies ist 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 ein Maximum von 25 Nachverfolgungsregeln auf Ordnerebene pro Postfach erstellen. Die Ordner-ID des Exchange-Ordners kann zum Zeitpunkt des Erstellens der Zuordnung mit SDK nicht validiert werden. Sobald Sie jedoch eine Zuordnungsregel erstellen und die Ordner-ID ungültig ist, wird in der Benutzeroberfläche von Customer Engagement angezeigt, dass die Zuordnung ungültig ist.

Alle manuellen Änderungen an dem betreffenden Objekt in den verfolgten Aktivitätsdatensätzen, die in Customer Engagement als Ergebnis der Verfolgungsregel 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 Postfach abrufen, indem Sie die Meldung RetrieveMailboxTrackingFoldersRequest verwenden. Übergeben Sie die Postfach-ID, für die Sie die Regeln abrufen möchten, in der Eigenschaft RetrieveMailboxTrackingFoldersRequest.MailboxId, und führen Sie die Nachricht aus.

Der folgende Beispielcode zeigt, wie Sie eine Nachverfolgungsregel 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