Boucle sur les éléments

Exécute les nœuds en aval pour chaque élément, puis continue sur Terminé

Utilisation et spécificités

Utilisez ce nœud pour exécuter une action par élément ou par lot. La sortie Boucle porte le traitement répété ; la sortie Terminé continue une fois tous les éléments traités.

Avec ce payload manuel :

{
  "contacts": [
    { "email": "[email protected]" },
    { "email": "[email protected]" }
  ]
}

1. Renseignez Éléments à parcourir (source) avec input.contacts et Éléments par itération avec 1.
2. Reliez Boucle à Modifier les champs, activez Champs mappés uniquement et créez email avec {{ nodes.loop1.item.email }}. Remplacez loop1 par le nom technique proposé dans votre mapping.
3. Reliez Terminé au traitement qui doit avoir lieu après tous les contacts. Un retour du dernier nœud du corps vers la boucle est possible ; le moteur gère les itérations.

Pendant chaque tour, la sortie de boucle fournit item, items, index (à partir de zéro), total et batchSize. Pour cet exemple, item est successivement le contact Ada puis le contact Lin. input.contacts reste la liste initiale : ce n’est pas l’élément courant.

Sur Terminé, la sortie contient les résultats collectés dans items et leur nombre dans count. Avec le nœud de préparation décrit ci-dessus, attendez :

{
  "items": [
    { "email": "[email protected]" },
    { "email": "[email protected]" }
  ],
  "count": 2
}

Les résultats viennent de la sortie collectée à la fin de chaque tour, pas automatiquement des éléments d’origine. Avec un lot contenant plusieurs éléments, item devient une liste ; la dernière tranche peut ne contenir qu’un élément. Si une action attend un contact unique, gardez batchSize: 1.

Type technique : loop_over_items. Runtime : nodulz.

Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le guide des identifiants si une source distante ou une cible d’exécution nécessite un accès.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Aide de configuration

source
Éléments à parcourir

Reliez la sortie Boucle aux nœuds à exécuter pour chaque élément. Vous pouvez reconnecter le dernier nœud à celui-ci (comme n8n). Une fois terminé, l'exécution continue sur Terminé avec toutes les sorties.

batchSize
Éléments par itération

Nombre d'éléments traités par tour de boucle (1 = un par un).

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

{
  "source": "",
  "batchSize": 1
}

Vérification

Exécutez le workflow complet avec les deux contacts et vérifiez que chacun apparaît une fois dans les résultats. Testez ensuite une liste vide : le corps ne doit pas s’exécuter et la branche Terminé doit rester accessible. Vérifiez la sortie finale après la boucle, où item est remplacé par la collection de résultats.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.