Konfigurieren der Regeln für die Nachverfolgung auf Ordnerebene

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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

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

• Der Ordner, den Sie nachverfolgen, wird unter dem Ordner Posteingang in Exchange angezeigt. E-Mails in den Ordnern, die nicht unter dem Ordner Posteingang sind, werden nicht nachverfolgt.

In diesem Thema

Erstellen und Verwalten von Nachverfolgungsregeln auf Ordnerebene

Abrufen von Nachverfolgungsregeln auf Ordnerebene für ein Postfach

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.

Attribut	Beschreibung
MailboxTrackingFolder.ExchangeFolderId	Geben Sie die Exchange-Ordner-ID, die Sie zuordnen möchten. Sie können Exchange-Webdienste (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.
MailboxTrackingFolder.MailboxId	Geben Sie die Postfach-ID in Dynamics 365 ein, für die Sie die Regel erstellen möchten. Dies ist ein erforderliches Attribut.
MailboxTrackingFolder.RegardingObjectId	Legen Sie das entsprechende Objekt in Dynamics 365 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 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 Dynamics 365 angezeigt, um anzugeben, dass die Zuordnung ungültig ist.

Alle manuellen Änderungen am Bezugs-Objekt in den nachverfolgten Aktivitätsdatensätzen, die in Dynamics 365 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 Firma Adventure Works erstellt haben, werden alle E-Mails im Ordner Adventure WorksExchange als Aktivitäten in Dynamics 365 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. Geben Sie die Postfach-ID, für die Sie die Regeln abrufen möchten an die Eigenschaft RetrieveMailboxTrackingFoldersRequest.MailboxId weiter, und führen Sie die Meldung 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

Nachrichten und Methoden von MailboxTrackingFolder (Automatisch nachverfolgter Postfachordner)
Postfachentitätsmeldungen und -methoden
TechNet: Konfiguration der Nachverfolgung auf Ordnerebene
Serverseitige Synchronisierungsentitäten

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright