Распаковать подготовленный ZIP в папку Диска
Робот «Распаковать подготовленный ZIP в папку Диска». Проверяет ограниченный архив и сохраняет его файлы в выбранную папку.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для координатора, принимающего небольшой заранее подготовленный комплект файлов в архиве. Проверяет ограниченную структуру ZIP и сохраняет его файлы в папке без ручной распаковки и повторной загрузки события.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ZIP в Base64 | Текст | Обязательное; значение по умолчанию не задано |
| Папка назначения | Целое число | Обязательное; значение по умолчанию не задано |
| Уникальный ключ операции | Строка | Обязательное; значение по умолчанию не задано |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Передайте содержимое ZIP в Base64, а не путь или внешнюю ссылку.
- Укажите ID доступной папки назначения.
- Проверьте, что архив содержит от 1 до 20 файлов только в корне, с простыми уникальными именами.
- Задайте устойчивый ключ одной распаковки.
- После успеха используйте списки ID, имён и размеров. Контрольные суммы относятся к переданным данным, поэтому не называйте их независимой проверкой скачанных файлов.
Учебный пример и ожидаемый результат
Небольшой архив содержит note.txt в корне и передаётся в папку 50 с ключом package-900-extract-v1. Если в папке нет совпадающего имени и все ограничения выполнены, ожидается ID сохранённого файла и его размер. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- ID файлов: целое число, список.
- Имена файлов: строка, список.
- Размеры файлов: целое число, список.
- SHA-256 переданных файлов: строка, список.
- Получен сохранённый результат: да/нет (Y/N).
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
ZIP до 5 МиБ, каждый файл до 1 МиБ, суммарно до 4 МиБ. Пути, ссылки, шифрование, неподдерживаемое сжатие и повторы запрещены. Контрольные суммы ZIP проверяются, антивирусная проверка не выполняется. Совпадение имени: ошибка. Частичная загрузка не откатывается автоматически.
Один ключ операции закрепляйте за одним событием и сохраняйте неизменным при его повторе вместе со всеми входными данными. Для другого события нужен другой ключ. Случайный новый ключ на каждом запуске допускает дубли. При неизвестном или частичном результате сначала сверяйте фактически созданный объект; не обходите остановку сменой ключа.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.