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 :
- Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
- Cliquez sur Développer > Intégrations.
- Sélectionnez une intégration existante ou cliquez sur Créer une intégration.
- 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.
- Sélectionnez l'élément Mappage de données et faites-le glisser vers le concepteur d'intégration.
- 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.
-
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 :
- Dans le volet de configuration de la tâche Mappage des données, cliquez sur Ouvrir l'éditeur de mappage de données.
- Configurez les champs Entrée et Sortie :
- 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.
- 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
ouBoolean
. - 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.
- 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.
- 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.
- Pour supprimer une variable, cliquez sur (Effacer) dans le champ de la variable.
- Pour supprimer une ligne de mappage, cliquez sur (Supprimer ce mappage).
- 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
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 |
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 sortieB
de la première ligne, la variableB
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
etTO_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.