# Boucle sur les éléments - Nœud de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/loop_over_items

Language: fr

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 :

```json
{
  "contacts": [
    { "email": "ada@example.test" },
    { "email": "lin@example.test" }
  ]
}
```

1. Renseignez **Éléments à parcourir** (`source`) avec `input.contacts` et **Éléments par itération** avec `1`.
2. Reliez **Boucle** à [Modifier les champs](/docs/nodes/set), 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 :

```json
{
  "items": [
    { "email": "ada@example.test" },
    { "email": "lin@example.test" }
  ],
  "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](/docs/credentials) 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é.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `source` | `string` | `""` | - |
| `batchSize` | `number` | `1` | -; ≥ 1 |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `source`<br>É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`<br>É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.

```json
{
  "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](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)