Importer les données

  • Article

Pour importer des données dans Dynamics 365 Customer Engagement (on-premises), vous pouvez utiliser la fonctionnalité d’importation de données. L’importation de données permet de charger des données depuis différents systèmes de gestion de la relation client vers Dynamics 365 Customer Engagement (on-premises). Vous pouvez importer des données dans les attributs standard et personnalisés de la plupart des entités commerciales personnalisées. Vous pouvez aussi inclure les données associées, telles que des notes et des pièces jointes.

Dynamics 365 Customer Engagement (on-premises) inclut un outil d’application web appelé Assistant Importation de données. Cet outil permet d’importer des enregistrements de données depuis un ou plusieurs fichiers Comma-Separated Values (.csv), XML Spreadsheet 2003 (.xml) ou fichiers texte.

Pour plus d’informations sur l’Assistant Importation de données, voir l’aide de Dynamics 365 Customer Engagement (on-premises).

Les services web Dynamics 365 Customer Engagement (on-premises) offrent les fonctionnalités supplémentaires ci-après qui ne sont pas disponibles dans l’Assistant Importation de données :

  • Créer des mappages de données qui incluent le mappage de transformation complexe, telle que la concaténation, le fractionnement et le remplacement.

  • Définir le mappage de transformation personnalisé.

  • Afficher les données sources stockées dans les tables d’analyse temporaires.

  • Accéder aux journaux d’erreurs pour générer des outils de création de rapports d’erreurs personnalisés avec des vues de consignation améliorées.

  • Exécuter l’importation de données à l’aide de scripts de ligne de commande.

  • Ajouter des balises XML LookupMapdans le mappage de données pour indiquer que la recherche de données sera lancée et effectuée sur un fichier source utilisé dans l’importation.

  • Ajouter des balises XML OwnerMetadata personnalisées dans le mappage de données pour mettre en correspondance les enregistrements utilisateur du fichier source avec les enregistrements de l’utilisateur (utilisateur système) dans Dynamics 365 Customer Engagement (on-premises).

  • Utiliser les contrôles de validation facultatifs.

    Note

    La validation n’est pas facultative dans l’Assistant Importation de données.

    Pour implémenter l’importation de données, vous effectuez en général les opérations suivantes :

  • Créer un fichier Comma-Separated Values (CSV), XML Spreadsheet 2003 (XMLSS) ou un fichier source texte.

  • Créer un mappage de données ou utiliser un mappage de données existant.

  • Associer un fichier d’importation avec un mappage de données.

  • Télécharger le contenu à partir d’un fichier source dans le fichier d’importation associé.

  • Analyser le fichier d’importation.

  • Transformer les données analysées.

  • Télécharger les données transformées sur le serveur Dynamics 365 Server cible.

    Vous pouvez importer des données depuis un fichier source ou plusieurs fichiers sources. Un fichier source peut contenir des données d’un type d’entité ou de plusieurs types d’entités.

    L’analyse, la transformation et le téléchargement des données sont effectués par les travaux asynchrones exécutés en arrière-plan.

Note

Par défaut, toutes les entités personnalisées sont activées pour l’importation. Pour déterminer si une entité commerciale est activée pour l’importation, voir les métadonnées d’entité pour l’entité spécifique. Si une entité est activée pour l’importation, la propriété de métadonnées d’entité IsImportable est définie sur true. La valeur de cette propriété ne peut pas être modifiée pour les entités commerciales prêtes à l’emploi. 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é.

Il est recommandé de limiter l’importation à 20 000 lignes au maximum.

Préparer les fichiers sources

Avant de pouvoir importer des données dans Dynamics 365 Customer Engagement (on-premises), vous devez créer les fichiers de données sources. Les fichiers de sources de données que vous utilisez dans une importation doivent être mis en forme comme valeurs séparées par des virgules (.csv), feuilles de calcul 2003 XML (.xml) ou fichiers texte. L’utilisation de fichiers sources permet de transférer des données à partir de systèmes de base de données qui utilisent différents formats vers Dynamics 365 Customer Engagement (on-premises). Pour en savoir plus, voir Préparer les fichiers sources dans la documentation Dataverse.

Créer des mappages de données

Pour importer des données dans Dynamics 365 Customer Engagement (on-premises), vous devez fournir les mappages de données appropriés. Pour en savoir plus, voir Créer des mappages de données dans la documentation Dataverse.

Ajouter des données de transformation

Utilisez le mappage de transformation pour modifier les données avant de les importer. Par exemple, fractionner un nom complet qui est contenu dans le fichier source en un prénom et nom pour correspondre aux attributs cibles d’une entité. Pour en savoir plus, voir Ajouter un mappage de transformation dans la documentation Dataverse.

Importation de données

Les informations de configuration requises pour importer les données sont contenues dans l’entité d’importation de données (Import) et dans l’entité de fichier source à importer (ImportFile). Pour en savoir plus, voir Configurer l’importation des données dans la documentation Dataverse.

Exécuter l’importation des données

L’importation des données s’exécute directement sur le serveur Dynamics 365 Server. Pour exécuter l’importation des données, configurez des tâches asynchrones à exécuter en arrière-plan qui effectuent les opérations ci-après, dans l’ordre indiqué :

  • Analysez les données sources contenues dans le fichier d’importation.
  • Transformez les données analysées à l’aide du mappage de données.
  • Téléchargez les données transformées dans Dynamics 365 Customer Engagement (on-premises).
  • Tous les utilisateurs Dynamics 365 Customer Engagement (on-premises) dotés des autorisations appropriées peuvent exécuter l’importation des données. Pour en savoir plus, voir Exécuter l’importation des données dans la documentation Dataverse.

Entités d’importation de données

Les entités d’importation de données de Dynamics 365 Customer Engagement (on-premises) permettent de créer des mappages de données, de configurer et d’exécuter les importations de données, et d’enregistrer les informations d’échec. Pour en savoir plus, voir Entités d’importation de données dans la documentation Dataverse.

Gestion des données dans Dynamics 365 Customer Engagement (on-premises)Exemple : Exporter et importer un mappage de données
Exemple : Importer des données à l’aide d’un mappage de données complexe