Consultez les connecteurs compatibles avec Application Integration.

Tâche de boucle "For Each"

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.

Avant de commencer

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.

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.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante