Exemple : Synchroniser des données avec les systèmes externes à l'aide du suivi des modifications

  • Article

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Cet exemple de code montre comment récupérer les modifications d'une entité et synchroniser des données avec les systèmes externes en utilisant le message RetrieveEntityChangesRequest. Pour plus d'informations sur la fonctionnalité que cet exemple illustre, voir Utiliser le suivi des modifications pour synchroniser les données avec les systèmes externes.

Cet exemple est pour Mise à jour 1 de Microsoft Dynamics CRM Online 2015. Vous pouvez effectuer son téléchargement à partir de Synchroniser des données avec les systèmes externes à l'aide du suivi des modifications.

Conditions préalables

  1. Accédez à une organisation Mise à jour 1 de Microsoft Dynamics CRM Online 2015.

  2. Téléchargez le projet Visual Studio ChangeTrackingSample.

  3. Ouvrez le projet Visual Studio ChangeTrackingSample et installez le package NuGet Microsoft.CrmSdk.CoreAssemblies version 7.1.0-preview. Voir Installer les packages NuGet pour plus d'instructions.

  4. Après avoir installé les packages NuGet, voir Exécuter l'exemple pour obtenir des instructions sur le mode d'exécution de l'exemple et les prévisions possibles.

Contenu de la rubrique

En quoi consiste cet exemple :

Installer les packages NuGet

Exécuter l'exemple

En quoi consiste cet exemple :

  1. La méthode Run de la classe ChangeTrackingSample appelle la méthode ImportChangeTrackingSolution qui détecte d'abord si la solution gérée ChangeTrackingSample est déjà installée. Si ce n'est pas le cas, le fichier ChangeTrackingSample_1_0_0_0_managed.zip est importé pour installer cette solution gérée.

    Cette solution gérée contient une entité sample_book personnalisée qui est utilisée par cet exemple. Cette entité a une clé secondaire sample_bookcode qui crée une contrainte unique sur les valeurs stockées dans cet attribut.

  2. La méthode WaitForEntityAndKeysToBeActive est nécessaire car les clés secondaires requises pour cet exemple peuvent ne pas être prêtes immédiatement après l'installation de la solution ChangeTrackingSample. Cette méthode interroge les métadonnées de l'entité sample_book pour retarder l'exécution du reste de l'exemple jusqu'à ce que les clés secondaires soient prêtes.

  3. La méthode CreateRequiredRecords génère 10 enregistrements dans l'entité sample_book.

  4. La première fois que l'objet RetrieveEntityChangesRequest est appelé, il effectue une première synchronisation et récupère tous les enregistrements dans l'entité avec le numéro de version et met en cache les enregistrements récupérés.

  5. Une fois les enregistrements initiaux mis en cache, le programme demande si vous souhaitez afficher les enregistrements d'entité sample_book. Si vous répondez « y » (oui), le programme essaiera d'ouvrir Internet Explorer sur une vue affichant les enregistrements récemment créés.

  6. La méthode UpdateRecords ajoute dix enregistrements, actualise un enregistrement existant et supprime un enregistrement de l'entité sample_book.

  7. Après la mise à jour des enregistrements, le programme réinitialise les informations de fichier d'échange et instancie les objets du cache.

  8. Lorsque RetrieveEntityChangesRequest est appelé à nouveau, il récupère uniquement les enregistrements mis à jour depuis la dernière synchronisation.

  9. Après la récupération des modifications, le programme vous demandera si vous souhaitez afficher les enregistrements d'entité sample_book. Si vous répondez « y » (oui), le programme essaiera d'ouvrir Internet Explorer sur une vue affichant les enregistrements récemment créés.

  10. Enfin, DeleteChangeTrackingSampleSolution vous invitera à supprimer la solution gérée ChangeTrackingSample.

    Si vous choisissez « y » (oui), la solution gérée est supprimée incluant l'entité sample_book et toutes les données contenues dans cette entité. Votre organisation sera totalement vide.

    Si vous choisissez « n » (non), vous pourrez consulter les détails de la solution notamment les données créées par l'exemple. Cependant, vous devrez supprimer la solution gérée manuellement pour rétablir l'état d'origine de votre organisation.

Installer les packages NuGet

Suivez les étapes suivantes pour installer les assemblys requis par exemple :

  1. Téléchargez cet exemple et extrayez les fichiers.

  2. Accédez au dossier C# et ouvrez le fichier ChangeTrackingSample.sln à l'aide de Visual Studio.

  3. Dans Visual Studio, cliquez avec le bouton droit sur le projet ChangeTrackingSample et choisissez Gérer les packages NuGet.

  4. Pour la version de prévisualisation, veillez à choisir Inclure la version préliminaire au lieu de Stable uniquement dans les critères de recherche. Ensuite recherchez « Microsoft Dynamics CRM 2015 SDK core assemblies ». Veillez à sélectionner la version 7.1.0-preview.

  5. Cliquez sur Installer. Vous devrez accepter les termes du contrat de licence pour terminer l'installation de ce package.

Exécuter l'exemple

  1. Dans Visual Studio, avec la solution ouverte et les packages NuGet nécessaires installés, appuyez sur F5.

  2. Si vous n'avez pas encore exécuté l'un des exemples de code gérés Microsoft Dynamics CRM, vous devez entrer les informations permettant d'exécuter le code, sinon entrez le numéro de l'un des serveurs CRM que vous avez déjà configurés.

    Invite

    Description

    Entrer un nom de serveur et de port CRM [crm.dynamics.com]

    Tapez le nom de votre serveur Microsoft Dynamics CRM. La valeur par défaut est Microsoft Dynamics CRM Online (crm.dynamics.com) en Amérique du Nord.

    Exemple :
    crm5.dynamics.com

    Est-ce que cette organisation est mise en service dans les services en ligne de Microsoft (y/n) [n] ?

    Tapez y s'il s'agit d'une organisation mise en service dans les services en ligne de Microsoft. Sinon, tapez n.

    Entrez le domaine\nomutilisateur.

    Tapez votre compte Microsoft.

    Entrez le mot de passe.

    Tapez votre mot de passe. Dans la fenêtre, les caractères s’afficheront sous la forme de « * ». Le mot de passe est enregistré de façon sécurisée dans le gestionnaire d’informations d’identification Microsoft pour être réutilisé ultérieurement.

    Spécifiez un numéro d'organisation (1-n) [1].

    Dans la liste des organisations auxquelles vous appartenez, tapez le numéro correspondant. La valeur par défaut est 1, indiquant la première organisation de la liste.

  3. L'exemple effectuera les opérations décrites dans En quoi consiste cet exemple : et pourra vous demander des options supplémentaires.

  4. À la fin de l'exemple, appuyez sur ENTRÉE pour fermer la fenêtre de la console.

Voir aussi

Utiliser le suivi des modifications pour synchroniser les données avec les systèmes externes

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