Запуск БП по выборке с журналом

Бизнес-процесс уже собран и работает в одной карточке, а применить его нужно к сотням или тысячам записей: сменить ответственного, заполнить поле, поставить задачи, разослать напоминания. Приложение запускает готовый шаблон по всем записям, которые попали под фильтр, и ведёт журнал: по каждой записи видно, запустился процесс или нет и почему.

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

Четыре шага. Выберите сущность: лиды, сделки, контакты, компании, предложения, счета или любой смарт-процесс. Найдите шаблон бизнес-процесса по названию или ID. Задайте фильтр из нескольких условий по полям сущности, включая пользовательские. Укажите размер пачки и паузу и запустите.

Фильтр и счётчик. Условия подбираются под тип поля: текст (содержит, равно, начинается с), числа и даты (больше, меньше, равно), списки и стадии (любое из, ни одно из), сотрудники, да или нет, заполнено или не заполнено. Можно запустить процесс по готовому списку ID. Число найденных записей видно сразу и пересчитывается после каждого изменения условий.

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

Пачки, пауза, остановка. Запуск идёт пачками от 1 до 50 записей с паузой от 0 секунд, порядок от старых записей к новым или наоборот. Видно, сколько запущено, сколько ошибок, сколько осталось и примерное время до конца. Запуск можно остановить и продолжить с того же места, а между делом поменять размер пачки и паузу. Если портал ограничил частоту запросов, приложение само ждёт и продолжает.

Журнал и повтор ошибок. По каждой записи в журнале: результат, ID запущенного процесса или причина ошибки понятными словами (запись удалена, шаблон для другой сущности, нет прав). Кнопка «Повторить только ошибки» запускает процесс заново только по неудачным записям, успешные не трогает. Журнал целиком или только ошибки выгружаются в CSV для Excel со ссылками на записи.

Защита от двойного запуска. Если связь оборвалась и портал не ответил, приложение не отправляет пачку повторно само: такие записи помечаются «нет подтверждения», и вы решаете, повторять ли их, после проверки карточки.

Параметры шаблона. Если у шаблона есть параметры, приложение покажет форму: строка, текст, число, да или нет, список, сотрудник, дата. Значения одинаковы для всех записей запуска. Параметры других типов (например, файл) приложение не заполняет: если такой параметр обязателен, шаблон запустить нельзя.

Ограничения и условия.

1. Нужен тариф Битрикс24, на котором есть бизнес-процессы: в облаке «Профессиональный» и выше.

2. Приложением пользуется администратор портала: читать список шаблонов и запускать процессы через приложения портал разрешает только ему.

3. Приложение работает в браузере: страницу нужно держать открытой до конца запуска. Если её закрыть или перезагрузить, запуск встанет на паузу, после возвращения его можно продолжить.

4. Приложение запускает только готовые шаблоны из дизайнера бизнес-процессов. Роботы стадий в список не попадают.

5. Бизнес-процесс выполняет реальные действия: меняет поля, ставит задачи, отправляет сообщения. Отменить уже запущенные процессы приложение не может. Сначала проверьте шаблон на нескольких записях.

6. За один запуск обрабатывается до 50 000 записей, остальные добираются следующим запуском. Скорость зависит от веса шаблона, размера пачки и паузы.

7. Расписания нет: запуск начинается только по кнопке.

Данные. Своего сервера и базы у приложения нет: оно работает в браузере внутри портала, содержимое CRM никуда не отправляется. Чтобы запуск можно было продолжить после перезагрузки страницы, в хранилище браузера сохраняется служебное состояние текущего запуска: ID записей, результаты и ID процессов, без названий записей. Оно удаляется кнопкой «Новый запуск». Единственный внешний запрос: при открытии вкладки «Другие приложения» приложение один раз читает список наших приложений, не передавая данных портала и пользователя; если запрос не прошёл, показывается копия списка из архива. Приложению нужны права на CRM, бизнес-процессы и имена сотрудников. Отдельной оплаты нет, нужна подписка на Битрикс24 Маркетплейс.