Exécuter l’importation des données

L’importation de données s’exécute directement sur le serveur Microsoft Dataverse. 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.
• Chargez des données transformées dans Dataverse.

Tous les utilisateurs Dataverse disposant d’autorisations appropriées peuvent exécuter l’importation de données.

Analyser les données sources

L’analyse des données sources comprend l’analyse de tous les fichiers d’importation associés à une importation spécifique (importation de données).

Les données analysées sont stockées dans les tables d’analyse temporaires créées pour chaque fichier importé. Le nom de la table d’analyse est stocké dans la ImportFile.ParsedTableName colonne. Les en-têtes de colonne de fichier source sont spécifiés dans la ImportFile.HeaderRow colonne. Si le fichier source n’inclut pas de première ligne qui contient les en-têtes de colonne, cette colonne spécifie les en-têtes de colonne par défaut générés par le système.

Enregistrez les données analysées dans la table d’analyse à l’aide du message ParseImport. Récupérez les données de la table de parsing à l’aide du message GetDistinctValuesImportFile et du message RetrieveParsedDataImportFile.

Le tableau suivant répertorie les messages qui vous permettent d’analyser les fichiers d’importation et de récupérer les données analysées des tables d’analyse.

Transformer les données analysées

Pendant la transformation, vous modifiez les données analysées en appliquant tous les mappages et transformations de données disponibles associés à une importation spécifique (importation de données) aux données.

Utilisez le TransformImport message à l’aide de la classe TransformImportRequest ou de l’action TransformImport pour envoyer un travail asynchrone pour transformer les données analysées. Transmettez un identificateur unique de l’importation associée (importation de données) dans la Import.ImportId colonne de la requête. L’identificateur unique de la tâche asynchrone qui s’exécute en arrière-plan et transforme les données est retourné dans la propriété AsyncOperationId de la réponse du message.

Télécharger les données transformées vers le serveur cible

Une fois la transformation terminée, les données sont prêtes à être chargées sur le serveur Dataverse.

Utilisez le ImportRecordsImport message à l’aide de la classe ImportRecordsImportRequest ou de l’action ImportRecordsImport pour envoyer un travail asynchrone pour charger les données transformées dans Dataverse. L’identificateur unique de l’importation associée (importation de données) doit être spécifié dans le ImportId paramètre de la demande. Un identificateur unique du travail asynchrone qui s’exécute en arrière-plan et charge les données dans Dataverse est retourné dans la AsyncOperationId propriété de la réponse. Tous les fichiers d’importation associés à l’importation spécifiée (importation de données) sont importés.

Chaque travail d’importation a un numéro de séquence unique qu’il stocke dans la ImportSequenceNumber colonne des enregistrements qu’il crée. La Organization.CurrentImportSequenceNumber colonne contient un numéro de séquence unique du dernier travail d’importation exécuté dans le système. Vous pouvez utiliser ces numéros séquentiels uniques pour suivre les enregistrements appartenant à une tâche d’importation.

Consigner les échecs

Un échec de l’importation d’un enregistrement peut se produire pendant l’analyse, la transformation ou le téléchargement des données. Les raisons de l’échec et d’autres informations détaillées sur les enregistrements qui n’ont pas pu être importés sont capturées dans la table import log (ImportLog).

Pour savoir combien d’enregistrements n’ont pas pu être importés, récupérez la ImportFile.FailureCount colonne de l’enregistrement. Pour vérifier le nombre d’enregistrements ayant subi des échecs partiels lors de l’importation, récupérez la ImportData.HasError colonne. Si la HasError colonne est true, une défaillance partielle s’est produite, si c’est falsele cas, l’enregistrement a été importé avec succès.

Importer les données d’audit

Les tables Dataverse ont quatre colonnes par défaut utilisées pour suivre la date et l’heure de création et de dernière modification d’un enregistrement, ainsi que la personne qui l’a créée et modifiée.

La createdon colonne spécifie la date et l’heure de création de l’enregistrement. Pour importer des données dans la createdon colonne, mappez la colonne source qui contient ces données à la overriddencreatedon colonne. Pendant l’importation, la colonne de createdon l’enregistrement est mise à jour avec la valeur mappée à la overriddencreatedon colonne et la overriddencreatedon colonne est définie sur la date et l’heure à laquelle les données ont été importées. Si aucune valeur source n’est mappée à la overriddencreatedon colonne, la createdon colonne est définie sur la date et l’heure à laquelle les données ont été importées et la overriddencreatedon colonne n’est définie sur aucune valeur.

Vous ne pouvez pas importer de données dans les colonnes modifiedon, createdby, et modifiedby. Si vous devez stocker des données liées aux personnes qui ont créé et modifié les données et lorsque les données ont été modifiées, vous pouvez créer des colonnes personnalisées dans Dataverse et mapper les colonnes sources aux nouvelles colonnes personnalisées.

Voir aussi

Importer des données
Préparer les fichiers sources pour l’importation
Créer des mappages de données pour l’importation
Ajouter des mappages de transformation pour l’importation
Configurer l’importation de 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
Billet de blog : Comment importer des pièces jointes par programmation