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 précis.

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 :

  À l’heure actuelle, 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 les développeurs à l’aide de AES.

Procédure

1. Accédez à la Tout > App Engine > Studio du moteur de développement d'application.
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 de données.

      Champ	Description
      Nom	Donnez un nom à l'intégration.
      Description brève	Description de votre intégration.
      Application	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 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 comporte des entrées à saisir. Les actions de flux de données avec des 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 de flux de données en cliquant sur l’icône d’informations ( ) située en regard de celle-ci. Cliquez sur l’icône pour ouvrir 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 de mappage des données de la table source vers la table 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 les données sont transformées en parallèle et qu’il existe plusieurs enregistrements sources avec une valeur de fusion 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 à gauche de chaque carte de tableau pour faire glisser la carte vers une position différente. 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.

Mappez 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 de mappage des données de la table source vers la table cible, sélectionnez le bouton contenant la table cible vers laquelle vous souhaitez effectuer le mappage.
      La section de mappage de données pour la table s’ouvre. La partie gauche de la page affiche les données sources. Le côté droit est destiné à la table cible.
   2. Utilisez le bouton Ajouter un champ, Ajouter tous les champs ou Mappage automatique pour configurer le côté cible et commencer à mapper les 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 et 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. Le mappage automatique mappe automatiquement les entités sources aux entités cibles portant le même nom. Le bouton Mappage automatique dispose de deux options.
        • Tous les champs correspondants dans la table cible Ajoute tous les champs et mappe 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 que vous n’avez 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, sélectionner Mappage automatique ne modifie pas sa valeur. Un champ automatiquement mappé 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 fait correspondre les entités source aux entités cibles 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 la valeur glide.ih.automap.minimum.score sur 60.

   3. Mappez les données en faisant glisser les 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 pilules ( ) sur le côté droit de la table cible. Vous pouvez saisir plus d’une valeur dans la colonne Valeur, vous pouvez également saisir du texte.

      Après avoir mappé un champ source à un champ cible, une petite icône de coche ( ) apparaît en regard du nom du champ source. Si vous déplacez votre 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 a un champ de 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 l’option Correspondance pour le champ Numéro de commande est activée, le système vérifie si les données correspondent. Si les données sources contiennent un enregistrement portant le même numéro d’ordre, le système met à jour l’enregistrement existant dans la table cible.
      • Si l’option Correspondance pour le champ Numéro de commande est désactivée, le système ne vérifie pas les données correspondantes. Si les données sources ont un enregistrement portant 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 d’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 nouveau 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 tout l’enregistrement dans la table cible.
      4. Sélectionnez Terminé.
   6. Facultatif : Modifiez vos données en appliquant des fonctions de transformation.
      Par exemple, vous pouvez utiliser la fonction de transformation majuscule pour remplacer une chaîne d’entrée par des caractères tout en majuscules. Pour plus d’informations, reportez-vous à la section 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 la fonction de transformation (icône ).
      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 des données

11. Choisissez ce que vous voulez faire de votre 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 future 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 le tableau et assurez-vous qu’il 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 lors 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.