Собрать ZIP из подготовленных файлов

Робот «Собрать ZIP из подготовленных файлов». Упаковывает переданные вложения в один архив для следующего шага процесса.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

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

Что подготовить

Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.

Параметры и значения

Поле в настройке	Тип	Обязательность и исходное значение
Имя архива .zip	Строка	Обязательное; значение по умолчанию не задано
Подготовленные файлы (JSON)	Текст	Обязательное; значение по умолчанию не задано

Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.

Как использовать пошагово

1. Задайте простое имя архива с расширением .zip, например training-package.zip.
2. Подготовьте JSON-массив файлов с точными ключами name и contentBase64.
3. Для каждого вложения укажите простое уникальное имя без папок и его содержимое Base64; ID файла Диска вместо содержимого не подходит.
4. Передайте от 1 до 20 файлов и проверьте ограничения размеров.
5. Используйте содержимое ZIP в Base64 из результата для отдельного сохранения на Диске или другой последующей обработки; само действие ничего на портале не записывает.

Учебный пример и ожидаемый результат

Для учебного текстового файла можно передать [{"name":"note.txt","contentBase64":"SGVsbG8="}]: это текст Hello. При имени training.zip ожидается архив с одним файлом note.txt, его Base64, размер и контрольная сумма. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

Какие результаты передать дальше

• Имя архива: строка.
• Содержимое ZIP в Base64: текст.
• Размер архива: целое число.
• SHA-256 архива: строка.
• Имена файлов: строка, список.

В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.

Ограничения и исправление ошибок

Каждый файл: до 1 МиБ, суммарно до 4 МиБ, итоговый ZIP: до 5 МиБ. Пути и повторяющиеся имена запрещены. Файлы с Диска не скачиваются. Упаковка не проверяет содержимое антивирусом и не подтверждает деловую корректность вложений.

Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.

Как заполнять JSON-поля

Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.

Подготовленные файлы (JSON)

[
  {
    "name": "note.txt",
    "contentBase64": "SGVsbG8="
  }
]

Массив от 1 до 20 файлов. В каждом объекте обязательны строковое простое имя name и строка contentBase64 с содержимым. В примере Base64 кодирует текст Hello. Пути и URL вместо содержимого не принимаются. Берите байты из предыдущего шага подготовки вложения, имя задавайте с расширением. Один файл до 1 МиБ, все до 4 МиБ; имена уникальны и без путей. Пустые [] и {} не задают комплект для упаковки.