Exemple : Insérer ou mettre à jour un enregistrement à l’aide de Upsert

Cet exemple de code montre comment insérer ou mettre à jour des enregistrements à l’aide du message UpsertRequest.

Comment exécuter cet exemple

1. Télécharger ou cloner le référentiel Exemples pour en 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 UpsertRequest est destiné à un usage dans un scénario où il contient les données nécessaires pour mettre à jour ou insérer un enregistrement.

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. Vérifie la version actuelle de l’organisation.
2. Importez un solution gérée (UpsertSample_1_0_0_0_managed.zip) qui crée une table sample_product qui a un clé secondaire nommé sample_productcode. Vérifiez que les index pour prendre en charge la clé secondaire sont actifs.

Démontrer

1. La méthode ProcessUpsert traite des données dans newsampleproduct.xml pour représenter de nouveaux produits et créer 13 nouveaux enregistrements.
2. La deuxième fois que la méthode ProcessUpsert est appelée, elle traite les données de updatedsampleproduct.xml pour représenter les mises à jour des produits créés précédemment.
3. La méthode UpsertRequest crée 6 enregistrements mis à jour.

Nettoyer

Affichez une option pour supprimer la solution gérée créée lors de l’Installation. 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 pour obtenir le même résultat.