CRM роботы 2.0 + AI (300+ роботов)

Подготовить таблицу из записей по схеме колонок

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

Настройки робота «Подготовить таблицу из записей по схеме колонок» в Битрикс24

Видимая часть формы настройки в Битрикс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 опасные начала текстовых ячеек защищаются апострофом: табуляция, перевод строки или символы =, +, -, @ после начальных пробелов. Числовые значения остаются числами. Визуальный вид таблицы при вставке зависит от принимающего редактора; робот не создаёт файл и не загружает его на Диск.