Créer une intégration de données

Ajoutez des informations nouvelles ou mises à jour à vos ensembles de données actuels en les important dans des tables existantes de votre application grâce à la puissance de Hub d'intégration. Planifiez les importations futures pour ajouter des données à des moments spécifiques.

Cette vidéo vous montre comment effectuer la procédure suivante.

Avant de commencer

• Vous devez disposer d’une table existante dans votre application. Pour plus d'informations, consultez Créer une table vide.
  Remarque :

  Actuellement, les fichiers Excel sont le seul format de données accepté que les utilisateurs peuvent télécharger.
• Rôle requis : admin, sn_app_eng_studio.user ou delegated_developer. Pour plus d'informations, consultez Déléguer des développeurs à l’aide de AES.

Procédure

1. Accédez à la Tout > App Engine > App Engine Studio.
2. Sur la page Mes applications, ouvrez votre application.
3. En regard de l’en-tête Données, sélectionnez l’icône Ajouter ( ).
4. Sélectionnez Créer une intégration de données.

Configurer votre source d’importation de données

5. Configurez votre source d’importation de données en procédant comme suit.
   1. Renseignez les champs pour l’intégration des données.

      Champ	Description
      Nom	Donnez un nom à l'intégration.
      Description brève	Description de votre intégration.
      Demande	Nom du périmètre de l’application pour votre intégration.

   2. Sélectionnez Enregistrer et continuer.
   3. Utilisez le menu Type de source pour sélectionner un type de source de données.
      • Pour choisir un fichier Excel ou CSV, sélectionnez AD-HOC > > Fichier, puis sur Excel ou CSV. Dans la section Chargement de fichier, chargez un fichier XLSX, XLS, CSV ou ZIP.
      • Pour choisir une action de flux de données, sélectionnez Spokes. Les flux de données actifs sont organisés par spoke et répertoriés par ordre alphabétique. Dans la section Connexion, sélectionnez l’alias de connexion. Pour les actions de flux de données qui utilisent un alias de connexion, vous pouvez remplacer l’alias de connexion par défaut par l’un de ses alias enfants. Pour plus d’informations, consultez Créer un alias de connexion et d’informations d’identification.
   4. Configurez la source de données.
      • Pour configurer une feuille de calcul Excel, spécifiez la feuille à utiliser et le numéro de ligne à utiliser pour l’en-tête. Une seule feuille et un seul en-tête peuvent être spécifiés.
      • Pour configurer un fichier CSV, sélectionnez le délimiteur.
      • Pour configurer une action de flux de données, entrez toutes les entrées requises. Cette section s’affiche uniquement si l’action Flux de données a des entrées à saisir. Les actions de flux de données avec entrées ont des entrées uniques, de sorte que les champs de cette section dépendent de l’action de flux de données sélectionnée et de sa configuration. Toutes les valeurs par défaut déjà configurées par les entrées de spoke sont pré-remplies. Vous pouvez afficher les détails de l’action Flux de données en cliquant sur l’icône d’informations (icône ) en regard de celle-ci. Un clic sur l’icône ouvre la configuration de l’action de flux de données.
6. Sélectionnez le bouton Enregistrer .

Choisir votre table cible et configurer les options d’importation

7. Sélectionnez l’onglet Mapper à la cible .
8. Sélectionnez la table cible et les options pour l’intégration de données que vous créez.
   Le mappage des données sources à la table cible vous permet de contrôler la façon dont le système traite les données que vous avez chargées.
   1. Sur la page Mappage des données de table de la source vers la cible, sélectionnez Ajouter une table.
   2. Renseignez les champs de la fenêtre Propriétés de mappage.

      Champ	Description
      Table cible	Nom de la table vers laquelle transformer vos données.
      Exécuter les règles métier de la table lors de l'importation	Option permettant d’exécuter les règles métier de la table cible lorsque vous importez les données.
      Exécuter l'importation de façon synchrone	Option permettant d’exécuter l’importation de manière synchrone. Lorsque des données sont transformées en parallèle et qu’il existe plusieurs enregistrements sources avec une valeur de coalescence spécifique, l’activation de cette option garantit qu’un seul enregistrement avec cette valeur de fusion est inséré à la fois. Pour plus d’informations, reportez-vous à la section Insertions synchronisées de la page Importations simultanées .

   3. Sélectionnez Enregistrer.

      Vous pouvez ajouter plusieurs tables cibles à votre intégration. Répétez les étapes 4a à 4c pour chaque table cible que vous souhaitez ajouter.

      Les tables sont répertoriées dans l’ordre dans lequel elles sont ajoutées. Vous pouvez modifier l’ordre à l’aide de l’icône de glissement, à gauche de chaque carte de table pour faire glisser la carte vers une autre position. L’ordre des cartes de table détermine l’ordre dans lequel les données sont transformées en tables cibles lors de l’exécution.

      Remarque :

      Vous ne pouvez pas sélectionner la même table plus d’une fois, et vous ne pouvez pas sélectionner une table étendue ou une table parente d’une table déjà présente dans l’intégration.

Mapper les champs d’importation à votre table cible

9. Mappez les champs de votre importation à la table cible en effectuant les actions suivantes.

   Figure 1. Mapper les données à la table cible

   

   1. Sur la page Mappage des données de table de la source vers la cible, sélectionnez le bouton avec la table cible vers laquelle vous souhaitez effectuer le mappage.
      Cela ouvre la section de mappage de données pour la table. La partie gauche de la page affiche les données sources. Le côté droit est pour la table cible.
   2. Utilisez le bouton Ajouter un champ, Ajouter tous les champs ou Mapper automatiquement pour configurer le côté cible et commencer le mappage des données.
      • Pour ajouter tous les champs dans la table cible, sélectionnez Ajouter tous les champs. Les champs sont ajoutés par ordre alphabétique.
      • Pour ajouter des champs individuellement, sélectionnez Ajouter un champ , puis choisissez le nom du champ dans la liste. Un champ ne peut être ajouté qu’une seule fois.
      • Pour ajouter des champs et les mapper automatiquement, sélectionnez Mappage automatique. Mappage automatique des entités sources aux entités cibles portant le même nom. Le bouton Mappage automatique dispose de deux options.
        • Tous les champs correspondants de la table cible ajoutent tous les champs et mappent ceux qui correspondent.
        • Tous les champs non mappés dans la sélection cible mappent uniquement les champs que vous avez déjà ajoutés mais pas encore mappés. Si vous n’avez pas encore ajouté de champs, cette option n’est pas disponible.

      • Pour une entité cible qui a déjà été mappée, la sélection du mappage automatique ne change pas sa valeur. Un champ mappé automatiquement a une icône de baguette sur sa pastille de données.

        Par défaut, le mappage automatique mappe au maximum une entité source à une entité cible. Vous pouvez modifier cela en définissant la glide.ih.automap.extractone propriété sur false.

        Le mappage automatique met en correspondance les entités source à cible en recherchant des noms de colonnes qui correspondent à au moins 80 %. Vous pouvez modifier cela avec la glide.ih.automap.minimum.score propriété. Par exemple, pour établir des correspondances basées sur une similarité de 60 %, vous pouvez définir sur glide.ih.automap.minimum.score 60.

   3. Mappez les données en faisant glisser des pastilles de données de la source vers la colonne Valeur de la table cible.

      Vous pouvez également mapper des données à l’aide du sélecteur de ) sur le côté droit de la table cible. Vous pouvez entrer plusieurs valeurs dans la colonne Valeur, vous pouvez également entrer du texte.

      Une fois que vous avez mappé un champ source à un champ cible, une petite icône de coche (icône de ) apparaît en regard du nom du champ source. Si vous placez le curseur sur la coche, l’info-bulle répertorie les champs cibles auxquels le champ source a été mappé, jusqu’à cinq champs.

   4. Facultatif : Utilisez le commutateur Correspondance pour spécifier les champs dans lesquels le système doit vérifier les données correspondantes et, le cas échéant, mettre à jour les enregistrements existants au lieu d’en créer de nouveaux.

      Par exemple, si une table cible comporte un champ Numéro de commande et un enregistrement avec un numéro de commande 743, il existe deux options pour gérer les correspondances potentielles.

      • Si le commutateur Correspondance du champ Numéro de commande est activé, le système vérifie les données correspondantes. Si les données sources ont un enregistrement avec le même numéro d’ordre, le système met à jour l’enregistrement existant dans la table cible.
      • Si le commutateur Correspondance du champ Numéro de commande est désactivé, le système ne vérifie pas les données correspondantes. Si les données sources ont un enregistrement avec le même numéro d’ordre, le système crée un nouvel enregistrement dans la table cible. Dans ce cas, la table cible aura deux enregistrements, tous deux avec un numéro d’ordre de 743.
   5. Facultatif : Pour les champs de choix et de référence, spécifiez la colonne à laquelle mapper les données.
      1. Sélectionnez l’icône Engrenage (icône ).
      2. Dans Champ, sélectionnez la colonne vers laquelle effectuer le mappage.
      3. Dans Si aucun enregistrement correspondant n’existe, procédez comme suit et spécifiez ce qu’il faut faire si cette colonne n’est pas disponible.
         • Créer un choix/enregistrement : crée le choix ou l’enregistrement dans la table cible.
         • Ignorer ce champ : ignore uniquement le champ de la table cible.
         • Ignorer cet enregistrement : ignore l’enregistrement entier dans la table cible.
      4. Sélectionnez Terminé.
   6. Facultatif : Modifiez ou modifiez vos données en appliquant des fonctions de transformation.
      Par exemple, vous pouvez utiliser la fonction de transformation Majuscule pour modifier une chaîne d’entrée en caractères tout en majuscules. Pour plus d’informations, voir Fonctions de transformation.

      Remarque :

      Toutes les fonctions de transformation disponibles lors de la création de flux et de flux secondaires ne sont pas disponibles dans Hub d'intégration - Importer.

      1. Sélectionnez l’icône de fonction de transformation (icône de ).
      2. Sélectionnez une fonction de transformation dans le menu, puis sélectionnez OK.
      3. Pour appliquer des fonctions de transformation supplémentaires, sélectionnez Ajouter une nouvelle transformation. Les fonctions de transformation sont appliquées dans l’ordre dans lequel elles sont sélectionnées.
      4. Une fois que vous avez ajouté toutes vos fonctions de transformation, sélectionnez Terminé.
10. Lorsque vous avez terminé votre mappage, cliquez sur Enregistrer.

Importer le fichier ou planifier l’importation de données

11. Choisissez ce qui doit faire de l’importation de données que vous venez de créer et de mapper.
    • Pour importer l’ensemble de données que vous avez chargé maintenant, sélectionnez Exécuter l’importation.
    • Pour configurer une importation ultérieure des données, sélectionnez Planifier une importation.
    Consultez Run or schedule a data import.
12. Facultatif : Si vous avez exécuté l’importation, prévisualisez la table et assurez-vous qu’elle s’affiche avec le contenu supplémentaire en revenant à la table cible, en actualisant l’écran de votre navigateur et en cliquant sur Aperçu.
13. Facultatif : Si vous avez ajouté de nouvelles colonnes au cours de l’importation et que vous souhaitez qu’elles s’affichent dans la table cible, sélectionnez Personnaliser la liste pour modifier les colonnes qui s’affichent.