Créer des mappages de données pour l’importation

Pour importer des données dans Microsoft Dataverse, vous devez fournir les mappages de données appropriés.

Vous pouvez télécharger des exemples de mappages de données à partir de Téléchargements Microsoft : DataImportMaps.zip.

Vous utilisez des mappages de données pour mapper les données contenues dans le fichier source aux colonnes de la table Dataverse. Vous devez mapper chaque colonne du fichier source à une colonne appropriée. Les données des colonnes non mappées ne sont pas importées pendant l’opération d’importation des données.

La carte de données est représentée par la table Data Map (ImportMap). Vous pouvez créer une carte en créant de nouveaux enregistrements de cette table. La carte a un nom unique contenu dans la ImportMap.Name colonne. Vous pouvez spécifier le nom de la source d’importation pour laquelle ce mappage de données est créé à l’aide de la ImportMap.Source colonne.

Mappages de colonne, de valeur de liste et de recherche

Pour mapper une colonne, une valeur de liste ou une valeur de recherche dans le fichier source à une colonne Dataverse, utilisez les mappages suivants :

Mappage de colonnes

Mappe une colonne dans un fichier source à une colonne de Dataverse. Pour le mappage de colonnes, utilisez la table ColumnMapping . Vous pouvez utiliser des relations 1:1 (un-à-un) ou 1 :N (un-à-plusieurs) entre les colonnes source et cible. Par exemple, vous pouvez mapper des informations d'adresse de compte aux adresses de facturation et de livraison dans une commande.

Mappage de valeurs de liste

Associe une valeur de liste dans un fichier source avec une colonne Dataverse du type OptionSetValue. Pour le mappage des valeurs de liste, utilisez la table Mappage des valeurs de liste (PickListMapping).

Si une valeur spécifiée dans la colonne du fichier source est une valeur de liste, telle que OptionSetValue, Status, State et Boolean, vous devez fournir un mappage de valeur de liste en plus d’un mappage de colonne. Par exemple, mappez les valeurs de liste « bill » et « ship » dans le fichier source aux valeurs de facture et d'expédition du type OptionSetValue.

Mappage de recherche

Fait correspondre une valeur de recherche dans un fichier source à une colonne Dataverse de type EntityReference. Pour le mappage de recherche, utilisez la table LookUpMapping .

Si la valeur spécifiée dans le fichier source fait référence à une table, vous devez fournir un mappage de recherche pour cette valeur. Utilisez la LookupMapping.LookupSourceCode colonne pour spécifier s’il faut rechercher la table référencée dans le fichier source ou dans Dataverse. Si vous utilisez les types de liaison anticipée, utilisez l'énumération LookupSourceType pour définir les valeurs de recherche. Pour effectuer une recherche dans le fichier source, utilisez la valeur LookupSourceType.Source. Pour effectuer une recherche dans Dataverse, utilisez la LookupSourceType.System valeur. Pour obtenir la liste des valeurs LookupSourceCode, consultez les valeurs de choix pour ce tableau. Pour afficher les métadonnées de votre organisation, installez la solution Navigateur de métadonnées décrite dans Parcourir les définitions de table dans votre environnement. Vous pouvez également parcourir la documentation de référence pour les tables de la Table Reference. Vous pouvez fournir plusieurs mappages de recherche. La tâche de transformation asynchrone traite tous les mappages disponibles. Elle trouve les enregistrements référencés et met à jour la table d’analyse avec les identificateurs uniques des enregistrements. Pour plus d’informations, voir Exécuter l’importation des données.

Mappage de propriétaire

Utilisez le mappage de propriétaire pour mapper un utilisateur spécifié dans le fichier source à un utilisateur dans Dataverse. Pour les informations de connexion, utilisez le nom de connexion de l’utilisateur Dataverse. Pour le mappage de propriétaire, utilisez la table OwnerMapping .

les notes et pièces jointes.

Le mappage des notes et des pièces jointes est géré différemment des autres tables. Les notes et pièces jointes sont utilisées pour ajouter des informations supplémentaires à un enregistrement dans Dataverse. Les notes sont stockées en tant que texte et pièces jointes sont stockées en tant que fichiers dans la base de données Dataverse.

Pour créer une note dans Dataverse, définissez la colonne Annotation.IsDocument dans la table d’annotation (note) sur false. Pour créer une pièce jointe, définissez IsDocument sur true.

Utilisez les paramètres suivants pour mapper des notes et des pièces jointes :

• Définissez la ColumnMapping.SourceAttributeName colonne sur «true » ou «false ». La valeur «true » indique une pièce jointe. La valeur «false » indique une note.

• Définissez la ColumnMapping.TargetAttributeName colonne sur IsDocument.

• Définissez la colonne ColumnMapping.ProcessCode sur la valeur ImportProcessCode.Internal de l’énumération ImportProcessCode, si vous utilisez les types de liaison anticipée. Pour obtenir la liste des valeurs ProcessCode, consultez les valeurs de choix pour ce tableau.

  Si les données sources représentent une note, associez le texte de la note à la colonne Annotation.NoteText. Si vous utilisez des fichiers Salesforce, ils sont généralement stockés sur le disque sous des numéros d’identification uniques. Pour importer une pièce jointe, vous devez mapper un numéro d’identification de fichier contenu dans le fichier source à la Annotation.DocumentBody colonne. La DocumentBody colonne stocke le contenu de la pièce jointe.

  La tâche asynchrone d’importation vérifie les mappages dont le nom de colonne source est défini sur «true » et «false » pour découvrir les notes et les pièces jointes. S’il trouve un mappage de pièces jointes, il recherche les fichiers spécifiés sur le disque et charge le contenu du fichier en tant que pièces jointes dans Dataverse. Si un fichier est introuvable, une erreur est retournée.

  Si vous ne fournissez pas de mappage pour une table d’annotation (note), le travail d’importation génère un mappage par défaut pour la note.

Importer et exporter des mappages de données

Vous pouvez exporter un mappage de données existant vers un fichier XML et importer des mappages de données XML dans Dataverse. Pour exporter une carte de données à partir de Dataverse, utilisez le message à l’aide de la ExportMappingsImportMapclasse ExportMappingsImportMapRequest ou de l’action ExportMappingsImportMap . Pour importer des mappages de données XML et créer un mappage de données dans Dataverse, utilisez le ImportMappingsImportMap message à l’aide de la classe ImportMappingsImportMapRequest ou de l’action ImportMappingsImportMap.

Voir aussi

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