Comprendre les arêtes et les conditions de périphérie

Annonce : Application Integration est désormais disponible pour votre projet Google Cloud. Vous pouvez désormais utiliser Apigee Integration et Application Integration dans le même projet Google Cloud. En savoir plus

En périphérie

Une arête est une connexion entre deux éléments d'une intégration. La connexion indique la direction du flux de contrôle d'un élément (tâche ou déclencheur) à un autre. La connexion peut être établie entre un déclencheur et une tâche, ou entre une tâche et une autre tâche. En utilisant une arête avec une duplication et une jointure, vous pouvez implémenter des ramifications et des conditions complexes dans votre intégration. Pour plus d'informations, consultez la section Duplications et jointures.

Par exemple, si il y a une arête d'une tâche Envoyer un e-mail à une tâche d'appel d'intégration, cela signifie qu'après l'exécution de la tâche Envoyer un e-mail, la tâche suivante à exécuter est la tâche appel d'intégration. Une arête prend également en charge les vérifications conditionnelles. Avant que la commande ne passe à la tâche suivante, vous pouvez rechercher une condition dans l'arête et, en fonction du résultat, décider d'exécuter la tâche ou non. Pour en savoir plus sur les vérifications conditionnelles compatibles, consultez la section Conditions de périphérie.

Conditions de périphérie

Les conditions de périphérie vous permettent de spécifier les conditions à remplir pour que le contrôle d'une intégration soit transmis à la tâche connectée par l'arête. La tâche n'est exécutée que si les conditions spécifiées sont remplies. Les conditions de périphérie sont utiles dans les cas où il existe plusieurs arêtes entrantes dans une tâche, chaque arête vérifiant les conditions spécifiques avant d'exécuter la tâche.

Spécifiez les conditions de périphérie en procédant 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 créez-en une en cliquant sur Créer une intégration.

   Si vous créez une intégration :

   1. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
   2. Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
   3. Cliquez sur Créer.

   La page de conception d'intégration s'affiche.

4. Dans la barre de navigation de la page de conception d'intégration, cliquez sur +Ajouter une tâche ou un déclencheur > Tâches pour afficher la liste des tâches disponibles.
5. Sélectionnez une intégration existante ou créez-en une.
6. Dans l'éditeur d'intégrations, cliquez sur l'arête pour ouvrir le volet de configuration d'arête.
7. Configurez l'arête :
   • Libellé (facultatif) : ajoutez un nom personnalisé à la périphérie.
   • Condition : définissez une condition de périphérie à l'aide des opérateurs et des fonctions compatibles.

Conseils importants concernant la spécification des conditions :

• Pour référencer une valeur de variable, utilisez la notation en dollars ($) avant et après le nom de la variable. Par exemple, si vous souhaitez vérifier si une variable productId est supérieure à 10, la syntaxe est $productId$ > 10.
• Le texte sans notation en dollars est interprété comme une valeur littérale. Par exemple, le texte customerId est interprété comme une valeur littérale.
• Pour vérifier plusieurs conditions, divisez-les en vérifications individuelles et combinez-les à l'aide de AND ou de OR. Par exemple, au lieu d'utiliser $productId$ > 5 AND < 9 , utilisez $productId$ > 5 AND $productId$ < 9.

Opérateurs compatibles

Le tableau suivant décrit les opérateurs compatibles pouvant être utilisés dans des conditions de périphérie.

Opérateur	Description	Exemple
=	Vérifie l'égalité entre deux valeurs.	$var$ = 'value'
!=	Vérifie l'inégalité entre deux valeurs.	$var$ != 'value'
<	Vérifie si une valeur est inférieure à une autre.	5 < 10
<=	Vérifie si une valeur est inférieure ou égale à une autre valeur.	$var$ <= 5
>	Vérifie si une valeur est supérieure à une autre.	1 > 0
>=	Vérifie si une valeur est supérieure ou égale à une autre valeur.	$var$ >= 0
:	Vérifie si une chaîne contient une sous-chaîne ou si une liste contient une valeur primitive spécifique.	$longString$ : "substring" $list of values$ : 'value'
"AND"	Vérifie deux expressions et renvoie la valeur "true" si les deux expressions renvoient la valeur "true".	$a$ > $b$ AND $b$ < $c$
OU	Vérifie deux expressions et renvoie la valeur "true" si l'une des expressions renvoie la valeur true.	$a$ > $b$ OR $b$ < $c$
NOT	Opérateur de négation. Inverse le résultat d'une expression.	NOT($var$ = "value")

Fonctions compatibles

Le tableau suivant décrit les fonctions compatibles qui peuvent être utilisées dans des conditions périphériques.

Fonction	Description
exists(VARIABLE)	Vérifie si une variable donnée existe.
does_not_exist(VARIABLE)	Vérifie si une variable donnée n'existe pas.
is_empty(VARIABLE)	Vérifie si une variable donnée est une liste ET est vide.
is_not_empty(VARIABLE)	Vérifie si une variable donnée est une liste ET n'est pas vide.