Ressources · Intégration n8n

Nœud Aggregate n8nConfigurer Aggregate dans n8n.

Le nœud Aggregate n8n rassemble une série d'items en un seul. Il lit un champ sur chaque item qui arrive et renvoie toutes les valeurs sous forme de liste. Six paramètres règlent les champs retenus, le sort des listes et des fichiers, et celui des valeurs vides.

Tester le nœud Aggregate sur n8nVoir les 6 paramètres

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Aggregate n8n dans un workflow ?

Dans n8n, un nœud s'exécute une fois par item entrant. Pratique tant qu'on traite les lignes une par une, gênant dès qu'on veut un récapitulatif. Aggregate prend les items séparés qui lui arrivent, ou une partie de leurs données, et les regroupe dans un item unique. Sa description officielle tient en une ligne : combiner un champ de plusieurs items en une liste dans un seul item.

Le cas le plus courant tient en une image. Un workflow récupère une série d'enregistrements, et sans Aggregate le nœud suivant part une fois par enregistrement. Avec Aggregate entre les deux, la suite ne tourne qu'une fois, sur un item qui porte la liste complète.

Trois résultats reviennent souvent. Le récapitulatif d'abord : on agrège les titres des tickets ouverts dans la journée et on poste un seul message sur Slack, au lieu d'une notification par ticket. Le fichier joint ensuite : Include Binaries activé, les documents téléchargés plus tôt dans l'exécution voyagent avec l'item agrégé et partent dans un seul mail Gmail. Le tri enfin : un If placé avant Aggregate écarte les items hors critère, et seule la sélection finit dans la liste.

Il y a des moments où un autre nœud fait mieux l'affaire. Merge rapproche deux branches d'un même workflow, chacune sur son entrée ; Aggregate travaille sur un flux unique d'items qui arrivent au même endroit. Et si le besoin est de renommer ou de construire des champs sans toucher au nombre d'items, ce n'est pas le bon nœud non plus.

Deux limites à garder en tête. Le nœud est en version 1 : ce que le panneau affiche, c'est tout ce qu'il sait faire, deux modes d'agrégation et les options décrites plus bas. Trois d'entre elles, Disable Dot Notation, Merge Lists et Keep Missing And Null Values, n'apparaissent qu'une fois Individual Fields sélectionné. Aggregate ne démarre rien non plus : comme tout nœud core, il lui faut un déclencheur devant lui, un Schedule Trigger, un Webhook (une URL que n8n expose et qu'un service appelle), ou le trigger d'un outil. Pour monter ce genre de workflow proprement, la Formation n8n passe par là.

Paramètres

Quels paramètres régler dans Aggregate , et quand ?

Le nœud Aggregate compte 6 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Aggregate

aggregate

Ce que tu vois dans n8n

Notes & cas d'usage

Tout le panneau dépend de ce sélecteur. aggregateIndividualFields agrège champ par champ, chacun devenant sa propre liste ; aggregateAllItemData verse chaque item entier dans une liste unique, sous un nom de champ que tu choisis.

Paramètres clés

  • Fields To Aggregate : une ligne par champ d'entrée à rassembler, ajoutée avec Add Field To Aggregate.
  • Put Output in Field : le nom du champ de sortie qui reçoit les données quand on agrège tout l'item.
  • Include : allFields, ou specifiedFields avec Fields To Include, ou allFieldsExcept avec Fields To Exclude, les deux écrits en liste séparée par des virgules, du type email, name.
Cas d'usage
récupérer le {{ $json.email }} de chaque participant pour obtenir une seule liste d'adresses.
02

Disable Dot Notation

options.disableDotNotation

Ce que tu vois dans n8n

Notes & cas d'usage

Un point dans un nom de champ prête à confusion. Par défaut, n8n lit parent.child comme un chemin vers un champ imbriqué, ce qui tombe à côté si le champ s'appelle vraiment comme ça. Cette bascule tranche, et elle ne s'affiche qu'avec Individual Fields.

Paramètres clés

  • Disable Dot Notation : activé, référencer un champ enfant avec parent.child dans le nom du champ devient interdit, le nom est pris tel qu'il est écrit.
Cas d'usage
agréger une colonne dont l'intitulé, hérité d'un export, contient un point.
03

Merge Lists

options.mergeLists

Ce que tu vois dans n8n

Notes & cas d'usage

Quand le champ agrégé contient déjà une liste, la sortie devient une liste de listes, une entrée par item entrant. Le nœud suivant s'attend rarement à ça. Active l'option et tout se remet à plat dans une seule liste.

Paramètres clés

  • Merge Lists : activé, la sortie est fusionnée en une liste plate unique plutôt qu'en liste de listes, quand le champ à agréger est lui-même une liste.
Cas d'usage
chaque item porte ses étiquettes, et le workflow a besoin d'une seule liste d'étiquettes pour le lot.
04

Include Binaries

options.includeBinaries

Ce que tu vois dans n8n

Notes & cas d'usage

Les fichiers circulent à côté des champs JSON, dans ce que n8n appelle les données binaires. Aggregate les laisse derrière lui par défaut, et le PDF récupéré juste avant disparaît à cette étape. L'option le remet dans le nouvel item.

Paramètres clés

  • Include Binaries : activé, les données binaires des items entrants sont incluses dans le nouvel item.
Cas d'usage
regrouper les justificatifs téléchargés pendant l'exécution pour les envoyer en une fois.
05

Keep Only Unique Binaries

options.keepOnlyUnique

Ce que tu vois dans n8n

Notes & cas d'usage

Plusieurs items portent parfois le même document, et les doublons s'empilent dans la sortie. Ce réglage fait le ménage en comparant les types mime, les types de fichiers, les tailles et les extensions pour décider si deux fichiers n'en font qu'un.

Paramètres clés

  • Keep Only Unique Binaries : activé, seuls les binaires uniques sont conservés, sur comparaison des types mime, types de fichiers, tailles et extensions.
Cas d'usage
un lot où les mêmes conditions générales sont attachées à chaque ligne et n'ont leur place qu'une fois.
06

Keep Missing And Null Values

options.keepMissing

Ce que tu vois dans n8n

Notes & cas d'usage

Par défaut, une valeur absente disparaît simplement de la liste agrégée, qui se retrouve plus courte que le lot d'entrée. Gênant dès que la position compte, par exemple quand deux listes agrégées sont lues en parallèle. L'option conserve les trous.

Paramètres clés

  • Keep Missing And Null Values : activé, une entrée nulle est ajoutée à la liste agrégée dès que la valeur d'entrée est absente ou nulle.
Cas d'usage
un lot où certaines lignes n'ont pas de téléphone et où la liste doit rester alignée sur les noms.
Besoin d'aide

Besoin d'aide pour automatiser Aggregate avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Aggregate dans n8n : les questions qui suivent

01Le nœud Aggregate n8n est-il gratuit ?
Oui. Aggregate est un nœud core livré avec n8n : rien à installer, aucun coût supplémentaire de ce côté. Il fonctionne de la même façon sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée avec Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow monté d'un côté tourne à l'identique de l'autre, donc rien n'empêche de tester l'agrégation sur Cloud puis de déplacer le même workflow sur ta propre machine plus tard. Le nœud reste identique dans les deux environnements, avec les mêmes six paramètres et la même version.
02Quels identifiants faut-il pour utiliser Aggregate ?
Aucun, et c'est toute la réponse. Le nœud n'a pas de credential, c'est-à-dire pas d'accès à enregistrer dans n8n, et pas de sélecteur Authentication : il n'y a rien à configurer côté compte avant de s'en servir. Il ne travaille que sur des données déjà présentes dans l'exécution, celles que lui passe le nœud précédent. L'authentification se joue en amont, sur le nœud qui est allé chercher ces items. Une fois les données dans le workflow, Aggregate les remet en forme sur place.
03Quelles sont les limites du nœud Aggregate ?
Le nœud est en version 1 : deux modes d'agrégation et les options décrites plus haut, rien de plus dans le panneau. Trois de ces options, Disable Dot Notation, Merge Lists et Keep Missing And Null Values, ne s'affichent qu'avec Individual Fields, alors que Include Binaries est proposée dans les deux modes. Autre limite : Aggregate travaille sur les items qu'il reçoit et ne lance jamais une exécution tout seul, il faut un déclencheur devant. Un vieux workflow peut encore afficher une version antérieure, avec moins d'options, parce qu'un nœud ne change pas de version de lui-même.
04Aggregate ou Merge, lequel choisir ?
Ça dépend d'où viennent les données. Merge réunit deux branches d'un même workflow, chacune arrivant sur son entrée, et c'est le bon choix pour croiser deux sources. Aggregate travaille sur un flux unique : beaucoup d'items sur une seule entrée, repliés en un item qui porte une liste. Si l'objectif est juste d'éviter que le nœud suivant parte une fois par item, c'est Aggregate. Pour renommer ou fabriquer des champs sans changer le nombre d'items, c'est encore un autre nœud qu'il faut, celui qui édite les champs.
05n8n ou Make pour regrouper des items ?
Les deux savent le faire, et la décision se joue ailleurs que sur la fonctionnalité. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : un workflow qui brasse beaucoup d'items voit sa facture suivre le volume. n8n peut tourner sur ta propre infrastructure, ce qui garde les données sur des machines que tu maîtrises et décorrèle le coût du nombre d'items traités. La logique visuelle existe des deux côtés. Tranche sur l'hébergement, la maîtrise des données et le modèle de coût, puis sur l'éditeur dans lequel l'équipe se sent le mieux.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations