Mappage de données dans les intégrations

Vous consultez la documentation d'Apigee X.
Consultez la documentation d'Apigee Edge.

La tâche Mappage de données vous permet d'attribuer des variables dans votre intégration Apigee. Vous pouvez utiliser les fonctions de mappage de données pour transformer davantage les données en variables pertinentes afin de les rendre accessibles pour d'autres tâches ou déclencheurs dans votre intégration.

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

  • Définir le mappage des variables pour une ou plusieurs variables imbriquées
  • Transformer les variables d'un type de données en un autre type de données

Un exemple de mappage de données est illustré dans la figure ci-dessous :

image de la palette de l'éditeur de mappage de données

Pour en savoir plus sur la tâche Mappage de données, consultez la documentation de référence sur la tâche de mappage de données.

Éditeur de mappage de données

La tâche Mappage de données fournit un éditeur de mappage de données permettant de mapper les variables. L'éditeur comporte des colonnes qui fournissent un aperçu visuel de l'utilisation des éléments suivants dans le mappage :

  • Entrée : variable source transmise aux exécuteurs d'intégration. Vous pouvez spécifier une valeur littérale ou sélectionner une variable de référence. Pour ajouter une variable d'entrée au mappage de données, cliquez sur une variable dans la liste des variables disponibles et faites-la glisser dans la colonne Variables adjacente. Cliquez sur Ajouter + pour configurer une nouvelle variable.
  • Sortie : variable cible correspondante renvoyée aux exécuteurs d'intégration. Pour ajouter une variable de sortie, cliquez sur une variable dans la liste des variables disponibles et faites-la glisser dans la colonne Variables adjacente. Cliquez sur Ajouter + pour configurer une nouvelle variable.
  • Variables : entrées et sorties disponibles pour l'intégration. Si aucune variable n'est répertoriée, cliquez sur Ajouter + pour configurer une nouvelle variable. Un champ Rechercher est disponible en haut de chaque colonne de variables.
L'image suivante montre la mise en page de l'éditeur de mappage de données :

image montrant un éditeur de mappage de données

Ordre de mappage

Les mappages spécifiés dans l'éditeur de mappage de données sont exécutés en séquence, de haut en bas. En d'autres termes, si la variable d'entrée A est mappée à une variable de sortie B de la première ligne, la variable B est disponible pour le mappage dans les lignes suivantes.

Exemples de mappage de données

Les images suivantes montrent des exemples de mappages dans l'éditeur de mappage de données :

Mappage des variables de chaîne

image montrant le mappage de données de variables de chaîne

Mappage des variables entières et doubles

image montrant le mappage des données de variables entières et doubles

Mappage de variables JSON, de chaîne et d'entier

image montrant le mappage de données de variables JSON, de chaîne et d'entier