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