Partage via

Configurer les règles de suivi par dossier d’Exchange

  • Article

Configurez les règles de suivi par dossier pour mapper un dossier de boîte de réception Microsoft Exchange à un enregistrement Dynamics 365 Customer Engagement (on-premises) de sorte que tous les messages électroniques contenus dans le dossier Microsoft Exchange soient automatiquement suivis par rapport à l’enregistrement mappé dans les applications. Le suivi par dossier des messages électroniques s’exécute uniquement si :

  • La fonctionnalité de suivi par dossier est activée pour votre instance de Customer Engagement. Vous pouvez activer le suivi par dossier à l’aide du client web ou de Microsoft Dynamics 365 for Outlook. Pour plus d’informations : Configurer le suivi par dossier

  • Le dossier que vous suivez se trouve sous le dossier Boîte de réception dans Exchange. Les messages électroniques présents dans les dossiers qui ne figurent pas sous le dossier Boîte de réception ne seront pas suivis.

Créer et gérer des règles de suivi par dossier

Utilisez l’entité MailboxTrackingFolder par programme pour configurer et gérer vos règles de suivi par dossier. Pour installer une règle de suivi, utilisez les attributs suivants.

Attribute Description
ExchangeFolderId Spécifiez l’ID de dossier Exchange que vous souhaitez mapper. Vous pouvez utiliser Exchange Web Services pour récupérer l’ID d’un dossier sous le dossier Boîte de réception. Pour plus d’informations, voir MSDN : Procédure : utiliser des dossiers à l’aide de EWS dans Exchange. Cet attribut est obligatoire.
MailboxId Spécifiez l’ID de boîte aux lettres dans Customer Engagement pour lequel vous souhaitez créer la règle. Cet attribut est obligatoire.
RegardingObjectId Définissez l’objet concerné dans Customer Engagement auquel vous souhaitez que le dossier Exchange spécifié soit mappé. Il s’agit d’un attribut facultatif.

L’exemple de code suivant montre comment créer une règle de suivi par dossier.

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

Vous pouvez créer jusqu’à 25 règles de suivi par dossier par boîte aux lettres. L’ID du dossier Exchange ne peut pas être validé lors de la création du mappage à l’aide du Kit de développement logiciel. Toutefois, dès que vous allez créer une règle de mappage, et si l’ID du dossier est valide, il apparaîtra dans l’interface utilisateur des applications Customer Engagement pour indiquer que le mappage n’est pas valide.

Les modifications effectuées manuellement sur l’objet concerné dans les enregistrements d’activités suivies, créés dans les applications Customer Engagement suite à la règle de suivi par dossier, seront supprimées dès la prochaine synchronisation côté serveur. Par exemple, si vous avez configuré un mappage entre le dossier Adventure Works et le compte Adventure Works, tous les messages électroniques du dossier Microsoft Exchange Adventure Works seront suivis en tant qu’activités dans Customer Engagement avec l’objet Concernant défini sur l’enregistrement de compte Adventure Works. Si vous modifiez l’objet Concernant de certaines activités d’un autre enregistrement, il sera automatiquement remplacé à la prochaine synchronisation côté serveur.

Extraire les règles de suivi par dossier d’une boîte aux lettres

Vous pouvez extraire toutes les règles de suivi par dossier d’une boîte aux lettres à l’aide du message RetrieveMailboxTrackingFoldersRequest. Transmettez l’ID de boîte-aux-lettres dont vous souhaitez extraire les règles à la propriété RetrieveMailboxTrackingFoldersRequest.MailboxId et exécuter le message.

L’exemple de code suivant montre comment extraire les règles de suivi par dossier d’une boîte aux lettres.

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

Voir aussi

Fonction RetrieveMailboxTrackingFolders
Entité MailboxTrackingFolder
Entité Mailbox
Configurer le suivi au niveau des dossiers
Entités de synchronisation côté serveur