Подготовить цепочку папок по ключу операции

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

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

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

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

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

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

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

Поле в настройке	Тип	Обязательность и исходное значение
Корневая папка	Целое число	Обязательное; значение по умолчанию не задано
Относительный путь	Строка	Обязательное; значение по умолчанию не задано
Уникальный ключ операции	Строка	Обязательное; значение по умолчанию не задано

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

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

1. Укажите ID корневой папки, внутри которой разрешено создавать структуру.
2. Введите относительный путь из 1–10 простых имён через /, например Учебные заявки/900/Акты.
3. Согласуйте регистр и написание имён, затем закрепите ключ за одной подготовкой пути.
4. После выполнения используйте итоговый ID папки в сохранении файлов.
5. При конфликте имени сначала просмотрите структуру; файл с таким именем или несколько папок требуют исправления.

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

В папке 50 уже есть единственная папка «Учебные заявки». Для пути Учебные заявки/900 используется она и создаётся недостающая «900». Возвращаются итоговый ID и вся цепочка. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

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

• Итоговая папка: целое число.
• Цепочка ID папок: целое число, список.
• Получен сохранённый результат: да/нет (Y/N).

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

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

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

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

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