Comment créer une boucle avec Loop Over Items dans n8n

Le nœud Loop Over Items de n8n est un composant qui permet de parcourir et de traiter des données par lots. Il facilite la gestion de grands ensembles de données, comme des adresses email, des réponses d’API ou des enregistrements de bases de données.

Pour créer des boucles dans votre flux n8n, vous devez comprendre quelques principes clés :

• Définition et avantages des boucles : une boucle consiste à répéter certaines opérations sur un ensemble de données. Elle est particulièrement utile lorsque votre flux fait appel à des services tiers qui imposent des limites de requêtes.
• Fonctionnement du nœud Loop Over Items : dans n8n, Loop Over Items récupère les données provenant d’un autre nœud, les divise en lots, les transmet pour traitement, puis répète ces étapes jusqu’au dernier élément.
• Étapes pour créer une boucle : pour créer une boucle dans n8n, ajoutez le nœud Loop Over Items après la source de données, connectez-le à la chaîne de traitement, puis redirigez le flux vers le nœud Loop Over Items.
• Exemples pratiques de boucles dans n8n : les boucles dans n8n peuvent notamment servir à envoyer des emails en masse ou à traiter des flux RSS.

Qu’est-ce qu’une boucle dans n8n ?

Dans n8n, une boucle consiste à répéter un ensemble d’actions pour chaque élément d’une liste ou d’un tableau au sein d’un flux. Vous pouvez ainsi automatiser des tâches pour chaque élément d’un ensemble de données sans intervention manuelle.

Par exemple, si vous disposez d’une liste de 100 contacts et souhaitez envoyer un email à chacun d’entre eux, une boucle permet à n8n de traiter chaque contact successivement au lieu d’envoyer tous les emails en une seule fois.

Les boucles sont nécessaires lorsque vous devez contrôler précisément l’ordre des opérations ou lorsque le traitement simultané d’un trop grand nombre d’éléments risque de surcharger votre système ou des API externes. Pour créer une n8n loop, vous pouvez utiliser le nœud Loop Over Items.

Comment fonctionne le nœud Loop Over Items dans n8n ?

Le nœud Loop Over Items (Split in Batches) fonctionne en divisant une liste d’éléments entrante en lots plus petits et plus faciles à gérer, puis en traitant ces lots un par un. Voici les différentes étapes du processus :

1. Input : le nœud reçoit un tableau d’éléments en entrée.
2. Split : il divise ensuite ce tableau en lots en fonction de la valeur Batch Size que vous avez définie.
3. Action : chaque lot est transmis au nœud connecté suivant afin d’effectuer l’action souhaitée.
4. Return : une fois le traitement terminé, le flux revient au nœud Loop Over Items.
5. Repeat : ce cycle se répète automatiquement jusqu’à ce que tous les lots aient été traités.

En définissant la valeur Batch Size, vous contrôlez le nombre d’éléments qui passent dans votre flux à chaque itération. Le fonctionnement est similaire à celui d’une boucle for en programmation, qui permet d’effectuer une action donnée un certain nombre de fois avant de passer à l’étape suivante.

La taille des lots est particulièrement importante lorsque vous récupérez des données depuis une API. Elle permet d’envoyer les requêtes par groupes contrôlés et faciles à gérer plutôt que toutes en même temps, ce qui réduit le risque d’atteindre la limite de requêtes.

Notez que si vous récupérez des données depuis une API ou une autre source paginée, vous devez ajouter une logique conditionnelle, par exemple avec un nœud If, afin de vérifier s’il reste des pages à traiter. Cette condition indique au flux quand s’arrêter et évite ainsi de créer une boucle parcourant des pages vides.

Quand utiliser le nœud Loop Over Items ?

Utilisez le nœud Loop Over Items lorsque vous devez diviser des données en plus petits groupes et traiter les éléments un par un. Cette approche 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.

Le nœud Loop Over Items est notamment utile pour :

• Envoyer des emails par lots : divisez les grandes listes d’adresses email en petits groupes afin d’éviter de déclencher les filtres antispam ou d’atteindre les limites d’envoi.
• Effectuer des appels API séparés : traitez les entrées d’un ensemble de données une par une, par exemple pour mettre à jour les informations de vos clients, tout en respectant les limites de requêtes de l’API.
• Traiter les lignes d’une feuille de calcul : traitez individuellement chaque ligne d’une base de données ou d’une feuille de calcul afin de la valider ou de la mettre en forme.
• Traiter des réponses API paginées : récupérez toutes les données disponibles depuis une API en effectuant plusieurs requêtes et en vérifiant après chaque lot s’il reste des pages.
• Générer des documents personnalisés : créez des rapports ou des factures individuels pour chaque client d’une liste.

En résumé, utilisez le nœud Loop Over Items dès que votre flux doit effectuer une action sur chaque enregistrement individuellement ou respecter des limites de requêtes.

Conseil d’expert

Le nœud Loop Over Items (Split in Batches) est généralement utilisé pour un nombre défini de lots, de manière similaire à une boucle for en programmation. Il est utile lorsque vous souhaitez effectuer une action précise un certain nombre de fois avant de passer à l’étape suivante.

Minijus Savickas

Chef de produit VPS

Comment parcourir des éléments en boucle dans n8n ?

Pour parcourir des éléments en boucle dans n8n, combinez plusieurs nœuds afin de traiter individuellement chaque élément d’une liste.

Loop Over Items (Split in Batches) est le principal nœud utilisé à cette fin, mais vous devrez l’associer à d’autres nœuds, comme Edit Fields (Set) pour préparer les données, HTTP Request pour interagir avec des services externes et If pour ajouter une logique ou définir les conditions d’arrêt.

Voici la procédure générale pour créer une loop over items n8n :

1. Ajoutez le nœud qui fournit la source de données, comme Google Sheets ou Edit Fields (Set).
2. Connectez le nœud Loop Over Items à la source de données.
3. Dans les paramètres du nœud Loop Over Items, définissez la valeur Batch Size.
4. Connectez la sortie du nœud Loop Over Items au nœud qui exécute l’action, comme HTTP Request.
5. Reconnectez la sortie du nœud de traitement à l’entrée du nœud Loop Over Items afin de fermer la boucle.
6. Connectez la sortie Done aux éventuelles étapes finales qui ne doivent être exécutées qu’une fois tous les éléments traités.

Voici un exemple de flux simple permettant de parcourir des éléments en boucle :

Dans cet exemple, nous envoyons 100 emails par groupes de 10, ce qui correspond à la taille du lot. Le flux exécute donc 10 fois le nœud chargé de l’envoi des emails. Une fois que la boucle a traité tous les éléments, le flux se poursuit via la sortie Done.

Nous allons maintenant découvrir d’autres exemples pratiques.

Exemples pratiques de boucles

Voici quelques exemples concrets de tâches que vous pouvez automatiser avec n8n et des boucles.

Envoyer des emails en masse par lots

Une boucle est nécessaire, car les fournisseurs de services email appliquent des limites strictes au nombre d’emails sortants. Envoyer 100 emails simultanément peut dépasser ces limites et entraîner des échecs d’envoi ou la suspension temporaire de votre compte.

L’utilisation de boucles avec un délai entre chaque lot vous aide à respecter ces limites, à préserver une bonne réputation d’expéditeur et à réduire le risque que vos emails soient considérés comme du spam. Voici à quoi ressemble le flux :

Dans ce flux, nous définissons les adresses email avec le nœud Edit Fields. Cependant, si vous avez déjà connecté n8n à Google Sheets, vous pouvez utiliser le nœud Google Sheets pour récupérer directement de véritables adresses email depuis une feuille de calcul.

Le flux sépare ensuite les données sources en plusieurs adresses email individuelles que la boucle parcourt une par une. Chaque contact est ensuite utilisé comme destinataire par le nœud Send email.

Traiter de grands ensembles de données

Dans cet exemple, imaginons que vous deviez traiter un grand ensemble de données tout en respectant des limites de requêtes ou les contraintes de votre système. Ce flux traite 500 fiches clients par lots de 10.

L’utilisation d’une boucle est essentielle, car de nombreuses API imposent des limites de requêtes, par exemple 100 requêtes par minute. Traiter les 500 fiches simultanément dépasserait ces limites et provoquerait des erreurs.

Le nœud Loop Over Items divise les données en groupes plus petits. Il évite ainsi de surcharger n8n et le système cible, tout en assurant un traitement plus fluide et plus fiable. Voici comment il s’intègre au flux :

Le nœud Code génère des fiches clients fictives. Si vous disposez déjà d’une liste de données clients dans une feuille de calcul ou sur une plateforme CRM tierce comme Airtable, connectez le nœud correspondant.

Le flux parcourt les données clients récupérées et interrompt temporairement l’exécution lorsqu’il atteint le nœud Wait, afin d’éviter de dépasser la limite de requêtes de l’API. Le nœud transmet ensuite les données au nœud chargé du traitement. Dans l’exemple ci-dessus, il s’agit du nœud No Operation, utilisé comme élément temporaire.

Lire plusieurs flux RSS successivement

Dans cet exemple, imaginons que vous souhaitiez mettre en place un système automatisé qui récupère du contenu depuis plusieurs sources RSS, comme Tutoriels Hostinger et Blog Hostinger, en les traitant successivement avec des délais contrôlés.

Une boucle est nécessaire pour éviter que des requêtes simultanées envoyées à plusieurs flux RSS, qu’ils proviennent du même domaine ou de domaines différents, soient interprétées comme un comportement agressif. L’ajout de délais permet de mieux gérer les ressources du serveur, de réduire le risque de blocage de l’adresse IP ou de limitation des requêtes et d’assurer un accès fiable aux flux.

Voici un exemple de flux avec une boucle permettant de récupérer plusieurs flux RSS :

Le nœud Code génère une liste d’URL depuis lesquelles récupérer les flux RSS. Le flux parcourt chaque élément et transmet son adresse au nœud RSS Read, qui se charge de récupérer le contenu du blog.

Bonnes pratiques pour créer des boucles

Suivez ces bonnes pratiques lorsque vous parcourez des éléments en boucle dans n8n afin d’éviter les problèmes et de conserver des flux bien structurés :

• Définissez Batch Size sur 1 pour traiter les éléments un par un, ou augmentez cette valeur si votre cas d’usage permet un traitement par lots.
• Reconnectez toujours le nœud de traitement au nœud Loop Over Items afin que la boucle continue jusqu’à ce que tous les éléments aient été traités.
• Utilisez le nœud Split Out si vos données d’entrée correspondent à un seul tableau JSON qui n’a pas encore été divisé en éléments individuels.
• Définissez une condition de sortie claire afin d’éviter les boucles infinies, en particulier lorsque vous utilisez la pagination.
• Respectez les limites de requêtes des API en ajoutant un nœud Wait entre les requêtes afin d’éviter leur limitation.
• Gardez votre boucle aussi légère que possible : moins elle contient de nœuds, meilleures seront ses performances.

En plus de suivre ces bonnes pratiques, vous devez éviter plusieurs erreurs lorsque vous traitez des données en boucle dans votre workflow n8n.

Erreurs courantes lors de la création de boucles dans n8n

Voici quelques-unes des erreurs les plus courantes lors du traitement de données en boucle dans un flux n8n :

• Boucles infinies : si vous reconnectez un nœud au tout début du flux au lieu du nœud Loop Over Items, la boucle s’exécutera indéfiniment.
• Connexion de retour manquante : si vous ne reconnectez pas le nœud de traitement au nœud de boucle, le flux s’arrêtera après le premier lot.
• Mauvaise utilisation des sorties : si vous connectez la logique de traitement à la sortie Done au lieu de la sortie Loop, vos données seront parcourues par la boucle, mais ne seront pas traitées.

Où héberger vos flux n8n ?

Dans l’idéal, hébergez votre workflow n8n dans un environnement fiable, car son fonctionnement nécessite de la stabilité, des performances optimales et une disponibilité constante. Les meilleures options sont donc d’utiliser l’offre cloud officielle de n8n ou de l’auto-héberger sur un serveur privé virtuel (VPS) proposé par un fournisseur fiable comme Hostinger.

Avec l’hébergement n8n de Hostinger, n8n et tous les composants nécessaires sont préinstallés. Vous n’avez donc pas besoin de tout installer manuellement. Vous pouvez exécuter des automatisations avancées sans interruption grâce à un matériel et une infrastructure performants garantissant une disponibilité de 99,9 %.

Avec jusqu’à 8 cœurs vCPU, 32 Go de RAM, 400 Go de stockage SSD NVMe et 32 To de bande passante, vous pouvez commencer avec peu de ressources, puis passer à un pack supérieur en quelques clics à mesure que vos flux se développent.

Comment connecter vos boucles n8n à des API externes ?

Une fois que vous maîtrisez le traitement des éléments en boucle, l’étape suivante consiste à étendre vos flux afin qu’ils puissent interagir avec des sources de données externes. Par exemple, les boucles sont souvent utilisées avec des API pour permettre à n8n de récupérer ou d’envoyer des données dynamiquement sans dépasser les limites de requêtes.

Comme il existe de nombreuses API, vous pouvez les connecter à n8n de différentes manières. Vous pouvez, par exemple, parcourir une liste de nouvelles commandes et utiliser un nœud HTTP Request pour envoyer leurs informations à une API de comptabilité.

Pour en savoir plus sur l’intégration d’une API à votre flux n8n, consultez notre guide expliquant comment utiliser n8n avec des API.

Cet article est une version localisée de How to loop over items in n8n (using the Loop Over Items node), initialement publié en anglais.

Tout le contenu des tutoriels de ce site est soumis aux normes éditoriales et aux valeurs rigoureuses de Hostinger.

L'auteur

Océane Klein

Add Hostinger as a preferred source on Google

Océane est copywriter et rédactrice SEO chez Hostinger. Spécialisée dans la création de contenus optimisés pour le référencement naturel, elle aide les entrepreneurs, créateurs de sites web et PME à développer leur visibilité en ligne grâce à des contenus clairs, utiles et orientés résultats. Passionnée par le marketing digital et la stratégie de contenu, elle s'attache à rendre des sujets parfois techniques accessibles à tous. Son objectif : créer des ressources pratiques qui permettent à chacun de réussir ses projets sur le web.

Plus d'informations sur Océane Klein