{"id":42041,"date":"2025-09-03T19:30:04","date_gmt":"2025-09-03T19:30:04","guid":{"rendered":"\/fr\/tutoriels\/?p=42041"},"modified":"2025-09-03T22:21:09","modified_gmt":"2025-09-03T22:21:09","slug":"loop-over-items-n8n","status":"publish","type":"post","link":"\/fr\/tutoriels\/loop-over-items-n8n","title":{"rendered":"Comment utiliser le n\u0153ud Loop Over Items (Split in Batches) dans n8n\u00a0"},"content":{"rendered":"

Dans n8n, la boucle sur les éléments (Loop Over Items) est l’une des techniques les plus puissantes pour traiter des listes de données, telles que des adresses e-mail, des réponses API ou des enregistrements de base de données.<\/p>

Alors que de nombreux nœuds n8n traitent les éléments individuellement par défaut, certaines situations nécessitent plus de contrôle, par exemple lorsque vous devez envoyer des messages par lots ou limiter le nombre de requêtes par cycle.<\/p>

C’est là qu’intervient le nœud Loop Over Items (Split in Batches)<\/strong>. Vous définissez une taille de lot, et il divise l’ensemble de données en groupes plus petits, traitant chaque lot un par un.<\/p>

Cet article explique ce que signifie la boucle dans n8n, comment fonctionne le nœud Loop Over Items et quand l’utiliser. Vous apprendrez également à itérer sur des éléments à travers des exemples pratiques, tels que l’envoi d’e-mails en masse et le traitement de grands ensembles de données en morceaux gérables.<\/p>

Que signifie « looping<\/strong>«  dans n8n ?<\/strong><\/h2>

Dans n8n, le bouclage (looping) désigne la répétition d’un ensemble d’actions pour chaque élément d’une liste ou d’un tableau dans un flux de travail<\/strong>. Cela vous permet d’automatiser des tâches pour chaque élément d’un ensemble de données sans intervention manuelle.<\/p>

Par exemple, si vous avez une liste de 100 contacts et que vous souhaitez envoyer un e-mail à chacun d’entre eux, la boucle permet à n8n de traiter chaque contact de manière séquentielle (en envoyant un e-mail après l’autre) plutôt que d’envoyer des e-mails en masse à tous les contacts en même temps.<\/p>

Par défaut, de nombreux nœuds n8n traitent les tableaux ou les listes entrants élément par élément. Lorsqu’un nœud reçoit un tableau, il transmet chaque élément au flux de travail, un à la fois.<\/p>

Mais une boucle explicite devient nécessaire lorsqu’un nœud ne peut traiter qu’un seul élément à la fois, lorsque vous avez besoin d’un meilleur contrôle sur l’ordre et le regroupement des opérations, ou lorsque le traitement d’un trop grand nombre d’éléments à la fois pourrait surcharger votre système.<\/p>

Comment fonctionne le nœud « <\/strong>Loop Over Items« <\/strong> dans n8n ?<\/strong><\/h3>

Le nœud n8n Loop Over Items (Split in Batches) fonctionne en divisant une liste d’éléments entrants en lots plus petits et gérables, puis en les traitant un lot à la fois<\/strong>.<\/p>

En définissant la taille des lots, vous pouvez contrôler le nombre d’éléments qui transitent par votre flux de travail à chaque itération.<\/p>

Voici un aperçu détaillé de son fonctionnement :<\/p>

    \n
  1. Le nœud Boucle sur les éléments (division en lots) <\/strong>divise un tableau d’éléments d’entrée en lots en fonction de la taille que vous définissez, par exemple un élément par lot.<\/li>\n\n\n\n
  2. Chaque lot est ensuite transmis au nœud connecté suivant, qui effectue l’action souhaitée, telle que l’envoi d’un e-mail ou la création d’une requête API.<\/li>\n\n\n\n
  3. Après avoir traité un lot, le flux de travail revient au nœud « Boucle sur les éléments » pour continuer à traiter le prochain ensemble d’éléments.<\/li>\n\n\n\n
  4. Ce processus se répète automatiquement jusqu’à ce que tous les lots soient traités.<\/li>\n<\/ol>

    Le nœud Boucle sur les éléments traite uniquement la liste d’éléments qu’il reçoit, puis s’arrête. Vous n’avez donc pas à vous soucier d’une boucle infinie.<\/p>

    Mais si vous l’utilisez pour traiter des données paginées, telles que la récupération de pages à partir d’une API, vous devez ajouter une logique conditionnelle, comme un nœud If<\/strong>, pour vérifier s’il existe d’autres pages.<\/p>

    Cette condition indique au workflow quand s’arrêter, ce qui l’empêche de parcourir des pages vides.<\/p>

    Quand utiliser le nœud Boucle sur les éléments ?<\/strong><\/h3>

    Vous devez utiliser le nœud Boucle sur les éléments lorsque vous devez diviser les données en petits morceaux et traiter les éléments un par un<\/strong>.<\/p>

    Cela est particulièrement utile pour les grands ensembles de données, lorsque chaque élément nécessite une action individuelle ou lorsque vous souhaitez contrôler le nombre d’éléments traités à chaque itération.<\/p>

    Voici quelques exemples d’utilisation du nœud Boucle sur les éléments :<\/p>