Consultez la liste des connecteurs compatibles avec Application Integration.

Présentation du mappage des données

Cette page fournit une présentation générale du mappage de données et des différentes façons de le faire dans Application Integration.

Les données d'entreprise peuvent résider dans différents formats et sources, ce qui rend leur intégration dans un modèle de données ou un pipeline de données unifié extrêmement difficile. Le mappage de données est le processus d'extraction et de standardisation des données provenant de plusieurs sources afin d'établir une relation entre elles et les champs de données cibles associés dans la destination. Voici quelques exemples d'utilisation du mappage de données dans une intégration :

  • Extraire des champs d'une structure de données complexe telle qu'un fichier JSON.
  • Mapper la source de données au schéma cible.
  • Transformer des données en appliquant des fonctions de transformation.
  • Générer des valeurs de sortie et les stocker/les utiliser en tant que variables d'intégration.

Application Integration vous permet de mapper des données en effectuant les tâches suivantes:

Tâche Data Transformer Script

La tâche Script Data Transformer est une fonctionnalité de mappage de données basée sur un moteur de modèles disponible dans Application Integration. Elle utilise le langage de configuration Jsonnet de Google pour créer et modifier des modèles Jsonnet qui définissent les relations de mappage pour les variables d'intégration source et cible spécifiées dans votre intégration.

L'éditeur de Data Transformer Script et les fonctions de Data Transformer compatibles vous permettent d'écrire une logique de mappage de données personnalisée, d'effectuer des attributions de variables et d'ajouter ou de modifier des variables d'intégration.

L'image suivante montre l'exemple de mise en page de l'éditeur de Data Transformer Script :

Image montrant l'éditeur de Data Transformer Script Image montrant l'éditeur de Data Transformer Script

Pour en savoir plus sur l'ajout et la configuration de la tâche Data Transformer Script, consultez la page Tâche Data Transformer Script.

Tâche Mappage de données

La tâche Mappage de données est une fonctionnalité sans code d'Application Integration, qui nécessite peu de code. Elle fournit un canevas de mappage visuel (éditeur de mappage de données) permettant d'attribuer et de mapper des données dans vos intégrations. En outre, vous pouvez également utiliser les fonctions de mappage compatibles pour transformer vos données en variables/formats significatifs pour les rendre accessibles aux autres tâches ou déclencheurs de votre intégration.

Avec la tâche Mappage de données, vous pouvez effectuer les tâches suivantes :

  • L'éditeur de Mappage de données vous permet de visualiser et de définir un mappage de variables pour une ou plusieurs variables imbriquées.
  • Transformer les variables d'un type de données en un autre type de données La tâche Mappage de données vous permet d'appliquer plusieurs fonctions de mappage (y compris des fonctions imbriquées) pour transformer les données de variables.
Pour en savoir plus sur l'ajout et la configuration de la tâche Mappage de données, consultez la section Tâche Mappage de données.

Éditeur et mise en page de Mappage de données

L'éditeur de Mappage de données fournit un canevas visuel contenant les éléments d'intégration suivants :

  • Volet Variables : affiche les différents types de variables qui sont disponibles pour l'intégration :
    • Entrées. Variables d'entrée de l'intégration.
    • Sorties. Variables de sortie de l'intégration.
    • Variables locales. Variables existant dans le champ d'application de l'intégration.

    Si aucune variable n'est répertoriée, cliquez sur Ajouter + pour configurer une nouvelle variable.

    Cliquez sur  (Développer) pour développer chaque variable et afficher les sous-champs associés disponibles. Pour rechercher une variable ou l'un de ses sous-champ dans la liste des variables disponibles, cliquez sur  (Rechercher des variables).

    Pour en savoir plus sur les variables dans Application Integration, consultez la page Utiliser des variables dans Application Integration.

  • Colonne Entrée : affiche les lignes de mappage d'entrée contenant la source de l'entrée de mappage de données. La source peut être une valeur littérale, une fonction de base ou une variable d'entrée, avec des fonctions de mappage. Cliquez sur Variable ou Valeur sur une ligne de mappage d'entrée pour ajouter une source.
  • Colonne Sortie : affiche les lignes de mappage de sortie contenant les variables cibles associées pour la ligne de mappage d'entrée correspondante. Les variables cibles peuvent être utilisées pour le mappage dans les lignes d'entrée suivantes. Pour attribuer une variable de sortie, vous pouvez soit créer une variable de sortie, soit faire glisser une variable de sortie existante directement depuis la colonne Variables.
L'image suivante présente un exemple de mise en page de l'éditeur de Mappage de données :

image montrant un éditeur de mappage de données image montrant un éditeur de mappage de données

Fonctions de mappage

La tâche Mappage de données fournit diverses fonctions de mappage prédéfinies pour transformer et standardiser les données de mappage dans votre intégration. Une fonction de mappage peut avoir un ou plusieurs paramètres d'entrée, où chaque paramètre peut contenir une valeur littérale, une variable ou une fonction de base à laquelle les fonctions de mappage sont appliquées. Vous pouvez utiliser plusieurs fonctions de mappage pour une seule source d'entrée, formant ainsi une expression de transformation de mappage.

Le type de données de fin d'une source d'entrée est basé sur le type renvoyé de l'expression de transformation définie dans la ligne d'entrée de mappage de données correspondante. L'éditeur de Mappage de données affiche une erreur de validation sous la ligne d'entrée de mappage de données correspondante si le type renvoyé de la source d'entrée ne correspond pas au type renvoyé de la variable cible de mappage de sortie correspondante.

Expression de transformation

Une expression de transformation est une combinaison de plusieurs fonctions de mappage qui sont enchaînées en série ou dans une structure imbriquée. L'éditeur de Mappage de données vous permet d'insérer, de modifier ou de supprimer facilement une fonction ou un paramètre de fonction dans une expression de transformation définie. Si l'expression de transformation définie n'est pas valide, l'éditeur de Mappage de données affiche une erreur de validation à côté de la fonction ou du paramètre de fonction correspondant qui est à l'origine de l'erreur dans l'expression. Pour afficher le message d'erreur complet, maintenez le pointeur de la souris sur l'icône d'erreur de validation .

L'image suivante montre un exemple de mappage avec des erreurs de validation dans l'éditeur de Mappage de données :

Image montrant une erreur de validation du mappage de données Image montrant une erreur de validation du mappage de données

Pour en savoir plus sur la configuration d'un mappage dans une tâche de mappage de données, consultez Ajouter un mappage.

Pour en savoir plus sur les fonctions de mappage prédéfinies compatibles avec Application Integration, consultez la section Types de données et fonctions de mappage compatibles.

Ordre de mappage

Les mappages spécifiés dans l'éditeur de Mappage de données sont exécutés dans l'ordre, de haut en bas. Par exemple, dans l'image précédente, Num1 est mappé sur Num1ToInt dans la première ligne, ce qui permet de mapper Num1ToInt dans les lignes suivantes.

Étapes suivantes