Exécuter l’importation des données
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
L’importation des données s’exécute directement sur le serveur Microsoft Dynamics 365. 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 Microsoft Dynamics 365.
Tous les utilisateurs Microsoft Dynamics 365 dotés des autorisations appropriées peuvent exécuter l’importation des données.
Contenu de la rubrique
Analyser les données sources
Transformer les données analysées
Télécharger les données transformées vers le serveur cible
Consigner les échecs
Importer les données d’audit
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 l’attribut ImportFile.ParsedTableName. Les en-têtes de colonne du fichier source sont spécifiés dans l’attribut ImportFile.HeaderRow. Si le fichier source n’inclut pas une première ligne contenant les en-têtes de colonne, cet attribut 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 ParseImportRequest. Récupérez les données de la table d’analyse à l’aide du message GetDistinctValuesImportFileRequest et du message RetrieveParsedDataImportFileRequest.
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 |
Description |
|---|---|
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 du message. |
|
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 du message. Utilisez ce message uniquement après avoir créé une table d’analyse à l’aide du message ParseImportRequest. Important N’utilisez pas ce message après avoir utilisé le message ImportRecordsImportRequest. 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 ImportRecordsImportRequest est terminée. |
|
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 du message. 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 ParseImportRequest. Important N’utilisez pas ce message après avoir utilisé le message ImportRecordsImportRequest. 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 ImportRecordsMessage 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 TransformImportRequest 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 l’attribut 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 Microsoft Dynamics 365.
Utilisez le message ImportRecordsImportRequest pour envoyer une tâche asynchrone pour télécharger les données transformées dans Microsoft Dynamics 365. L’identificateur unique de l’importation associée (importation de données) doit être spécifié dans la propriété 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 Microsoft Dynamics 365 est retourné dans la propriété AsyncOperationId de la réponse du message. 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 l’attribut ImportSequenceNumber des enregistrements qu’elle crée. L’attribut 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 l’entité du journal d’importation (ImportLog).
Pour déterminer le nombre d’enregistrements dont l’importation a échoué, récupérez l’attribut ImportFile.FailureCount de l’enregistrement. Pour vérifier le nombre d’enregistrements contenant des erreurs partielles pendant l’importation, récupérez l’attribut ImportData.HasError. Si l’attribut 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 entités Microsoft Dynamics 365 possèdent quatre attributs 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 :
L’attribut createdon indique la date et l’heure de création de l’enregistrement. Pour importer des données dans l’attribut createdon, mappez la colonne source contenant ces données sur l’attribut overriddencreatedon. Pendant l’importation, l’attribut createdon de l’enregistrement est mis à jour avec la valeur mappée sur l’attribut overriddencreatedon et l’attribut overriddencreatedon est défini sur la date et l’heure d’importation des données. Si aucune valeur source n’est mappée sur l’attribut overriddencreatedon, l’attribut createdon est défini sur la date et l’heure d’importation des données et l’attribut overriddencreatedon n’est défini sur aucune valeur.
Notes
Pour remplacer la valeur de l’attribut createdon pendant l’importation, vous devez disposez du privilège prvOverrideCreatedOnCreatedBy. Notez que le nom du privilège implique que vous pouvez également remplacer l’attribut createdby pendant l’importation. Toutefois, cette fonctionnalité n’est pas prise en charge actuellement.
Vous ne pouvez pas importer des données dans les attributs 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 attributs personnalisés dans Microsoft Dynamics 365 et mapper les colonnes sources sur ces nouveaux attributs personnalisés.
Voir aussi
Importer les données
Configurer l’importation des données
Billet de blog : Comment importer des pièces jointes par programmation
Entités d’importation de données
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright