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

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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

Des exemples de mappages de données sont présents dans cet emplacement dans le Kit de développement logiciel : SDK\Resources\DataImportMaps\.Téléchargez le package Kit de développement logiciel (SDK) de Microsoft Dynamics CRM.

Utilisez des mappages de données pour mapper les données contenues dans le fichier source des attributs d’entités Microsoft Dynamics 365. Vous devez mapper chaque colonne du fichier source à un attribut approprié. 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 l’entité de mappage d’importation (mappage de données). Vous pouvez créer un mappage à l’aide du message CreateRequest ou mettre à jour un mappage existant à l’aide de la méthode IOrganizationService.Update. Le mappage porte un nom unique contenu dans l’attribut 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 l’attribut ImportMap.Source.

Contenu de la rubrique

Mappages de colonne, de valeur de liste et de recherche

Mappage de propriétaire

les notes et pièces jointes.

Importer et exporter des mappages de données

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 à un attribut Microsoft Dynamics 365, utilisez les mappages suivants :

Mappage de colonnes

Mappe une colonne d’un fichier source à un attribut d’entité Microsoft Dynamics 365. Pour le mappage de colonne, utilisez l’entité de mappage de colonne (ColumnMapping). Vous pouvez utiliser des relations 1 à 1 ou 1 à N (un à plusieurs) entre les attributs 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 à un attribut Microsoft Dynamics 365 du type OptionSetValue. Pour le mappage de valeur de liste, utilisez l’entité de mappage de liste déroulante 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 à un attribut Microsoft Dynamics 365 du type EntityReference. Pour le mappage de recherche, utilisez l’entité de mappage de recherche (LookupMapping).

Si la valeur spécifiée dans le fichier source fait référence à une entité, vous devez fournir un mappage de recherche pour cette valeur. Utilisez l’attribut LookupMapping.LookupSourceCode pour spécifier si l’entité référencée doit être recherchée dans le fichier source ou dans Microsoft Dynamics 365. 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 Microsoft Dynamics 365, utilisez la valeur LookupSourceType.System. Pour obtenir la liste des valeurs LookupSourceCode, affichez les valeurs de liste déroulante pour cette entité.Pour afficher les métadonnées d'entité pour votre organisation, installez la solution Navigateur de métadonnées décrite dans l'article Parcourir les métadonnées de votre organisation. Vous pouvez également afficher les métadonnées d'une organisation non personnalisée dans un fichier Excel appelé EntityMetadata.xlsx dans le dossier de niveau supérieur du téléchargement du Kit de développement logiciel (SDK). 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 Microsoft Dynamics 365. Utilisez le nom d’ouverture de session Microsoft Dynamics 365 comme informations de connexion. Pour le mappage de propriétaire, utilisez l’entité de mappage de propriétaire (OwnerMapping).

les notes et pièces jointes.

Le mappage des notes et des pièces jointes est géré différemment des autres entités. Les notes et pièces jointes sont utilisées pour ajouter des informations supplémentaires à un enregistrement dans Microsoft Dynamics 365. 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 Microsoft Dynamics 365.

Pour créer une note dans Microsoft Dynamics 365, définissez l’attribut Annotation.IsDocument dans l’entité 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 l’attribut ColumnMapping.SourceAttributeName sur « true » ou « false ». La valeur « true » indique une pièce jointe. La valeur « false » indique une note.

• Définissez l’attribut ColumnMapping.TargetAttributeName sur IsDocument.

• Définissez l’attribut 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 de liste déroulante pour cette entité.

Si les données sources représentent une note, mappez le texte de la note à l’attribut 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 à l’attribut Annotation.DocumentBody. L’attribut DocumentBody enregistre le contenu de la pièce jointe.

La tâche d’importation asynchrone vérifie les mappages pour lesquels le nom de l’attribut source défini sur « true » et « false » pour découvrir des notes et des pièces jointes. 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 Microsoft Dynamics 365. Si un fichier est introuvable, une erreur est retournée.

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

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 Microsoft Dynamics 365. Pour exporter un mappage de données à partir de Microsoft Dynamics 365, utilisez le message ExportMappingsImportMapRequest. Pour importer les mappages de données XML et créer un mappage de données dans Microsoft Dynamics 365, utilisez le message ImportMappingsImportMapRequest.

Voir aussi

Importer les données
Ajouter les mappages de transformation pour l’importation
Ajouter les mappages de transformation pour l’importation

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright