Tâche de boucle "For Each"

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 "for each" permet d'effectuer des appels répétés à une sous-intégration à partir de votre intégration principale. La tâche effectue une itération sur la variable de tableau configurée et appelle la sous-intégration pour chaque élément du tableau. Le nombre d'appels de la sous-intégration est égal à la taille de la variable de tableau.

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é Response parameter override mapping.

Remarque :

• Une tâche Boucle "for each" peut exécuter un maximum de 8 000 itérations.
• 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.
• Si une intégration dans la tâche Boucle "for each" échoue, l'intégralité de la tâche échoue et les tâches en aval ne sont pas exécutées. Pour éviter l'échec de l'intégration complète, vous pouvez spécifier une stratégie d'exécution pour la tâche dans son volet de configuration de jointure. Pour en savoir plus, consultez la page Rejoindre.

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 Pour chaque boucle.

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.
List to iterate	Tableau de type "Booléen", "Chaîne", "Entier", "Double" ou JSON.	Liste des valeurs pour lesquelles les sous-intégrations doivent être exécutées. La sous-intégration s'exécute pour chaque valeur de la liste, les unes après les autres. Vous pouvez transmettre la valeur itérée à la sous-intégration en définissant la propriété Mappage de sous-intégration d'éléments d'itération. Dans cette propriété, spécifiez la variable de la sous-intégration avec laquelle la valeur itérée doit être mappée.
Iteration element sub-integration mapping	ND	Variable dans la sous-intégration à laquelle l'élément itéré actuel doit être attribué.
Map to additional sub-integration input(s)	ND	Valeurs supplémentaires à 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 subIntProductID dans la liste déroulante Entrée de sous-intégration vers laquelle mapper.
Collect values from sub-integration output(s)	ND	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. Sélectionnez la variable de sortie de la sous-intégration dans la liste déroulante Sortie de 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 dans laquelle collecter des données. 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.
Response parameter override mapping	ND	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 des sous-intégrations, telles que l'ID d'exécution, les messages d'erreur et les valeurs de variable 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 "For Each", 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.