Сохранить подготовленный файл на Диске по ключу операции
Робот «Сохранить подготовленный файл на Диске по ключу операции». Проверяет подготовленное вложение и сохраняет его в папку с защитой повторной отправки.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для администратора процесса, сохраняющего уже сформированный документ или изображение на Диске. Проверяет ограниченное вложение и помогает не загрузить второй экземпляр при повторе одного события.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID папки | Целое число | Обязательное; значение по умолчанию не задано |
| Полное имя файла | Строка | Обязательное; значение по умолчанию не задано |
| Содержимое Base64 | Текст | Обязательное; значение по умолчанию не задано |
| Разрешённые форматы (JSON) | Текст | Обязательное; значение по умолчанию не задано |
| Уникальный ключ операции | Строка | Обязательное; значение по умолчанию не задано |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите ID папки назначения и полное имя с расширением.
- Передайте готовое содержимое Base64. URL, путь на компьютере и ID другого файла этим содержимым не являются.
- Задайте массив разрешённых форматов, например
["pdf"]. - Используйте ключ одной операции сохранения и не меняйте его при повторе тех же данных.
- Сохраните ID результата для дальнейшего прикрепления или размещения. SHA-256 результата относится к входным данным.
Учебный пример и ожидаемый результат
В папку 50 сохраняется training-act.pdf: переданы корректные байты PDF в Base64, ["pdf"] и ключ deal-900-act-save-v1. При успехе возвращаются ID файла, размер и контрольная сумма переданного содержимого. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- ID сохранённого файла: целое число.
- Размер переданных данных: целое число.
- SHA-256 переданных данных: строка.
- Получен сохранённый результат: да/нет (Y/N).
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Максимум 5 МиБ. Проверяются размер, расширение и начальная сигнатура, что не является антивирусной проверкой. Совпадающее имя не заменяет другой файл. После загрузки и при повторе сверяются доступ, имя, папка и размер без независимого скачивания байтов.
Один ключ операции закрепляйте за одним событием и сохраняйте неизменным при его повторе вместе со всеми входными данными. Для другого события нужен другой ключ. Случайный новый ключ на каждом запуске допускает дубли. При неизвестном или частичном результате сначала сверяйте фактически созданный объект; не обходите остановку сменой ключа.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.
Как заполнять JSON-поля
Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.
Разрешённые форматы (JSON)
[
"pdf"
]
Непустой массив разрешённых строковых форматов из pdf, png, jpeg, gif, webp, zip. Пример разрешает только PDF; для двух форматов задайте ["pdf","png"]. Это правило процесса, а не автоматически определённый формат файла. Имя и сигнатура переданного содержимого должны ему соответствовать. Пустые [] и {} не задают допустимое разрешение.