Создать рабочую копию файла по ключу операции
Робот «Создать рабочую копию файла по ключу операции». Копирует существующий файл в выбранную папку и защищает повторный запуск от второй отправки.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для координатора, которому нужна рабочая копия согласованного файла в папке процесса. Позволяет сохранить оригинал и не создавать вторую копию при повторе того же события.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID исходного файла | Целое число | Обязательное; значение по умолчанию не задано |
| ID целевой папки | Целое число | Обязательное; значение по умолчанию не задано |
| Уникальный ключ операции | Строка | Обязательное; значение по умолчанию не задано |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите ID исходного файла Диска и ID папки назначения.
- Проверьте отсутствие объекта с тем же именем в целевой папке: копия сохраняет исходное имя.
- Задайте ключ операции до 200 символов, связанный с одной рабочей копией.
- Используйте ID копии, а не исходного файла, в следующих действиях работы с результатом.
- При ошибке создания сначала просмотрите целевую папку, прежде чем планировать повтор.
Учебный пример и ожидаемый результат
Файл 700 brief.pdf копируется в папку 50 с ключом deal-900-brief-copy-v1. При успехе возвращается новый ID рабочей копии и папка 50. Исходный файл остаётся на месте. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- ID рабочей копии: целое число.
- ID папки копии: целое число.
- Получен сохранённый результат: да/нет (Y/N).
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Совпадение имени в папке: ошибка, а не замена файла. Доступ, папка, размер, имя и время изменения сверяются повторно. Изменение содержимого при прежних метаданных не обнаруживается. Другие процессы не блокируются; неизвестный результат не отправляется повторно автоматически.
Один ключ операции закрепляйте за одним событием и сохраняйте неизменным при его повторе вместе со всеми входными данными. Для другого события нужен другой ключ. Случайный новый ключ на каждом запуске допускает дубли. При неизвестном или частичном результате сначала сверяйте фактически созданный объект; не обходите остановку сменой ключа.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.