Робот «Подготовить таблицу из записей по схеме колонок» формирует читаемую таблицу для письма или текст CSV для обмена, сохраняя точные числовые значения.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору CRM и специалисту, который готовит понятное представление списка товаров, задач или согласуемых позиций для сообщения либо выгрузки.
Передача сырого JSON неудобна получателю: нужные поля теряются среди служебных. Робот формирует только выбранные колонки с понятными подписями. Он возвращает текст HTML или CSV; прикрепление файла и отправку сообщения настраивают следующим действием.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
Записи JSON (RECORDS) |
Обязательное поле |
Колонки JSON (COLUMNS) |
Обязательное поле |
Формат (FORMAT) |
Обязательное поле. по умолчанию html. HTML (html); CSV (csv) |
Разделитель CSV (DELIMITER) |
Обязательное поле. по умолчанию ; |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Передайте записи массивом объектов. В COLUMNS укажите field для каждого поля верхнего уровня и label для подписи колонки.
- Выберите HTML для вставки в место, которое поддерживает таблицы, или CSV для текстовой выгрузки. По умолчанию используется HTML.
- Для CSV выберите разделитель, по умолчанию точка с запятой. Имена полей колонок должны быть уникальными.
- Проверьте статус, число строк и колонок. Передайте «Таблица или текст CSV» в отдельное действие отправки или сохранения, подходящее для выбранного формата.
Как заполнить JSON-поля
Записи JSON (RECORDS)
[
{
"name": "Кабель",
"qty": 2
}
]
Массив объектов до 1000 строк из предыдущего отбора. [] даёт таблицу с заголовками.
Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.
Колонки JSON (COLUMNS)
[
{
"field": "name",
"label": "Товар"
},
{
"field": "qty",
"label": "Количество"
}
]
От 1 до 50 колонок. field: уникальное имя верхнего поля. label необязателен и по умолчанию равен field. Пустой [] запрещён.
Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.
Учебный пример и ожидаемый результат
RECORDS: [{"name":"Кабель","qty":2}], COLUMNS: [{"field":"name","label":"Товар"},{"field":"qty","label":"Количество"}], FORMAT=html. Ожидается HTML-таблица с двумя заголовками и одной строкой «Кабель», 2. Значение <b>Кабель</b> внутри данных будет показано как текст, а не как команда выделения.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Таблица или текст CSV» (
table). - «Формат» (
format). - «Строк данных» (
rowCount). - «Колонок» (
columnCount).
«Строк данных» не включает строку заголовков. Пустой набор даёт заголовки без строк данных. Отсутствующее поле и null превращаются в пустую ячейку, поэтому для обязательных колонок выполните проверку данных заранее.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Колонки: [{"field":"name","label":"Товар"}]; label по умолчанию совпадает с field. До 1000 строк и 50 колонок; только поля верхнего уровня; нет поля/null: пустая ячейка. По умолчанию HTML; теги в данных и подписях экранируются. CSV защищает потенциально опасные текстовые ячейки и заголовки начальным апострофом; числовые значения сохраняются числами. Пустой набор дает таблицу с заголовком. Возвращает текст, а не загруженный файл. Вход и результат до 1 МБ.
При CSV опасные начала текстовых ячеек защищаются апострофом: табуляция, перевод строки или символы =, +, -, @ после начальных пробелов. Числовые значения остаются числами. Визуальный вид таблицы при вставке зависит от принимающего редактора; робот не создаёт файл и не загружает его на Диск.