Робот срабатывает один раз, а работы ровно столько, сколько строк в документе: десять позиций в счёте, пять контактов у компании, сорок сделок под условие отбора. Приложение ставит на портал робот «Конструктор цикла»: он берёт коллекцию, отбирает нужные элементы и выполняет на каждом одно действие. Настройка помещается в одну карточку робота.
Пока работа измеряется документом, штатных роботов хватает. Как только она измеряется его содержимым — позициями, связанными записями, отобранными сущностями, — автоматизация упирается.
Робот Битрикс24 выполняет действие один раз за срабатывание. В сделке десять позиций и на каждую нужна своя задача — штатному роботу это выразить нечем.
Приходится собирать счётчик, переменные и возврат на предыдущий шаг автоматизации. Такую конструкцию тяжело читать, тяжело менять и почти невозможно разобрать, когда она сработала не так.
Второй обычный выход — бизнес-процесс, но дизайнер БП есть не на каждом портале. Тогда повторяющаяся часть работы либо не автоматизируется вовсе, либо делается сотрудником по памяти: часть позиций теряется, часть задач не ставится.
В автоматизации появляется робот «Конструктор цикла». Вы указываете, что перебирать, какие элементы брать и что делать на каждом. Пока цикл идёт, шаг ждёт; по окончании итоги возвращаются в автоматизацию и доступны следующим шагам наравне с полями документа.
Строки товаров текущего элемента, связанные сущности, список значений, строки из текста по разделителю, диапазон чисел, выборку сущностей по фильтру — либо режим «ничего, повторять с интервалом».
Необязательный отбор: поле элемента, условие и значение. Не прошедшие отбор элементы не обрабатываются, но видны в журнале со статусом «пропущен».
Задача, сообщение, обновление поля, HTTP-запрос, запуск готового бизнес-процесса, сценарий приложения или сборка значений в текст. Рядом — блок «Ограничения и темп».
Все примеры собираются в карточке робота, а многошаговые — в разделе приложения «Сценарии».
Источник «Строки товаров текущего элемента», действие «Создать задачу» с названием вида «Заказать {{item}} — {{item.quantity}} шт.». Задачи можно привязать к карточке сделки или счёта. Работает у сделок, лидов, счетов (новых), предложений и смарт-процессов с включёнными товарами.
Робот перебирает товарные строки, отбирает нужные и действием «Ничего — только собрать значения» складывает их в один текст. Саму задачу создаёт следующий шаг — штатный робот Битрикс24: в его описание вставляется выходное значение «Собранный текст (списком, для описания)».
Источник «Связанные сущности» — контакты, компании, сделки, дела, задачи, элементы смарт-процесса документа. Действие «Отправить сообщение» с получателем «Ответственному за элемент коллекции»: каждый получает уведомление по своему элементу.
Источник «Выборка сущностей по фильтру» с условиями вида «>OPPORTUNITY=10000» и действие «Обновить поле сущности» — обновляется каждый отобранный элемент. Источник доступен для сделок, лидов, контактов, компаний и задач; условия отбора обязательны.
Режим «Ничего — повторять с интервалом»: число повторов, интервал от 10 минут до недели и условие остановки по полю документа. Поле перечитывается перед каждым повтором, поэтому лишние напоминания не уходят.
Действие «Запустить бизнес-процесс» по ID готового шаблона портала — с параметрами, ожиданием завершения и ограничением числа одновременно работающих процессов. На самом элементе коллекции процесс запускается, если элемент — сделка, лид, контакт или компания; иначе шаблон запускается на текущем документе столько раз, сколько элементов в коллекции.
Раздел «Сценарии»: до 20 шагов — задача, сообщение, обновление поля, HTTP-запрос, запуск бизнес-процесса, — у каждого шага необязательное условие по полю элемента. Например: на каждую строку товара поставить задачу закупщику, а если сумма позиции больше 100 000 — дополнительно написать руководителю.
Действие «Отправить HTTP-запрос»: метод, адрес, тело (JSON или строка) и заголовки, в адресе и теле работают подстановки. Коды ответов возвращаются в автоматизацию, начало тела ответа сохраняется в журнале.
Журнал прогонов и карточка прогона: элемент, статус, число попыток, идентификатор результата или текст ошибки, переключатель «только ошибки» и кнопка «Остановить прогон». Временные ошибки портала повторяются автоматически, но не более трёх раз.
Семь источников коллекции, отбор элементов, семь действий на элементе, десять выходных значений и поэлементный журнал прогонов.
Коллекцией становится содержимое самого документа либо ваши собственные данные.
Необязательный блок «Какие элементы брать»: поле элемента, условие, значение.
На каждом элементе коллекции выполняется одно выбранное действие либо сценарий приложения.
Итоги прогона доступны следующим шагам автоматизации наравне с полями документа.
Сбой разбирается поэлементно, а не догадками.
Форма настроек открывается прямо в карточке робота вместо стандартного списка свойств.
Сделки, счета (новые), предложения и смарт-процессы, где в документе несколько строк товаров и по каждой нужна своя задача, своё уведомление или своя строка в сводном тексте: закупка, комплектация, производство под заказ, позаказная работа подрядчика.
Порталы, где у документа несколько контактов, компаний, дел, задач или элементов смарт-процесса, и каждый связанный элемент имеет собственного ответственного, которому нужно адресное уведомление.
Там, где БП недоступны, тело цикла собирается прямо в приложении в разделе «Сценарии»: до 20 шагов с условиями по полю элемента.
Массовое обновление поля у выборки сделок, лидов, контактов, компаний или задач по условиям отбора, а также HTTP-запрос во внешнюю систему на каждый элемент.
Приложение опирается на штатные механизмы портала: автоматизацию, задачи, сообщения, поля сущностей и шаблоны бизнес-процессов. Вне портала оно не работает — показывается «Нет контекста портала».
Автоматизация CRM (роботы) и выданный приложению доступ. Дизайнер бизнес-процессов не нужен — приложение как раз закрывает порталы без него.
О чём стоит знать до установки — это следует из устройства приложения, а не из тарифа.
Чтобы ожидания совпали с продуктом.
Во всех исходах, включая падение прогона, управление возвращается в автоматизацию — документ не остаётся навсегда стоять на шаге робота. Темп прогона выбирается настройкой «Быстро», «Обычно» или «Бережно», чтобы массовая обработка не била по порталу.
После установки в автоматизации любого доступного типа документа появляется шаг, который умеет то, чего в роботах нет.
Установите приложение · поставьте робот «Конструктор цикла» на нужную стадию · действие выполнится столько раз, сколько в документе позиций, связанных записей или отобранных сущностей