Partager via

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

  • Article

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Configurez les règles de suivi par dossier pour mapper un dossier de boîte de réception Microsoft Exchange à un enregistrement Microsoft Dynamics 365 de sorte que tous les messages électroniques contenus dans le dossier Exchange soient automatiquement suivis par rapport à l'enregistrement mappé dans Dynamics 365. 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 Dynamics 365. Vous pouvez activer le suivi par dossier à l'aide du client Web ou de Microsoft Dynamics CRM pour Outlook.Pour plus d'informations :TechNet : configurer le suivi au niveau des dossiers

  • 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.

Notes

Pour les organisations Microsoft Dynamics CRM Online, cette fonctionnalité n'est disponible que si votre organisation a effectué la mise à jour vers la mise à jour 1 de Dynamics CRM Online 2015. Cette fonctionnalité n'est pas disponible pour Dynamics CRM (local).

Contenu de la rubrique

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

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

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.

Attribut

Description

MailboxTrackingFolder.ExchangeFolderId

Spécifiez l'ID de dossier Exchange que vous souhaitez mapper. Vous pouvez utiliser Services Web Exchange (EWS) 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.

MailboxTrackingFolder.MailboxId

Spécifiez l'ID de boîte aux lettres dans Dynamics 365 pour lequel vous souhaitez créer la règle. Cet attribut est obligatoire.

MailboxTrackingFolder.RegardingObjectId

Définissez l'objet concerné dans Dynamics 365 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 de Dynamics 365 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 Dynamics 365 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 Adventure WorksExchange seront suivis en tant qu'activités dans Dynamics 365 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. Passez 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

Messages et méthodes d'entité MailboxTrackingFolder (dossier de suivi automatique de boîte aux lettres)
Messages et méthodes de l’entité Mailbox
TechNet : configurer le suivi au niveau des dossiers
Entités de synchronisation côté serveur

© 2017 Microsoft. Tous droits réservés. Copyright