Consultez les connecteurs compatibles avec Application Integration.

Tâche boucle "while"

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).

Avant de commencer

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) 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 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.

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.

Quotas et limites

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

Étape suivante