Tâche Mappage de données

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

La tâche Mappage de données vous permet d'effectuer des attributions de variables dans votre intégration, d'obtenir et de définir les propriétés des objets JSON, et d'appliquer des fonctions de transformation imbriquées aux valeurs. Ces variables peuvent être des variables d'intégration ou des variables de tâches.

Vous pouvez par exemple attribuer des valeurs de la variable d'intégration X à la variable de tâche Y, ou de la variable de tâche Y à la variable d'intégration X. Pour en savoir plus sur les types de variables, consultez Utiliser des variables dans Apigee Integration.

L'image ci-dessous présente un exemple de mappage de données.

Configurer la tâche Mappage de données

Pour configurer une tâche Mappage de données, procédez comme suit :

1. Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
2. Cliquez sur Développer > Intégrations.
3. Sélectionnez une intégration existante ou cliquez sur Créer une intégration.
4. Dans le concepteur d'intégration, cliquez sur Add a task/trigger > Tasks (Ajouter une tâche/Déclencheur > Tâches) pour afficher la liste des tâches disponibles.
5. Sélectionnez l'élément Mappage de données et faites-le glisser vers le concepteur d'intégration.
6. Cliquez sur l'élément Mappage de données dans le concepteur pour afficher le volet de configuration de la tâche Mappage de données.
7. Cliquez sur Ouvrir l'éditeur de mappage de données pour afficher les valeurs par défaut de la tâche et ajouter un mappage. Pour connaître la procédure détaillée d'ajout d'un mappage, consultez la section Ajouter un mappage.

   L'image suivante montre l'aspect de l'Éditeur de mappage de données : Pour en savoir plus sur l'éditeur de mappage de données, consultez la section Mappage de données dans les intégrations.

   

Ajouter un mappage

Pour ajouter un mappage, procédez comme suit :

1. Dans le volet de configuration de la tâche Mappage des données, cliquez sur Ouvrir l'éditeur de mappage de données.
2. Configurez les champs Entrée et Sortie :
   1. Faites glisser une variable ou son sous-champ de la liste Variables vers le champ Entrée. Vous pouvez cliquer sur  (Développer) pour développer chaque variable figurant dans la liste Variables et afficher les sous-champs disponibles pour cette variable.
   2. Vous pouvez également cliquer sur Variable ou valeur pour ajouter une variable, une valeur initiale ou une fonction dans le champ Entrée.
      • Sélectionnez Variable pour rechercher et utiliser une variable existante. Pour créer une variable, cliquez sur + Ajouter une variable, puis saisissez le nom et le type de données de la nouvelle variable.
      • Sélectionnez Valeur pour saisir une valeur initiale, une valeur littérale ou une valeur de référence de type string, integer, double ou Boolean.
      • Sélectionnez Fonction pour rechercher et utiliser une fonction de base.

        Une fonction de base permet de récupérer ou de générer des valeurs lors de l'exécution d'une intégration. Par exemple, vous pouvez générer un UUID aléatoire ou récupérer la région d'intégration actuelle. Pour en savoir plus sur les fonctions de base compatibles, consultez la page Fonctions de base compatibles.

      • Cliquez sur Enregistrer.
   3. Cliquez sur + (Ajouter une fonction) sur toute variable d'entrée, valeur ou fonction de base dans le champ Entrée afin d'ajouter une fonction de mappage à partir de la liste des fonctions de mappage disponibles.

      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 la variable d'entrée. Cliquez sur + (Ajouter une fonction) dans un paramètre de fonction pour ajouter une fonction imbriquée.

      Pour retirer ou supprimer la dernière fonction ajoutée, cliquez sur - (Supprimer la fonction précédente).

      Pour en savoir plus sur les fonctions de mappage compatibles, consultez la section Types de données et fonctions de mappage compatibles.

   4. Faites glisser une variable de la liste Variables vers le champ Sortie. Si la variable n'est pas disponible, cliquez sur Créer une variable pour configurer le nom et le type de données de la nouvelle variable. Vous pouvez également cliquer sur la variable de sortie et choisir d'utiliser cette variable en tant que sortie de l'intégration ou en tant qu'entrée d'une autre intégration.
3. Pour supprimer une variable, cliquez sur  (Effacer) dans le champ de la variable.
4. Pour supprimer une ligne de mappage, cliquez sur  (Supprimer ce mappage).
5. Fermez l'éditeur de mappage de données une fois le mappage terminé. Toutes les modifications seront enregistrées automatiquement.

Le mappage de données finalisé peut être visualisé dans le volet de configuration de la tâche Mappage de données, comme illustré dans la figure ci-dessous :

Types de données et fonctions de mappage compatibles

Apigee Integration accepte les types de données suivants pour les variables de la tâche Mappage de données :

• Chaînes et tableaux de chaînes
• Entiers et tableaux d'entiers
• Doubles et tableaux de doubles
• Valeurs booléennes et tableaux booléens
• JSON

Le tableau suivant regroupe les fonctions de mappage de données disponibles pour chaque type de données.

Data type	Fonctions de mappage compatibles
Booléen	AND, EQUALS, NAND, NOR, NOT, OR, TO_JSON, TO_STRING, XNOR, XOR
Tableau booléen	APPEND, APPEND_ALL, CONTAINS, FILTER, FOR_EACH, GET, REMOVE, REMOVE_AT, SET, SIZE, TO_JSON, TO_SET
Double	ADD, DIVIDE, CEIL, EQUALS, EXPONENT, GREATER_THAN, GREATER_THAN_EQUAL_TO, FLOOR, LESS_THAN, LESS_THAN_EQUAL_TO, MOD, MULTIPLY, ROUND, SUBTRACT, TO_JSON, TO_STRING
Double tableau	APPEND, APPEND_ALL, AVG, CONTAINS, FILTER, FOR_EACH, GET, MAX, MIN, REMOVE, REMOVE_AT, SET, SIZE, SUM, TO_JSON, TO_SET
Integer	ADD, DIVIDE, EPOCH_TO_HUMAN_READABLE_TIME, EQUALS, EXPONENT, GREATER_THAN, GREATER_THAN_EQUAL_TO, LESS_THAN, LESS_THAN_EQUAL_TO, MOD, MULTIPLY, SUBTRACT, TO_DOUBLE, TO_JSON, TO_STRING
Tableau d'entiers	APPEND, APPEND_ALL, AVG, CONTAINS, FILTER, FOR_EACH, GET, MAX, MIN, REMOVE, REMOVE_AT, SET, SIZE, SUM, TO_JSON, TO_SET
JSON	APPEND_ELEMENT, FLATTEN, FILTER, FOR_EACH, GET_ELEMENT, GET_PROPERTY, MERGE, REMOVE_PROPERTY, RESOLVE_TEMPLATE, SET_PROPERTY, SIZE, TO_BOOLEAN, TO_BOOLEAN_ARRAY, TO_DOUBLE, TO_DOUBLE_ARRAY, TO_INT, TO_INT_ARRAY, TO_STRING, TO_STRING_ARRAY
String	CONCAT, CONTAINS, EQUALS, EQUALS_IGNORE_CASE, LENGTH, REPLACE_ALL, RESOLVE_TEMPLATE, SPLIT, SUBSTRING, TO_BASE_64, TO_BOOLEAN, TO_DOUBLE, TO_INT, TO_JSON, TO_LOWERCASE, TO_UPPERCASE
Tableau de chaînes.	APPEND, APPEND_ALL, CONTAINS, FILTER, FOR_EACH, GET, REMOVE, REMOVE_AT, SET, SIZE, TO_JSON, TO_SET

Pour en savoir plus sur chacune des fonctions de mappage de données, consultez la documentation de référence sur les fonctions de mappage de données.

Fonctions de base compatibles

Le tableau suivant répertorie les fonctions de base de mappage de données disponibles :

Data type	Fonctions de base compatibles
Integer	NOW_IN_MILLIS
Tableau d'entiers	INT_LIST
String	GENERATE_UUID, GET_EXECUTION_ID, GET_INTEGRATION_NAME, GET_INTEGRATION_REGION, GET_PROJECT_ID

Pour en savoir plus sur chacune des fonctions de mappage de données de base, consultez la documentation de référence sur les fonctions de mappage de données.

Réessayer après échec

Vous pouvez configurer différentes stratégies de nouvelle tentative pour gérer les erreurs dans une tâche. Les stratégies de nouvelle tentative vous permettent de spécifier comment réexécuter la tâche en cas d'erreur. Pour en savoir plus, consultez la section Stratégies de traitement des erreurs.

Bonnes pratiques

La tâche Mappage de données peut être un moyen efficace de transformer et de transmettre des variables clés à diverses tâches de votre intégration. Voici quelques conseils à prendre en compte lorsque vous créez votre intégration :

• Les mappages 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.
• Sur chaque ligne, le type de données du champ Entrée doit correspondre au type de données du champ Sortie. Pour caster des données entre différents types, utilisez des fonctions de transformation telles que TO_STRING et TO_INT.
• Il n'existe aucune limitation quant à la longueur du chaînage de transformation. Toutefois, le débogage de longues transformations en chaîne peut s'avérer difficile. Nous vous recommandons de conserver les transformations d'entrée lisibles et de diviser les transformations complexes en plusieurs mappages.
• Si un mappage nécessite une valeur de remplacement, définissez une valeur de remplacement pour le mappage. Si vous ne fournissez pas de valeur de remplacement, le mappage renvoie une erreur lorsque la valeur d'entrée ou la transformation renvoie null.
• Lorsque vous supprimez une variable, veillez à supprimer tous les mappages qui la contiennent.