Как настроить Aggregate в n8n: собрать items в массив

Соберите items в массив через Aggregate в n8n: учебные кампании, имя выходного поля, сохранение данных и проверка числа записей без расчёта бизнес-эффекта.

Режим All Item Data показывает, как настроить Aggregate в n8n для трёх элементов кампаний: он соберёт их в один список, а режим All Item Data и один параметр с именем поля вывода дают на выходе один элемент, внутри которого лежит массив campaigns из трёх записей, при этом число элементов и имена полей проверяются глазами в панели ноды. [1]

Учебные входы и цель

Учебный пример. На входе три состояния кампаний — по одному элементу на канал.

Создаём их в Code node. Режим по умолчанию Run Once for All Items, поэтому код выполняется один раз независимо от числа входных элементов, а возвращаем массив объектов с ключом json — именно такой формат n8n ожидает между нодами. [5]

return [
  { json: { channel: 'search', leads: 30 } },
  { json: { channel: 'social', leads: 18 } },
  { json: { channel: 'email',  leads: 12 } },
];

Подключаем к выходу Code node ноду Aggregate, задаём параметры ниже и запускаем ноду через Execute step — кнопку на самой ноде. [7]

Цель — один элемент, внутри которого лежит массив campaigns из трёх записей. Имена полей channel и leads должны сохраниться у каждой записи.

Выбор режима: All Item Data

У Aggregate два режима. Individual Fields собирает отдельные поля порознь: вы указываете поле на входе, а при необходимости задаёте другое имя на выходе через Rename Field. All Item Data собирает все данные элементов в один список. Для задачи «три элемента в один массив кампаний» подходит второй режим:

  • Aggregate: All Item Data
  • Put Output in Field: campaigns

Поле Put Output in Field задаёт имя, под которым собранный список ляжет в выходном элементе. Именно оно даёт массив campaigns.

Какие поля попадут в массив

Параметр Include управляет тем, что войдёт в вывод:

  • All fields — все поля без дополнительных настроек.
  • Specified Fields — только перечисленные поля через запятую в Fields To Include.
  • All Fields Except — все поля, кроме перечисленных в Fields To Exclude.

Для учебного примера оставляем All fields: на входе только channel и leads, лишнего нет.

Aggregate не считает сумму: граница с Summarize

Aggregate группирует элементы. Он не складывает числовые значения и не считает статистику по полю. Сумма, среднее или количество — это отдельная операция Summarize.

В нашем примере сумма 60 — ручная проверка, а не действие Aggregate. Считаем её сами и сверяем с числами массива: 30 + 18 + 12 = 60.

Проверка результата по числу и полям записей

После Aggregate ожидаем один элемент. Внутри него — массив campaigns из трёх записей с сохранёнными полями. Открываем Output ноды в JSON view вместе с Table view: JSON показывает полный набор данных, Table удобен для быстрого взгляда на записи. [6]

[
  {
    "campaigns": [
      { "channel": "search", "leads": 30 },
      { "channel": "social", "leads": 18 },
      { "channel": "email",  "leads": 12 }
    ]
  }
]

Сверка по трём пунктам:

Что проверяем Ожидание Где смотреть
Число элементов на выходе
1
счётчик элементов после ноды
Длина массива campaigns
3
значение поля campaigns в JSON view
Имена полей в каждой записи
channel, leads
содержимое объектов массива

Если элементов на выходе больше одного или длина массива не равна трём, сначала проверь режим All Item Data и вход Aggregate: там должны быть три отдельных элемента из учебного примера. Поля channel и leads сохраняются в каждой записи при Include: All fields.

Aggregate, Split Out и Merge: что делает каждая нода

Эти ноды решают разные задачи:

Нода Действие Когда применять
Aggregate
собирает элементы в один список
нужно свернуть поток в массив
Split Out
разворачивает массив обратно в отдельные элементы
нужно разложить массив на элементы
Merge
объединяет данные из разных веток; режим Combine → Matching Fields сопоставляет их по значениям полей
нужно сопоставить источники

Aggregate и Split Out — обратные операции: одна сворачивает поток в список, другая раскладывает список на элементы. Merge работает с несколькими входами и объединяет данные из разных потоков.

Итог

Схема настройки короткая: Code node с тремя элементами, нода Aggregate, режим All Item Data, поле вывода campaigns, Include: All fields. Проверка — один элемент на выходе, массив из трёх записей, сохранённые поля channel и leads. Сумму считаем отдельно как ручную сверку.

Если элементы приходят из внешнего JSON, стоит заранее разобрать структуру данных — об этом в статье Как работать с JSON в n8n. А когда поток данных нестабилен и ноды падают, пригодится разбор повторов и ошибок в n8n.

Источники

  1. Aggregatedocs.n8n.io
  2. Code node common issues: output must be array of objects with jsondocs.n8n.io
  3. Work with data: inspect input and output in JSON viewdocs.n8n.io
  4. Node controls: Execute step runs the nodedocs.n8n.io

Валерий Курземнек

Автор метода «Машиночитаемый маркетинг»

Что ещё почитать