Exemple : exporter et importer un mappage de données

Cet exemple montre comment créer un mappage d’importation (mappage de données) dans Microsoft Dataverse, l’exporter en tant que données mises au format XML, importer des mappages modifiés et créer une nouvelle carte d’importation pour Dataverse en fonction des mappages importés.

Kit de développement logiciel (SDK) pour .NET : exemple de code pour exporter et importer un mappage de données

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

Voir la description du texte dans la section Paramétrage, car la fonctionnalité principale du programme est exécutée au moment de l’installation.

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. La méthode CreateImportMapping crée l’enregistrement du mappage à importer.
3. La méthode RetrieveMappingXML exporte le mappage (Xml) créé.
4. La méthode ChangeMappingName analyse le fichier Xml pour changer la colonne du nom.
5. La méthode ImportMappingsByXml crée un mappage à partir du Xml (précédemment exporté).

Nettoyer

Présentez une option pour supprimer l’exemple de données créé dans 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.

Voir aussi

Importer des données
Préparer les fichiers sources pour l’importation
Créer des mappages de données pour l’importation
Ajouter les mappages de transformation pour l’importation
Configurer l’importation des données
Exécuter l’importation des données
Tables de l’importation des données
Exemple : Importer des données à l’aide d’un mappage de données complexe

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