Ноды в 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
Проверка по трём точкам:
- Первая строка — заголовки
channelиleads. - Две строки данных:
searchиsocial. - Сумма значений
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 по умолчанию.
Источники
- Convert to Filegithub.com
- Understand n8n's data structure | Build | n8n Docsdocs.n8n.io

