Прикрепить подготовленный файл к задаче по ключу операции

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

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

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

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

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

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

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

Поле в настройке	Тип	Обязательность и исходное значение
ID задачи	Целое число	Обязательное; значение по умолчанию не задано
ID папки вложений	Целое число	Обязательное; значение по умолчанию не задано
Полное имя файла	Строка	Обязательное; значение по умолчанию не задано
Содержимое Base64	Текст	Обязательное; значение по умолчанию не задано
Разрешённые форматы: JSON	Текст	Обязательное; значение по умолчанию не задано
Уникальный ключ операции	Строка	Обязательное; значение по умолчанию не задано

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

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

1. Укажите ID задачи и доступной папки Диска для хранения вложения.
2. Передайте полное имя с расширением и уже подготовленное содержимое Base64. Путь к файлу на компьютере вместо содержимого не подходит.
3. Задайте массив разрешённых форматов, например ["pdf"] для процесса с PDF.
4. Закрепите уникальный ключ за одним вложением конкретного события.
5. Сохраняйте отдельно ID файла Диска и ID привязки: это разные результаты. Передавайте нужный из них следующему действию.

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

Для задачи 410 и папки 50 переданы имя act.pdf, корректное Base64 подготовленного PDF, разрешённый формат ["pdf"] и ключ task-410-act-v1. При успехе возвращаются файл Диска и его отдельная привязка к задаче, размер и контрольная сумма входных данных. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

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

• ID файла Диска: целое число.
• ID привязки к задаче: целое число.
• Размер переданных данных: целое число.
• SHA-256 переданных данных: строка.
• Получен сохранённый результат: да/нет (Y/N).

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

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

Максимальный размер: 5 МиБ. Проверяются расширение и начальная сигнатура; это не антивирусная проверка. Загрузка и привязка происходят последовательно, поэтому после ошибки файл может остаться в папке. При повторе проверяются доступ и сохранённая привязка.

Один ключ операции закрепляйте за одним событием и сохраняйте неизменным при его повторе вместе со всеми входными данными. Для другого события нужен другой ключ. Случайный новый ключ на каждом запуске допускает дубли. При неизвестном или частичном результате сначала сверяйте фактически созданный объект; не обходите остановку сменой ключа.

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

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

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

Разрешённые форматы: JSON

[
  "pdf"
]

Непустой массив разрешённых строковых форматов из pdf, png, jpeg, gif, webp, zip. Пример разрешает только PDF; для двух форматов задайте ["pdf","png"]. Это правило процесса, а не автоматически определённый формат файла. Имя и сигнатура переданного содержимого должны ему соответствовать. Пустые [] и {} не задают допустимое разрешение.