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.

Utilisez des mappages de données pour mapper les données contenues dans le fichier source des colonnes de tables Dataverse. Vous devez mapper chaque colonne du fichier source avec 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.

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

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 d’un fichier source à une colonne Dataverse. Pour le mappage de colonne, utilisez la table ColumnMapping. Vous pouvez utiliser des relations 1 à 1 ou 1 à N (un à plusieurs) entre les colonnes sources et cibles. 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

Mappe une valeur de liste dans un fichier source à une colonne Dataverse du type OptionSetValue. Pour le mappage de valeur de liste, utilisez la table Mise en correspondance 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

Mappe une valeur de recherche dans un fichier source à une colonne Dataverse du 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 colonne LookupMapping.LookupSourceCode pour spécifier si la table référencée doit être recherchée dans le fichier source ou dans les applications 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 la recherche dans Dataverse, utilisez la valeur LookupSourceType.System. Pour obtenir la liste des valeurs LookupSourceCode, affichez les valeurs à sélectionner pour cette table. Pour afficher les métadonnées de votre organisation, installez la solution Navigateur de métadonnées décrite dans l’article Parcourir les définitions de table dans votre environnement. Vous pouvez également accéder à la documentation de référence pour les tables dans Référence de table. 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. Utilisez le nom d’ouverture de session utilisateur Dataverse comme informations de connexion. 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 enregistrées sous forme de texte et les pièces jointes sont enregistrées en tant que fichiers dans la base de données Dataverse.

Pour créer une note dans les applications 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 colonne ColumnMapping.SourceAttributeName sur « true » ou « false ». La valeur « true » indique un document joint. La valeur « false » indique une note.

• Définissez la colonne sur ColumnMapping.TargetAttributeName ou 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, affichez les valeurs à sélectionner pour cette table.

  Si les données sources représentent une note, mappez 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 indiqué dans le fichier source à la colonne Annotation.DocumentBody. La colonne DocumentBody enregistre le contenu de la pièce jointe.

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

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

Notes

La taille maximale des fichiers pouvant être chargée est déterminée par la propriété Organization.MaxUploadFileSize. Cette propriété est définie sous l’onglet E-mail des Paramètres système de l’application Dataverse. Ce paramètre limite la taille des fichiers pouvant être joints à des messages électroniques, des notes et des ressources Web. Le paramètre par défaut est 5 Mo. Toutefois, la taille d’une pièce jointe ne doit pas dépasser la taille de requête HTTP maximale (par défaut, 16 Mo).

Importer et exporter des mappages de données

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

Voir aussi

Importer des données
Préparer les fichiers sources 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 : exporter et importer un mappage de 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é).