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

  • Article

Cet exemple de code montre comment récupérer les modifications d’une table et synchroniser des données avec les systèmes externes en utilisant le message RetrieveEntityChanges avec les classes RetrieveEntityChangesRequest et RetrieveEntityChangesResponse.

SDK pour .NET : exemple de code pour synchroniser des données avec les systèmes externes à l′aide du suivi des modifications

Pour plus d’informations sur la fonctionnalité illustrée par cet exemple regarder, voir Utiliser le suivi des modifications pour synchroniser les données avec les systèmes externes.

Comment exécuter cet exemple

  1. Téléchargez ou clonez le référentiel Exemples pour avoir une copie locale.
  2. (Facultatif) Modifiez le fichier dataverse/App.config pour définir une chaîne de connexion qui spécifie l’instance Microsoft Dataverse à laquelle vous souhaitez vous connecter.
  3. Ouvrez l’exemple de solution dans Visual Studio et appuyez sur F5 pour exécuter l’exemple. Après avoir spécifié une chaîne de connexion dans le fichier dataverse/App.config, tout exemple que vous exécutez utilise ces informations de connexion.

Si vous ne spécifiez pas de chaîne de connexion dans le fichier dataverse/App.config, une boîte de dialogue s’ouvre chaque fois que vous exécutez l’exemple et vous devez entrer des informations sur l’instance Dataverse à laquelle vous souhaitez vous connecter et sur les informations d’identification que vous souhaitez utiliser. Cette boîte de dialogue met en cache les connexions précédentes afin que vous puissiez choisir une connexion déjà utilisée.

Les exemples de ce référentiel qui nécessitent une connexion à une instance Dataverse pour s’exécuter incluent une référence liée au fichier dataverse/App.config.

En quoi consiste cet exemple :

Le message RetrieveEntityChanges est destiné à un usage dans un scénario où les données d’un système externe sont synchronisées et la fonction de suivi des modifications peut être utilisée pour détecter et réconcilier les modifications des données.

Sans système distinct requis pour répliquer entièrement ce scénario, cet exemple simule le scénario en exécutant deux requêtes. Entre les requêtes, certaines données sont modifiées afin que la deuxième requête retourne des données sur les modifications effectuées.

Utiliser cet exemple

Afin de simuler le scénario décrit dans En quoi consiste cet exemple, l’exemple procède comme suit :

Installation

  1. Importez un solution gérée (ChangeTrackingSample_1_0_0_0_managed.zip) qui crée une table sample_book avec une clé secondaire nommée sample_bookcode. Vérifiez que les index pour prendre en charge la clé secondaire sont actifs
  2. 10 enregistrements de table sample_book initiaux sont créés pour le suivi des modifications apportées à ces tables.

Démontrer

  1. Exécutez la demande initiale et masquez les résultats, notamment le DataToken
  2. Mettre à jour les enregistrements créés dans Installation
  3. Effectuez une deuxième demande, cette fois en transmettant DataVersion avec la valeur DataToken extraite de la demande initiale.
  4. Afficher les modifications de table renvoyées par la deuxième requête

Nettoyer

Affichez une option pour supprimer la solution gérée importée dans Setup, ce qui supprime la table sample_book et toutes les données créées dans cet exemple. La suppression est facultative au cas où vous souhaiteriez examiner les tables et les données créées par l’échantillon. Vous pouvez supprimer manuellement l’enregistrement ChangeTrackingSample pour obtenir le même résultat.

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é).