Как преобразовать JSON в CSV-файл в n8n

Соберите CSV из JSON в n8n: операция Convert to CSV, поле вывода, имя файла и заголовок. Учебный пример, частые ошибки и проверка результата.

Ноды в n8n обмениваются JSON-объектами, а файл — это отдельный бинарный формат. Поэтому вопрос, как преобразовать JSON в файл в n8n через Convert, упирается в одну развилку: сведения лежат в поле json, а готовый CSV появляется в поле binary. Между этими двумя состояниями стоит нода Convert to File.

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

JSON и файл в n8n: где проходит граница

Все данные, которые передаются между нодами, — это массив объектов. Обычные значения живут под ключом json, бинарные — под ключом binary, где хранятся base64-данные, MIME-тип, расширение и имя файла (Understand n8n's data structure[2]). Когда нода получает массив, она обрабатывает каждый элемент по отдельности (Understand n8n's data structure[2]). Из этого и вытекает устройство Convert to File: нода берёт входные JSON-данные и отдаёт их как файл, то есть переводит JSON в бинарный формат ([1]).

Практический вывод: до ноды вы работаете с полями вроде channel и leads, после неё — с бинарным полем, в котором лежит готовый файл. Дальше уже решаете, куда его положить: на диск, в хранилище или отправить сервису.

Выбор ноды и операции Convert to CSV

Нужная нода — Convert to File. У неё есть набор операций: Convert to CSV, Convert to HTML, Convert to ICS, Convert to JSON, Convert to ODS, Convert to RTF, Convert to Text File, Convert to XLS, Convert to XLSX и Move Base64 String to File ([1]). Параметры и опции зависят от выбранной операции ([1]).

Для таблицы с колонками выбираем Convert to CSV. Операция Convert to JSON собирает JSON-файл. Convert to Text File пишет строку в файл. Если вам нужна таблица для выгрузки или вложения с колонками, берите CSV.

Поле вывода и настройки CSV: имя файла и заголовок

Для операции Convert to CSV настраивается параметр Put Output File in Field — имя поля в выходных данных, в котором будет лежать файл ([1]). Именно сюда нода кладёт готовый бинарный объект. Если следующая нода читает файл из поля data, укажите здесь то же имя.

В опциях операции задаётся File Name — имя файла для сгенерированного выходного файла ([1]). Второй важный переключатель — Header Row: его включают, когда первая строка файла содержит названия заголовков ([1]). Без него данные пойдут без строки с именами колонок.

Для учебного файла задайте следующие значения.

Параметр Что вводить Зачем
Operation
Convert to CSV
выбрать работу с табличным файлом
Put Output File in Field
data
имя поля, в котором будет лежать файл
File Name
leads.csv
имя выходного файла
Header Row
включить
добавить строку с названиями колонок

Имя поля вывода data и имя файла leads.csv — мои значения для учебного прохода; в рабочем сценарии берите имена под задачу.

Учебный пример: две строки JSON в CSV

Учебный пример. Далее показываю один проход на двух учебных строках.

Два входных элемента задаю прямо в коде Code-ноды. Нода возвращает массив из двух объектов под ключом json: n8n принимает такой массив и обрабатывает каждый элемент по отдельности (Understand n8n's data structure[2]).

return [
  { json: { channel: 'search', leads: 12 } },
  { json: { channel: 'social', leads: 8 } },
];

Это и есть оба входных item:

channel leads
search
12
social
8

Дальше соединяем выход Code-ноды со входом Convert to File и настраиваем ноду:

Параметр Значение
Operation
Convert to CSV
Put Output File in Field
data
File Name
leads.csv
Header Row
включить

Ожидаемое содержимое CSV-файла в поле data:

channel,leads
search,12
social,8

Проверка по трём точкам:

  1. Первая строка — заголовки channel и leads.
  2. Две строки данных: search и social.
  3. Сумма значений leads: 12 + 8 = 20.

Если сумма не 20, сверяйте по очереди оба входных значения, количество строк и значения в CSV: search — 12, social — 8. Если заголовка нет, проверьте, включён ли Header Row. Если файл пустой или отсутствует, вернитесь к полю Put Output File in Field и убедитесь, что имя совпадает с тем, которое читают следующие ноды.

В учебном образце сначала указан channel, затем leads. При проверке своего файла сверяйте значения с именами колонок в заголовке, а не только с их позицией. Как только файл собран, следующий вопрос — куда его положить и на каком шаге процесса это окупается; общий расчёт такого шага — в разборах окупаемости автоматизации и автоматизации маркетинга.

Convert to File и Extract From File: в какую сторону работает каждая

Эти две ноды решают противоположные задачи. Convert to File берёт входные данные и отдаёт их как файл, переводя JSON в бинарный формат ([1]). Extract From File делает обратное: извлекает данные из файла и переводит их в JSON ([1]).

Направление легко удержать по тому, что лежит на входе. Если на входе набор полей вроде channel и leads, а на выходе нужен файл для отправки или выгрузки — берите Convert to File с операцией Convert to CSV. Если на входе пришёл файл и нужно раскладывать его в поля — берите Extract From File. Перепутать их просто, потому что обе стоят в списке нод файлов; сверяйте вход и выход, а не только название.

Как проверить, что файл получился корректным

Проверку стройте на содержимом, а не на факте, что нода отработала без ошибки. Для учебного примера достаточно трёх точек из прошлого раздела: заголовок, две строки, сумма 20. В рабочем сценарии добавьте ещё число колонок и число строк против входного массива: они должны совпадать один к одному.

Если проверка расходится, идите от устройства данных. Посмотрите, что реально приходит в ноду: массив элементов под ключом json (Understand n8n's data structure[2]). Потом — что лежит в бинарном поле после ноды: там должен быть файл с вашим именем. Затем уже открывайте сам CSV и сверяйте строки.

Дальше файл обычно уходит из воркфлоу: на диск, в хранилище или во внешний сервис. Передача выгрузки с данными клиентов — отдельный шаг, и он идёт после решения о том, какие поля вообще должны попасть в файл. Лишние поля вроде идентификаторов и персональных данных уберите до ноды Convert to File, чтобы они не оказались в CSV по умолчанию.

Источники

  1. Convert to Filegithub.com
  2. Understand n8n's data structure | Build | n8n Docsdocs.n8n.io

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

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

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