Loop

Le node Loop répète une séquence de nodes pour chaque élément d'une liste en entrée, permettant le traitement en lot sur des tableaux.

À quoi sert le node Loop ?

Le node Loop (libellé : Loop Node) parcourt une liste et exécute la branche aval une fois par élément. C’est un node de contrôle de flux : connectez une liste à son entrée, branchez le sous-workflow par itération sur sa sortie Start loop, et récupérez les résultats agrégés sur sa sortie Output (merged data) une fois la boucle terminée.

Cas d’usage typiques :

• Scraper une liste d’URL provenant de Google Sheets, d’une API ou d’une liste manuelle.
• Parcourir des lignes de feuille de calcul pour les enrichir, les transformer ou les envoyer une à une.
• Appliquer un prompt LLM à chaque entrée d’un tableau (titres, descriptions, produits).
• Démultiplier un appel d’intégration (HubSpot, BigQuery, WordPress) sur un lot d’enregistrements.

Configuration rapide

Suivez ces étapes pour ajouter et configurer le node Loop dans votre workflow :

Paramètres de configuration

Le node Loop dispose d’une liste d’entrée, de trois paramètres de configuration et de deux sorties. Les réglages sont validés par le formulaire : les valeurs invalides sont refusées avant l’enregistrement.

Champs requis

Champs optionnels

Que renvoie le node ?

Le node Loop expose deux ports de sortie. Connectez chacun à la branche aval appropriée.

Comment récupérer l’output ?

Dans Draft & Goal, vous n’avez pas besoin de chercher un nom de variable complexe généré par le système. Pour exploiter le résultat :

1. Tirez un lien depuis le port Output (merged data) du node Loop.
2. Connectez-le à l’entrée du node suivant (Filter List, JSON Path Extractor, Sheets Writer, etc.).
3. Dans ce node suivant, créez et nommez votre propre variable (par exemple, loop_results). Le tableau agrégé y sera automatiquement injecté.

Exemples d’utilisation

Cas 1 : Scraper une liste d’URL depuis Google Sheets

Vous lisez une liste d’URL dans une Google Sheet, scrapez chaque page, puis réécrivez le contenu nettoyé dans une feuille.

graph LR
    A[Google Sheets reader] --> B[Loop Node]
    B --> C[Web Scraper]
    C --> D[HTML Cleaner]
    D --> E[Sheets writer]
    B --> E

Configuration :

• List = {{GoogleSheets_0.data}}
• Max Iterations = 100
• Delay between iterations = 2000 (2 secondes, scraping respectueux)
• Error Handling = Skip

Dans la branche de boucle :

• URL du Web Scraper = {{Loop_0.currentItem.url}}

Cas 2 : Envoyer un e-mail personnalisé à chaque contact

Vous itérez sur une liste de contacts, générez un message personnalisé avec un LLM, puis l’envoyez via le node Email Sender. Un destinataire en échec ne doit pas bloquer le reste.

graph LR
    A[Create List of contacts] --> B[Loop Node]
    B --> C[LLM personalize]
    C --> D[Email Sender]
    B --> E[Log results]

Configuration :

• List = {{CreateList_0.list}}
• Max Iterations = 100
• Delay between iterations = 1000
• Error Handling = Skip

Dans la branche de boucle :

• Variable du prompt LLM = {{Loop_0.currentItem.name}}
• Champ to de l’Email Sender = {{Loop_0.currentItem.email}}

Problèmes courants

Le workflow échoue avec : Loop node does not have a valid input list

Cause : La valeur connectée à List ne peut pas être parsée comme un tableau JSON. Le node amont a envoyé une chaîne, un objet, ou un payload vide / null.

Solution : Vérifiez que la sortie amont est bien un tableau JSON. Encadrez une valeur manuelle avec ["..."]. Pour Google Sheets, pointez sur le tableau data des lignes. Pour une réponse d’API, ciblez le champ qui contient réellement la liste (par exemple body.results).

Seuls les 100 premiers éléments sont traités

Cause : Max Iterations est plafonné à 100 par le formulaire de paramètres. Toute liste de plus de 100 éléments est tronquée.

Solution : Découpez l’entrée en amont avec le node Split List en lots de 100 éléments maximum, puis chaînez plusieurs Loop. Pour des jeux de données très volumineux, paginez en amont (pagination Sheets, pagination API) et lancez le workflow par lot.

La boucle est trop lente / met plusieurs minutes pour une petite liste

Cause : Delay between iterations est élevé, ou la branche par itération contient des nodes lents (LLM, scraping).

Solution : Abaissez le délai à son minimum (100 ms) si aucune contrainte de rate limiting externe ne s’applique. Profilez la branche interne et supprimez ou mettez en cache les étapes lentes lorsque c’est possible.

Une itération échoue et arrête tout le workflow

Cause : Error Handling est positionné sur None. La première erreur interrompt la boucle et fait échouer l’exécution.

Solution : Passez Error Handling à Skip & Continue pour que l’exécution survive aux échecs individuels. Ajoutez un node Conditional dans la branche pour journaliser ou router les éléments en échec.

La sortie agrégée est vide alors que la boucle s'est exécutée

Cause : La branche interne n’a produit aucune sortie, ou toutes les itérations ont été ignorées suite à des erreurs.

Solution : Ouvrez l’historique d’exécution, inspectez chaque itération, confirmez que les nodes internes renvoient bien des données. Basculez temporairement Error Handling sur None pour faire remonter l’erreur sous-jacente.

Bonnes pratiques et pièges à éviter

Comment s’intègre-t-il dans un workflow ?

Le node Loop se place entre un node producteur de liste et une branche de traitement par élément, puis ré-agrège les résultats en aval. Schéma typique :

graph LR
    Source[Google Sheets / API / Create List] --> Loop[Loop Node]
    Loop -->|Start loop| Inner[Branche par élément
<br/>scrape / LLM / écriture]
    Loop -->|Output merged data| After[Agrégateur
<br/>Filter / JSON Path / Sheets]

Nodes complémentaires