Tâche boucle "while"

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

La tâche Boucle "while" permet d'effectuer des appels répétés à une sous-intégration à partir de votre intégration principale jusqu'à ce qu'une condition spécifiée soit remplie.

L'ID de déclencheur d'API et le nom de l'intégration identifient la sous-intégration que vous souhaitez exécuter.

La tâche vous permet également de collecter la réponse de chaque exécution de sous-intégration et de stocker la valeur dans votre intégration actuelle à utiliser dans les tâches en aval. Vous pouvez utiliser l'une des approches suivantes pour recueillir les réponses :

• Rassemblez les réponses obtenues à chaque exécution dans une variable de tableau, où chaque élément du tableau contient la réponse obtenue pour une exécution spécifique. Pour rassembler les réponses, configurez la propriété Collect values from sub-integration output(s).
• Rassemblez les réponses de toutes les exécutions dans une seule variable. Pour agréger les réponses, configurez la propriété Override values from sub-integration output(s).

Remarque :

• La tâche Boucle "while" peut exécuter 8 000 itérations au maximum. Cette contrainte s'applique même si la condition configurée génère une boucle infinie.
• La taille cumulée des données collectées pour chaque exécution de sous-intégration ne peut pas dépasser 50 MB. Si la taille dépasse 50 MB, l'intégration échoue et les tâches en aval ne sont pas exécutées.

Avant de commencer

• Assurez-vous d'avoir associé un compte de service géré par l'utilisateur à votre intégration. Si aucun compte de service géré par l'utilisateur n'est configuré pour l'intégration, le compte de service par défaut ([e-mail]) est utilisé par défaut pour l'authentification.
• Assurez-vous que votre compte de service dispose du rôle IAM Demandeur Application Integration. Pour en savoir plus sur l'attribution d'un rôle à un compte de service, consultez la page Gérer l'accès aux comptes de service.

Propriétés de configuration

Le tableau suivant décrit les propriétés de configuration de la tâche Boucle "while".

Property (Propriété)	Type de données	Description
API Trigger ID	Chaîne	ID du déclencheur de la sous-intégration à exécuter. Cette valeur est disponible dans le champ ID du déclencheur du déclencheur d'API dans la sous-intégration.
Integration name	Chaîne	Nom de la sous-intégration à exécuter.
While loop condition	Non disponible	Condition pour arrêter la boucle. La sous-intégration s'exécute jusqu'à ce que la condition soit satisfaite. Par exemple, $loopMetadata.current_iteration_count$< 10.
Map to sub-integration input(s)	N/A	Valeurs à transmettre de l'intégration actuelle à la sous-intégration. Les valeurs de cette propriété se présentent sous la forme de paires clé/valeur, où la clé est une variable de l'intégration actuelle et la valeur est la variable d'entrée correspondante dans la sous-intégration. Par exemple, supposons que votre intégration principale possède la variable productID, que vous souhaitez mapper avec la sous-variable d'intégration subIntProductID. Vous devez sélectionner productID dans la liste déroulante Variable d'intégration à mapper et saisir subIntProductID dans le champ Entrée de sous-intégration vers laquelle mapper.
Collect values from sub-integration output(s)	Non disponible	Rassemblez les résultats des exécutions de la sous-intégration. À chaque exécution de la sous-intégration, vous pouvez stocker le résultat de la sous-intégration dans une variable de tableau de l'intégration actuelle. Saisissez la variable de sortie de la sous-intégration dans le champ Sortie de la sous-intégration à collecter, puis sélectionnez la variable de tableau de l'intégration actuelle dans la liste déroulante Variable d'intégration à collecter. Chaque élément du tableau contient la réponse d'une exécution de sous-intégration particulière. Par exemple, si la variable de tableau est resultsArray, resultsArray[0] contient la réponse de la première exécution et resultsArray[1] contient la réponse de la deuxième exécution.
Override values from sub-integration output(s)	Non disponible	Lisez la variable de sortie d'une exécution de sous-intégration et stockez-la dans une variable de l'intégration actuelle. Sélectionnez la variable de sortie de la sous-intégration dans la liste déroulante Sortie de la sous-intégration à mapper, puis sélectionnez la variable correspondante de l'intégration actuelle dans la liste déroulante Variable d'intégration à remplacer. Vous pouvez envoyer la variable remplacée dans l'intégration actuelle vers la prochaine exécution de sous-intégration en mappant la variable dans la propriété Mapper à d'autres entrées de sous-intégration. Par conséquent, vous pouvez agréger de manière cumulative les réponses des exécutions de sous-intégration.
Loop metadata	Tableau JSON	La variable de sortie contenant les détails de l'exécution de la sous-intégration s'exécute comme l'ID d'exécution, les messages d'erreur et les valeurs des variables de la sous-intégration transmises lors de l'exécution. Les métadonnées de boucle contiennent des variables, y compris les variables de sortie suivantes : current_iteration_count, sub_integration_execution_ids, failure_location, current_element, iteration_element et failure_message. Avertissement : Dans les métadonnées de la boucle, vous trouverez des clés en double pour la variable de sortie (par exemple, Current Iteration Count et current_iteration_count). Nous vous recommandons d'utiliser les variables contenant le trait de soulignement (_), car les autres clés vont être abandonnées.

Bonnes pratiques

Pour plus d'informations sur les limites d'utilisation qui s'appliquent à la tâche Boucle "while", consultez la section Limites d'utilisation.

Stratégie de traitement des erreurs

Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.