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

Article
03/10/2022
6 minutes de lecture

Pour importer des données dans Dynamics 365 for Customer Engagement, 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 attributs d’entités Dynamics 365 for Customer Engagement. 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.

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 Dynamics 365 for Customer Engagement, utilisez les mappages suivants :

Mappage de colonnes

Mappe une colonne d’un fichier source à un attribut d’entité Dynamics 365 for Customer Engagement. 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 Dynamics 365 for Customer Engagement 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 Dynamics 365 for Customer Engagement 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 Dynamics 365 for Customer Engagement. 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 Dynamics 365 for Customer Engagement, 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 Accès aux métadonnées de votre organisation. Vous pouvez également accéder à la documentation de référence pour les entités dans Référence d'entité. 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 Dynamics 365 for Customer Engagement. Utilisez le nom d’ouverture de session Dynamics 365 for Customer Engagement 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 Dynamics 365 for Customer Engagement. 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 Dynamics 365 for Customer Engagement.

Pour créer une note dans Dynamics 365 for Customer Engagement, 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 Dynamics 365 for Customer Engagement. 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.

Hinweis

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 Courrier électronique des Paramètres système de l'application Dynamics 365. 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). Pour que la modification prenne effet, redéfinissez Internet Information Services (IIS). Pour ce faire, cliquez sur Démarrer, sur Exécuter, tapez iisreset, puis cliquez sur OK.

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

Voir aussi

Importer des données dans Dynamics 365 Customer Engagement (on-premises)
Ajouter un mappage de transformation
Ajouter des mappages de transformation pour l’importation