Freigeben über

Konfigurieren der Regeln für die Nachverfolgung auf Ordnerebene

  • Artikel

Konfigurieren Sie Regeln für die Nachverfolgung auf Ordnerebene, um einen Microsoft Exchange Posteingangsordern zu einem Microsoft Dataverse-Apps-Datensatz zuzuorden, damit alle E-Mails im Microsoft Exchange-Ordner automatisch für den zugeordneten Datensatz in Dataverse nachverfolgt werden. Nachverfolgung von E-Mails auf Ordnerebene funktioniert nur, wenn Folgendes zutrifft:

  • Die Nachverfolgungsfunktion auf Ordnerebene für Ihre Dataverse-Instanz ist aktiviert. Sie können Nachverfolgung auf Ordnerebene aktivieren, indem Sie den Webclient oder Dynamics 365 for Outlook verwenden. Weitere Informationen: Nachverfolgung auf Ordnerebene konfigurieren

  • Der Ordner, den Sie nachverfolgen, wird unter dem Ordner Posteingang in Microsoft Exchange angezeigt. 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 Tabelle für den automatisch nachverfolgten Postfachordner (MailboxTrackingFolder), um Ihre Tracking-Regeln auf Ordnerebene programmatisch zu konfigurieren und zu verwalten. Um eine Tracking-Regel festzulegen, verwenden Sie die folgenden Spalten.

Spalte Beschreibung
ExchangeFolderId Geben Sie die Microsoft Exchange-Ordner-ID, 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 eine erforderliche Spalte.
MailboxId Geben Sie die Postfach-ID in Dataverse ein, für die Sie die Regel erstellen möchten. Dies ist eine erforderliche Spalte.
RegardingObjectId Legen Sie das entsprechende Objekt in Dataverse fest, dem der angegebene Microsoft Exchange-Ordner zugeordnet werden soll. Dies ist eine optionale Spalte.

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 Microsoft Exchange-Ordners kann zum Zeitpunkt des Erstellens der Zuordnung mithilfe des SDK nicht überprüft werden. Sobald Sie jedoch eine Zuordnungsregel erstellen und wenn die Ordner-ID ungültig ist, wird Sie in der Benutzeroberfläche in Dataverse angezeigt, um anzugeben, dass die Zuordnung ungültig ist.

Alle manuellen Änderungen am Bezugs-Objekt in den nachverfolgten Aktivitätsdatensätzen, die in Dataverse infolge der Nachverfolgungsregel auf Ordnerebene erstellt werden, werden bei der nächsten serverseitigen Synchronisierung überschrieben. Wenn Sie beispielsweise eine Zuordnung zwischen dem Ordner Adventure Works und der Account Adventure Works erstellt haben, werden alle E-Mails im Adventure WorksMicrosoft Exchange-Ordner als Aktivitäten in Dataverse nachverfolgt, wobei der Bezug auf den Firmendatensatz Adventure Works festgelegt wird. 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. Führen Sie das Postfach ID, für die Sie die Regeln in anzeigen möchten RetrieveMailboxTrackingFoldersRequest.MailboxId Eigenschaft und die Nachticht ausführen.

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 Function
Tabelle für den automatisch nachverfolgten Postfachordner (MailboxTrackingFolder)
Postfach-Tabelle
Nachverfolgung auf Ordnerebene konfigurieren
Server-seitige Synchronisations-Tabellen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).