Intégration des données

Exploration du processus d'importation de données

Objective

After completing this lesson, you will be able to importez manuellement des enregistrements dans le système.

Validation pendant le processus d'importation

Le processus d'importation inclut deux contrôles de validation par défaut.

  1. Type de données : interdit l'importation de caractères alphabétiques dans un champ numérique.
  2. Longueur des données : interdit l'importation d'un champ plus long que celui indiqué dans le schéma de base de données.

Des validations supplémentaires peuvent être ajoutées manuellement dans la fonctionnalité Traitement d'entité ou dans la définition de mappage de zone Format d'importation.

Dans l'exemple de la section Demande d'importation, la demande d'importation s'est terminée par Erreur. Sélectionnez les icônes Afficher les messages ou Afficher le journal pour afficher les descriptions de l'erreur.

Demande d'importation qui a renvoyé une erreur. L'icône Informations est mise en surbrillance.

Dans ce cas, la valeur CustomerId était de 48 caractères, mais le champ InCustomer.CustomerId est limité à 30 caractères. 

le journal des messages détaillé d'une demande d'importation, indiquant que la limite de caractères a été dépassée.

Astuce

Évitez de vous appuyer sur des erreurs dans les demandes d'importation pour garantir l'intégrité des données, car les erreurs ne peuvent pas être résolues dans l'interface utilisateur. Le ou les enregistrements erronés devront être identifiés/résolus et réimportés dans une autre demande d'importation. La meilleure pratique consiste à ajouter des validations dans le cadre du post-processus afin que les erreurs puissent être corrigées dans l'interface utilisateur si possible.

Importation manuelle d'une liste de clients

Exemple de gestion :

Dans cet exercice, vous allez importer manuellement une liste de clients à l'aide de TrainCustomerImport.xlsx.

Étapes

  1. Créez un enregistrement InFile et ajoutez des données de base.

    1. Dans le portail d'intégration, sélectionnez Données entrantes→Recherche de fichiers.

    2. Sélectionnez Nouveau (+).

    3. Renseignez les zones avec les éléments suivants :

      • ID de fichier : CustomerImport
      • Nom : Importation de client
      • Date d'entrée en vigueur : 01/01/2025
      • Mois du processus : 2
      • Année du processus : 2025
      • ID de type de paiement : Paiement CLIENT
      • Commentaires : importation de client pour formation
    4. Sélectionnez Sauvegarder.

  2. Ajoutez un fichier d'importation.

    1. Dans la section Demandes d'importation, sélectionnez +.

      Ajouter une demande d'importation
    2. Dans la liste déroulante Format d'importation, sélectionnez Client de formation.

    3. Définissez le type de chargement sur Client.

    4. Dans la zone Contenu du fichier, sélectionnez Choisir un fichier.

    5. Accédez à TrainCustomerImport.xlsx et sélectionnez Ouvrir.

    6. Sélectionnez Suivant.

      L'écran Synthèse de la demande d'importation de l'assistant s'affiche avec l'ID de la nouvelle demande d'importation.

    7. Sélectionnez Terminer.

      Les données sont chargées dans les tables temporaires appropriées en fonction du format d'importation. L'écran Détails du fichier est mis à jour comme indiqué ci-dessous.

      Demande d'importation qui a renvoyé une erreur. L'icône Confirmer est mise en surbrillance.
  3. Résoudre manuellement les erreurs d'importation

    Il semble que notre importation ait généré une erreur ! Cette étape vous permet de rechercher et de résoudre l'erreur.

    1. Sélectionnez Afficher les messages pour afficher les descriptions de l'erreur.

      Erreur d'importation de client avec surbrillance
    2. Placez le curseur sur la ligne Erreur pour afficher la description complète de l'erreur. Dans ce fichier, la ligne 13 n'est pas valide car CustomerId est trop long.

      Affichage de la description complète de l'erreur

      Remarque

      Il n'est pas possible de corriger cette erreur dans l'interface utilisateur car les données n'ont pas été validées dans la base de données. Pour corriger ce problème, nous allons corriger les données dans le fichier source et les réimporter.
    3. Ouvrez le fichier TrainCustomerImport.xlsx.

    4. Supprimez les 12 premières lignes de données.

    5. Déplacez la ligne 13 vers le haut jusqu'à la ligne 2, juste en dessous de l'en-tête.

    6. Remplacez l' ID client dans la ligne par Entraînement 12 et sauvegardez le fichier.

  4. Répétez le processus d'importation.

    1. Dans la section Demandes d'importation, sélectionnez +.

    2. Dans la liste déroulante Format d'importation, sélectionnez Client de formation.

    3. Définissez le type de chargement sur Client.

    4. Sélectionnez Choisir un fichier et sélectionnez le fichier fixe.

    5. Sélectionnez Ouvrir.

    6. Sélectionnez Suivant.

    7. Sélectionnez Terminer.

      Remarque

      La liste Demandes d'importation doit ressembler à l'image suivante.
      La section Demandes d'importation de l'enregistrement de fichier d'importation. La première ligne affiche une erreur d'importation. La deuxième ligne affiche une demande d'importation traitée.

Synthèse

  • Le processus d'importation a deux contrôles de validation par défaut : le type de données et la longueur des données.
  • Des validations supplémentaires peuvent être configurées dans Modification d'entité.
  • Il est recommandé d'ajouter des validations dans le cadre du post-processus afin que les erreurs puissent être corrigées dans l'interface utilisateur.