Créer une intégration de données

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 8 minutes de lecture

    • 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 Centre 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, sn_app_eng_studio.admin ou delegated_developer. Pour plus d'informations, consultez Déléguer des développeurs à l’aide de AES.

    Procédure

    1. Accédez à la Tous > 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 ( Ajouter une icône).
    4. Sélectionnez Créer une intégration de données.
    Configurer votre source d’importation de données
    1. Configurez votre source d’importation de données en effectuant les étapes suivantes.
      1. Renseignez les champs de 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 Téléchargement de fichiers, 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 classé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, voir 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 d’informations) située en regard de celle-ci. Cliquez sur l’icône pour ouvrir la configuration de l’action Flux de données.
    2. Sélectionnez le bouton Enregistrer .
    Choisissez votre table cible et configurez les options d’importation.
    1. Sélectionnez l’onglet Mapper vers la cible .
    2. Sélectionnez la table cible et les options de 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 vos données sont transformé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 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, consultez 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 Faire glisser l’icôneà 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à dans l’intégration.
    Mapper les champs d’importation à votre table cible
    1. Mappez les champs de votre importation vers la table cible en effectuant les actions suivantes.
      Figure 1. Mappage des données à la table cible
      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.
        La section de mappage de données de la table s’ouvre. 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 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 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 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 de Mappage automatique ne change pas sa valeur. Un champ mappé automatiquement présente une icône de baguette sur sa pastille de données.

          Par défaut, 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 de la source à la 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 glide.ih.automap.minimum.score sur 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 pastilles ( icône de sélection de pilules) sur le côté droit de la table cible. Vous pouvez saisir plusieurs valeurs dans la colonne Valeur, vous pouvez également saisir du texte.

        Une fois que vous avez mappé un champ source à un champ cible, une petite coche s’affiche en regard du nom du champ source. Si vous placez le curseur sur la coche, l’info-bulle répertorie les champs cibles vers lesquels 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 Numéro de commande et un enregistrement avec un numéro de commande de 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 a deux enregistrements, tous deux avec un numéro de commande 743.
      5. Facultatif : Pour les champs de choix et de référence, spécifiez la colonne vers laquelle mapper les données.
        1. Sélectionnez l’icône Engrenage (icône Engrenage).
        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 : Changez ou modifiez vos données en appliquant des fonctions de transformation.
        Par exemple, vous pouvez utiliser la fonction de transformation majuscules pour remplacer une chaîne d’entrée par des caractères tout en majuscules. Pour plus d’informations, voir Fonctions de transformation.
        Remarque :
        Les fonctions de transformation disponibles lors de la création de flux et de flux secondaires ne sont pas toutes disponibles dans Centre d'intégration : importer.
        1. Sélectionnez l’icône de fonction de transformation (icône de fonction de transformation).
        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é.
    2. Lorsque vous avez terminé votre mappage, cliquez sur Enregistrer.
    Importer le fichier ou planifier l’importation de données
    1. Choisissez ce qui doit advenir 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.
    2. 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.
    3. 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.