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

Configurez les règles de suivi par dossier pour mapper un dossier de boîte de réception Microsoft Exchange à un enregistrement des applications Microsoft Dataverse de sorte que tous les messages électroniques contenus dans le dossier Microsoft Exchange soient automatiquement suivis par rapport à l’enregistrement mappé dans les applications Dataverse. 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 Dataverse. Vous pouvez activer le suivi par dossier à l’aide du client web ou de 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 Microsoft 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 la table Dossier de suivi automatique de la boîte aux lettres (MailboxTrackingFolder) pour configurer et gérer par programme vos règles de suivi par dossier. Pour installer une règle de suivi, utilisez les colonnes suivantes.

Colonne	Description
ExchangeFolderId	Spécifiez l’ID de dossier Microsoft 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. Cette colonne est obligatoire.
ID de boîte aux lettres	Spécifiez l’ID de boîte aux lettres dans Dataverse pour lequel vous souhaitez créer la règle. Cette colonne est obligatoire.
RegardingObjectId	Définissez l’objet concerné dans Dataverse auquel vous souhaitez que le dossier Microsoft Exchange spécifié soit mappé. Il s’agit d’une colonne facultative.

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 Microsoft 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 Dataverse 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 Dataverse 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 Dataverse 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écutez 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

RetrieveMailboxTrackingFolders Function
Table/entité du dossier de suivi automatique de la boîte aux lettres (MailboxTrackingFolder)
Table Mailbox
Configurer le suivi au niveau des dossiers
Tables synchronisation côté serveur

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).