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