Модуль позволяет создавать агенты (периодические функции) для запуска бизнес-процессов для различных сущностей системы.
Генератор агентов для запуска бизнес-процессов станет незаменимым помощником, если вам необходимо: - запускать бизнес-процесс один раз с заданной периодичностью, например, каждый день; - запускать бизнес-процесс в определенную дату, например, раз в год поздравлять клиентов с днем рождения; - автоматизировать запуск бизнес-процесса на рутинные процессы, такие, как увольнение сотрудников; и мн. др.
После стандартной установки модуля в разделе меню "Бестранк" административной части сайта появится пункт Генератор агентов для запуска бизнес-процессов.
Общие настройки
Во вкладке "общие настройки" необходимо выбрать сущности, для которых будет возможным создание агентов и дальнейшая их настройка.
После выбора сущностей они появятся в левом меню. Чтобы создать агенты, нужно перейти в соответствующий пункт.
Создание агентов Для того, чтобы создать агент, нужно заполнить пару полей - код и название (выбор воронки доступен для сделок и смарт-процессов).
После того, как добавлен хотя бы 1 агент, в левом меню появится пункт "Настройки агентов". Необходимо перейти в него для продолжения настроек.
Настройки агентов
Разберем каждый пункт настроек агента по порядку:
1. Активность агента. Агент не будет срабатывать при отключенной галочке.
2. Ссылка на агент. Здесь можно посмотреть дополнительную информацию об агенте в системе (дату последнего запуска, дату следующего запуска и т.д.).
3. Частота выполнения. Определяет, с какой частотой (в секундах) будет срабатывать агент.
4. Дата запуска. Определяет дату первого запуска агента.
5. Время запуска. Определяет время первого запуска агента. (В случае, если дата и время первого запуска находятся в прошлом, первый запуск агента произойдет согласно интервалу частоты выполнения, отталкиваясь от даты и времени, указанных в настройках выше).
6. Ограничение кол-ва элементов за один шаг. Определяет максимум, на скольких элементах за 1 шаг будет запущен бизнес-процесс. Пока агент срабатывает на затронутых шагом элементах, на остальных элементах, не входящих в шаг, БП запущен не будет. Рекомендуется использовать эту настройку при большом количестве (оно может быть разным в зависимости от объемности бизнес-процесса) элементов, на которых ориентировочно будет срабатывать агент.
7. Ссылка на список элементов сущности, для которой настраивается агент.
8. Шаблон бизнес-процесса. Определяет шаблон бизнес-процесса, который будет запущен с помощью настраиваемого агента.
9. Сайт, на котором запускается бизнес-процесс.
10. Ссылка на выбранный шаблон бизнес-процесса.
11. Фильтр + поиск.
Здесь можно задать фильтр, по которому будут отбираться элементы для запуска бизнес-процесса на них.
На выбор доступны все поля, имеющиеся в сущности.
Фильтр аналогичен штатному фильтру в гриде/канбане сущности.
Фильтр можно задать сразу по нескольким полям.
Чтобы подтвердить выбранные в фильтре настройки, нужно кликнуть "найти".
Чтобы удалить все выбранные в фильтре настройки, нужно кликнуть "сбросить".
В случае, если не задан ни один фильтр, бизнес-процесс запустится на всех элементах сущности.
12. Показать список отфильтрованных элементов.
Здесь можно увидеть элементы, которые были отфильтрованы на основе заданных значений в пункте "фильтр + поиск".
Перед этим необходимо нажать "Сохранить".
При нажатии откроется список отфильтрованных элементов.
Разберем его подробнее:
1. В данном списке, как и в списке самой сущности, доступен переход к детальному просмотру кликабельных значений полей.
2. Ссылка на список всех элементов сущности в публичной части портала.
3. Обновить данные. Эта функция позволяет актуализировать список отфильтрованных элементов, если в процессе работы с элементами некоторые из них стали подходить под заданные настройки в фильтре, или наоборот - перестали.
Дополнительный фильтр
В данном модуле также предусмотрен дополнительный фильтр. Рекомендуется использовать его для более вариативной работы с полями типа "дата", т.к. в нем можно прописать текстовые настройки для фильтра по этому полю, например, "-60 day" - в этом случае агент будет запущен за 60 дней до значения, указанного в поле. Дополнительно можно ознакомиться в разделе "Справка".
1. Если стоит галочка, то дополнительный фильтр не будет работать.
2. Выбор полей для фильтрации.
3. Значения для фильтра по выбранным полям.
4. Справка (для работы с интервалами от указанных дат).
Агенты по дате завершения/начала дела
Этот блок настроек позволяет создавать правила для автоматического запуска шаблона бизнес-процесса при наступлении даты начала или окончания дела.
Разберем доступный функционал:
1. Фильтр для отбора нужных правил по полям . 2. Кнопка для перехода к созданию нового правила.
3. Все созданные правила отображаются в формате списка (доступен выбор отображаемых полей, сортировка, перетаскивание столбцов, контекстное меню, постраничная навигация и другие штатные возможности работы со списками).
Разберем подробнее настройки при создании/редактировании правила
1. Перейти назад к списку правил.
2. Активность правила.
3. Тип даты для проверки. (На выбор доступны 2 варианта: дата окончания дела и дата начала дела).
4. Тип сущности. (На выбор доступны все сущности CRM).
5. Ссылка на выбранную сущность CRM.
6. Выбор шаблона запускаемого бизнес-процесса. (На выбор доступны шаблоны, созданные на выбранной CRM-сущности).
7. Ссылка на выбранный шаблон бизнес-процесса.
8. Выбор параметра, в который будет передан ID дела при запуске бизнес-процесса. (На выбор доступны параметры с типом "строка" и "число")
9. Здесь можно выбрать тип дела, для которого будет работать правило.
10. Здесь можно выбрать, будут ли запускаться бизнес-процессы для дел, которые помечены как выполненные.
Примеры кейсов в работе с модулем
1. Нужно запускать какой-то БП один раз с заданной периодичностью, например, каждый день.
Решение: нужно задать такой фильтр, чтобы проходил только один элемент (например, сделать отдельное поле и заполнить его, фильтр задать на значение поля) или запускать генератор на сущности, имеющей только один элемент.
2. Нужно запускать БП в определенную дату раз в год, у каждого элемента сущности дата своя. Например, мы хотим поздравлять наших клиентов с днем рождения и для этого заполняем в контакте поле с датой.
Решение: создать поле типа Дата для хранения даты следующего дня рождения (не даты рождения). В бизнес-процессе задать увеличение даты на год при срабатывании. Фильтр генератора агентов установить на День рождения = сегодня, частота срабатывания - раз в день. В итоге БП будет запускаться только на тех элементах, где дата следующего дня рождения = сегодня, выполнять заданные действия и увеличивать дату на год для следующего запуска процесса агентом.
Еще пример: мы хотим удалять элементы списка, хранящиеся больше какого-то срока (например, 3 месяцев).
Решение: в элементах списка заводим поле с датой удаления, при создании заполняем его по формуле Дата создания + 3 месяца, фильтр генератора агентов настраиваем на Дата удаления = сегодня.
3. На портале есть список заявлений на увольнение, за день до увольнения мы хотим запускать бизнес-процесс.
Решение: в списке заявлений указываем дату увольнения, фильтр генератора агентов настраиваем на Дата увольнения = завтра.
4. Нужно запускать БП каждый месяц в определенный день. Например, 15 числа.
Решение: первым порывом будет указать просто периодичность запуска агента - месяц, но интервал выражается фиксированным числом, а количество дней в месяцах разное. Если сделать так, дата запуска будет сдвигаться от месяца к месяцу. Поэтому здесь нам тоже нужно менять дату из самого БП, фильтр выставлять на дату запуска = сегодня, периодичность - раз в день.
1.3.1, 09.04.2025
Исправлено: -проверка заполненности шаблона бизнес-процесса в правилах
1.3.0, 25.02.2025
Добавлено:
Возможность создавать агенты дате завершения/начала дела в CRM сущностях
1.2.12, 19.02.2025
Добавлена информация в настройки агента о том кто создал и кто обновил
1.2.11, 13.11.2024
Поправлена ошибка запуска агента в фоновом режиме
1.2.10, 18.10.2024
Поправлен баг с фильтрацией полей дата, привязка элементов, привязка к элементам и др.
1.2.9, 19.09.2024
Исправление в фильтре связанные со стадией, во время выборки элементов CRM
1.2.8, 11.09.2024
Поправлена php ошибка
1.2.7, 27.08.2024
Поправлен баг запуска бп с помощью агентов после обновления битрикса
Поправлены ссылки в администрировании инфоблоков и фильтрация
Поправлен баг сортировки в предпросмотре
Улучшено логирование ошибок
1.2.6, 01.08.2024
Исправлена ошибка работы страницы в административной панели списка агентов
Исправление ошибок php
1.2.5, 11.06.2024
Проверка что фильтр должен быть не пустой
1.2.4, 31.05.2024
Поправили блокировку двойного запуска агента
1.2.3, 27.04.2024
Поправили определение времени запуска для агента
1.2.2, 16.04.2024
В фильтр добавлен конвертер дат для относительных форматов
Для инфоблоков в фильтр добавлен конвертер даты для св-в
Исправлена ошибка работы доп.фильтра
Добавлены доработки для стабилизации запуска на больших объемах элементов
1.2.1, 05.04.2024
Добавлена фильтрация по значению не задано для списков в новом фильтре
Добавлено в новом фильтре задание ID по диапазону
Поправлен баг с отображением в гриде для старого фильтра
Поправлен баг отображения значений в гриде с полем типа список
1.2.0, 03.04.2024
Добавлена возможность выбора сайта на котором запускается бизнес-процесс
1.1.4, 02.04.2024
Поправили ошибку при запуске бизнес-процесса из активити
1.1.3, 25.03.2024
Поправили фильтрацию булевых полей и фильтрацию в смарт-процессах
1.1.2, 22.03.2024
Убрал ошибку при запуске агентов в crm
Уменьшили нагрузку на сайт при запуске агентов
Подправили предпросмотр отобранных значений
1.1.1, 18.03.2024
Исправлен баг с постраничной навигацией при использовании грида
Исправлен баг с отображением всех записей в гриде
Исправление обновления модуля(не скопировалась библиотека js gridlib)
1.1.0, 29.02.2024
Добавлен новый фильтр
1.0.11, 27.10.2023
Поправили задвоение запуска агентов при пошаговой генерации
1.0.10,
Поправили меню с профилем в CRM
1.0.9, 14.09.2023
Поправили ошибки php
1.0.8, 24.08.2023
Поправил отображение списков в гриде
1.0.7, 15.08.2023
Добавлена кнопка которая показывает, какие элементы подходят под Ваши условия при выбранных параметрах объекта
1.0.6, 20.07.2023
Исправлена ошибка с воронками в настройках админки
1.0.5, 02.11.2022
Исправлена ошибка работы со стадиями в СП
1.0.4, 26.10.2022
Правки ленг файлов
1.0.3, 18.10.2022
Мелкие исправления настроек модуля
1.0.2, 20.05.2022
Исправлен вывод агента в меню админки (теперь при отсутствии названия выводится код)
Добавлена возможность удаления агентов + мелкие исправления ошибок
1.0.1, 20.05.2022
Добавлена настройка времени запуска агентов
Исправлены ошибки формирования меню и отображения страниц настроек в админке
По вопросам технической поддержки обращайтесь на email info@bestrank.ru