Exécuter l’importation des données

L’importation des 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.
• Téléchargez les données transformées dans Dataverse.

Tous les utilisateurs Dataverse dotés des autorisations appropriées peuvent exécuter l’importation des 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 colonne ImportFile.ParsedTableName. Les en-têtes de colonne du fichier source sont spécifiés dans la colonne ImportFile.HeaderRow. Si le fichier source n’inclut pas une première ligne contenant les en-têtes de colonne, cette colonne spécifie les en-têtes de colonne par défaut générées 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 d’analyse à 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.

Message Classe d’UC Action ou fonction de l’API web	Description
ParseImportRequest ParseImportRequest Class ParseImport Action	Envoie une tâche d’importation qui analyse tous les fichiers d’importation associés à l’importation spécifiée (importation de données). Transmettez l’ID de l’importation associée (importation de données) dans la propriété ImportId de cette demande. L’ID de la tâche asynchrone qui s’exécute en arrière-plan et analyse les données est retourné dans la propriété AsyncOperationId de la réponse.
GetDistinctValuesImportFile GetDistinctValuesImportFileRequest Class GetDistinctValuesImportFile Function	Retourne des valeurs distinctes pour une colonne dans le fichier source contenant les valeurs de liste. Transmettez l’ID du fichier d’importation associé (importation de données) dans la propriété ImportFileId de cette demande. Les valeurs distinctes sont retournées dans un tableau de chaînes, dans la propriété Values de la réponse. Utilisez ce message uniquement après avoir créé une table d’analyse à l’aide du message ParseImport. Important : N’utilisez pas ce message après avoir utilisé le message ImportRecordsImport. Vous ne pouvez pas accéder à la table d’analyse une fois que l’exécution de la tâche d’importation envoyée par le message ImportRecordsImport est terminée.
RetrieveParsedDataImportFile RetrieveParsedDataImportFileRequest Class RetrieveParsedDataImportFile Function	Récupère les données de la table d’analyse. Transmettez l’ID du fichier d’importation associé (importation de données) dans la propriété ImportFileId de cette demande. Les données analysées sont retournées dans un tableau de chaînes bidimensionnel, dans la propriété Values de la réponse. Les données sont retournées dans le même ordre de colonnes que celui du fichier source. Utilisez ce message uniquement après avoir créé une table d’analyse à l’aide du message ParseImport. Important : N’utilisez pas ce message après avoir utilisé le message ImportRecordsImport. Vous ne pouvez pas accéder à la table d’analyse une fois que l’exécution de la tâche d’importation envoyée par le message ImportRecordsImport est terminée.

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 message TransformImport pour envoyer la TransformImportRequest Class ou TransformImport Action pour envoyer une tâche asynchrone pour transformer les données analysées. Transmettez l’identificateur unique de l’importation associée (importation de données) dans la colonne Import.ImportId de la demande. 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 avec succès, les données sont prêtes à être téléchargées dans le serveur Dataverse.

Utilisez le message ImportRecordsImport à l’aide de la ImportRecordsImportRequest Class ou de ImportRecordsImport Action pour envoyer une tâche 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 paramètre ImportId de la demande. L’identificateur unique de la tâche asynchrone qui s’exécute en arrière-plan et télécharge les données dans Dataverse est retourné dans la propriété AsyncOperationId de la réponse. Tous les fichiers d’importation associés à l’importation spécifiée (importation de données) sont importés.

Chaque tâche d’importation a un numéro séquentiel unique qu’elle stocke dans la colonne ImportSequenceNumber des enregistrements qu’elle crée. La colonne Organization.CurrentImportSequenceNumber contient le numéro séquentiel unique de la dernière tâche d’importation qui s’exécutait 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 été importés sont capturées dans la table du journal d’importation (ImportLog).

Pour déterminer le nombre d’enregistrements dont l’importation a échoué, récupérez la colonne ImportFile.FailureCount de l’enregistrement. Pour vérifier le nombre d’enregistrements contenant des erreurs partielles pendant l’importation, récupérez la colonne ImportData.HasError. Si la colonne HasError a la valeur true, un échec partiel s’est produit ; s’il a la valeur false, l’enregistrement a été importé avec succès.

Importer les données d’audit

Les tables Dataverse possèdent quatre colonnes par défaut utilisés pour suivre la date et l’heure de création et de dernière modification d’un enregistrement, ainsi que la personne à l’origine de ces opérations :

La colonne createdon indique la date et l’heure de création de l’enregistrement. Pour importer des données dans la colonne createdon, mappez la colonne source contenant ces données sur la colonne overriddencreatedon. Pendant l’importation, la colonne createdon de l’enregistrement est mis à jour avec la valeur mappée sur la colonne overriddencreatedon et la colonne overriddencreatedon est défini sur la date et l’heure d’importation des données. Si aucune valeur source n’est mappée sur la colonne overriddencreatedon, la colonne createdon est définie sur la date et l’heure d’importation des données et la colone overriddencreatedon n’est définie sur aucune valeur.

Notes

Pour remplacer la valeur de la colonne createdon pendant l’importation, vous devez disposez du privilège prvOverrideCreatedOnCreatedBy. Notez que le nom du privilège implique que vous pouvez également remplacer la colonne createdby pendant l’importation. Toutefois, cette fonctionnalité n’est pas prise en charge actuellement.

Vous ne pouvez pas importer des données dans les colonnes modifiedon, createdby et modifiedby. Si vous devez stocker des données sur la personne qui a créé et modifié les données et la date à laquelle cette modification est intervenue, vous pouvez créer des colonnes personnalisées dans Dataverse et mapper les colonnes sources sur ces 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 les mappages de transformation pour l’importation
Configurer l’importation des 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

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).