Расширение модуля Бизнес-процессы

Для установки модуля нужно:
1) Установить модуль из маркетплейса.
2) В административном разделе портала перейти в пункт меню Бестранк -> Расширение модуля Бизнес-процессов.

Для настройки отображения бизнес-процессов в зависимости от значения поля нужно:
1) В общих настройках выбрать сущности, с которыми хотите работать.
2) В новых пунктах меню включить настройку по изменению отображения списков бизнес-процессов.
3) Выбрать поле, от которого будет зависеть отображение и для каждого значения указать сами бизнес-процессы.

Для настройки отображения бизнес-процессов в групповых действиях:
1) В общих настройках выбрать сущности, с которыми хотите работать.
2) В новых пунктах меню включить настройку по отображению групповых действий.
3) Выбрать бизнес-процессы, которые вы хотите видеть в групповых действиях.

Настройка запуска бизнес-процессов при изменении полей:
1) Перейти в раздел Бестранк -> Расширение модуля Бизнес-процессов -> Обработчик изменения полей CRM и выбрать сущности, в которых хотите отслеживать поля.
2) Перейти в настройки сущности в данном разделе. Если у сущности CRM несколько направлений, то для каждого направления нужно сделать отдельную настройку.
3) Создать "Профиль"  для настроек.
4) Перейти в созданный профиль. Выбрать отслеживаемые поля, тип из заполнения, создание и/или изменение и сам бизнес-процесс.

Настройка запуска бизнес-процессов при изменении полей:
1) Перейти в раздел Бестранк -> Расширение модуля Бизнес-процессов -> Запуск БП при создании дела, в которых хотите отслеживать поля.
2) Перейти в настройки сущности в данном разделе. Если у сущности CRM несколько направлений, то для каждого направления нужно сделать отдельную настройку.
3) Для каждого типа дела в соответствующей вкладке выбрать бизнес-процессы для запуска. Если в бизнес-процессе есть параметры, то можно выбрать параметр, в который будет передан ID созданного дела/комментария.

Активити

Создание файла csv, xls, xlsx

Данное активити позволяет создавать файл формата csv, xls и xlsx, преобразуя данные из json в таблицу.

Разберем доступные настройки подробнее:


1. Выбор формата получаемого файла (csv, xls, xlsx)
2. Название получаемого файла
3. json, из которого будет сформирована таблица, находящаяся в получаемом файле. Обратите внимание - json должен быть корректного формата (см. ниже), иначе настройки сохранить не получится. Также, можно загружать данные через переменную/константу
4. Пример для демонстрации корректного формата json
5. По нажатии на эту кнопку, json из примера подставится в поле "json для преобразования"
6. Тип получаемого файла (файл или файл-диск)
7. Тип получаемой ссылки на файл (html или BB-code)
8. Добавить к ссылке название домена (да или нет)

Разберем получаемые результаты работы активити подробнее:


1. ID файла
2. Ссылка на скачивание
3. Короткая ссылка на файл(диск)
4. Название файла
5. Название файла ссылкой (при клике по названию можно будет скачать файл)
6. Ошибки в работе активити

Пример отображения результатов работы активити в интерфейсе (уведомление пользователю):



Получение заданий сотрудника

Данное активити позволяет получить список ID заданий бизнес-процессов пользователя, отфильтровав их по статусу



1. Выбор сотрудника
2. Выбор статуса бизнес-процесса, откуда будут получены задания сотрудника.
3. Выбор статуса задания

При выборе статусов задания/БП можно задавать несколько значений. Если ничего не выбрано, будут возвращены задания сотрудника со всеми статусами. Для вставки из переменной используйте значения в квадратных скобках


Добавить товарную позицию

Данное активити позволяет добавить товарную позицию в любую сущность CRM, которая поддерживает товарные позиции



1. Тип сущности (на выбор доступны: лид, сделка, смарт-процесс)
2. ID элемента сущности
3. Поля товара


Поиск значений мультиполя CRM элемента

Данное активити позволяет найти контактные записи (эл.почта, сайт, телефон, мессенджер) по заданным параметрам. На выходе возвращает ID найденных записей из таблицы b_crm_field_multi



1. Сущность CRM. На выбор доступны: лид, контакт, компания
2. ID элемента CRM
3. Тип поля. На выбор доступны: телефон, email, сайт, мессенджер
4. Тип контактной информации. Список доступных значений зависит от выбора в "Тип поля"
5. Тип значения. Список доступных значений зависит от выбора в "Тип поля"
6. Значение. Доступны разные вариации: "пустое", "не пустое", "равно", "не равно". При выборе "равно" и "не равно" можно также задать сравнение с точечным значением

Изменить/удалить значение мультиполя CRM по ID

Данное активити позволяет изменить/удалить контактную запись (эл.почта, сайт, телефон, мессенджер) по ID.
При изменении контактной записи на выходе активити доступны все сведения об этой записи: "значение", "тип контактной информации (код/текст)", "тип поля (код/текст)", "тип значения"



1. ID записи
2. Операция (изменить или удалить)
3. Новое значение (доступно только при операции "изменить")
4. Тип контактной информации (доступно только при операции "изменить")


Получить значение мультиполя CRM по ID

Данное активити позволяет получить все поля по ID контактной записи (эл.почта, сайт, телефон, мессенджер)
На выходе активити возвращает:
- ID записи из таблицы b_crm_field_multi
- Сущность CRM
- ID элемента CRM
- Тип поля (код/текст)
- Тип контактной информации (код/текст)
- Тип значения
- Значение



Для поиска необходимо ввести только ID записи. (Его можно получить в том числе и при помощи активити "Поиск значений мультиполя CRM элемента")

Операции с данными

Данное активити позволяет производить набор операций с предоставляемыми данными (массив, json строка, текст).

1) Подсчет количества элементов массива:



- На входе: массив
- На выходе: число (кол-во элементов массива)

2) Убрать элемент массива по значению:



- На входе: массив + значение (поле "элемент")
- На выходе: обновленный массив (без элемента, который убрали по значению)

3) Получить элемент массива по индексу:



- На входе: массив + индекс
- На выходе: значение элемента массива

4) Убрать элемент массива по индексу:



- На входе: массив + индекс
- На выходе: обновленный массив (без элемента, который убрали по индексу)


5) Проверить наличие элемента в массиве:



- На входе: массив + элемент
- На выходе: "Да" или "Нет"


6) Замена по регулярному выражению:



- На входе: любая строка + параметры для замены
- На выходе: строка после произведения замены
- С дополнительными подсказками по настройке можно ознакомиться, перейдя по ссылкам прямо из активити


7) Проверка, что на входе массив:



- На входе: любое значение
- На выходе: Y или N (в зависимости от того, является ли значение массивом)


8) Вычитание массива из массива:



- На входе: массив со вложенным массивом + массив, который нужно вычесть
- На выходе: обновленный массив (после вычета из него указанного массива)


9) Пересечение двух массивов:



- На входе: 2 массива
- На выходе: массив, являющийся пересечением этих двух массивов


10) Унификация массива:



- На входе: массив
- На выходе: унифицированный массив


11) Добавление элемента в массив:



- На входе: массив + элемент, который необходимо добавить
- На выходе: обновленный массив (с добавленным элементом)


12) Преобразовать массив в json строку:



- На входе: массив
- На выходе: json строка, полученная из массива


13) Преобразовать json строку в массив (операция, обратная предыдущей):



- На входе: json строка
- На выходе: массив, полученный из json строки


14) Преобразовать текст в html код:



- На входе: текст
- На выходе: тот же самый текст, в виде html кода

Операции можно использовать в связке друг с другом, в зависимости от требуемого результата.
Например, преобразовать json строку в массив, а затем получить элемент массива по индексу. Для этого можно настроить 2 активити. Первое преобразует json строку в массив, а второе - даст на выходе необходимый элемент


Обработчик изменения полей

Важно: для корректной работы этого блока настроек модуля с шаблонами БП, необходимо в настройках шаблонов отключить автозапуск (и на создание, и на изменение)

Чтобы настроить запуск бизнес-процессов в зависимости от изменения полей, необходимо перейти во вкладку "Бестранк" -> "Расширение модуля бизнес-процессы" -> "Обработчик изменения полей"



Затем нужно выбрать, с какими сущностями будет работать обработчик изменения полей



После нажатия кнопки "Применить" выбранные сущности появятся в левом меню в соответствующей вкладке



Затем в вкладке нужной сущности необходимо создать профиль настроек. Созданный профиль также появится в меню слева. Для продолжения настройки нужно открыть профиль




Вкладка "Настройка профиля"



1. Тип события
На выбор доступно 2 опции: обновление и создание. От выбора зависит, будут настройки срабатывать при создании и/или при изменении элемента

2. Условие запуска
На выбор доступно 2 опции: любое поле и все поля.
"Все поля" - бизнес-процесс запустится только при изменении всех выбранных полей
"Любое поле" - бизнес-процесс запустится при изменении любого из выбранных полей

3. Бизнес-процессы
Выбор, какие шаблоны БП будут запускаться при изменении полей

4. Поля
Выбор полей, при изменении которых будут запускаться бизнес-процессы


Вкладка "Передача полей в параметры" (доступна только при настройке типа события "обновление")



1. Параметр БП, в который будут передаваться коды полей (для выбора доступны только множественные параметры)

2. Параметр БП, в который будут передаваться названия полей (для выбора доступны только множественные параметры)

3. Выбор параметров БП, в которые будут передаваться старые значения полей (отображаются выбранные поля из вкладки "настройка профиля").
Например, в поле "Источник" было значение "Выставка". Затем пользователь изменил значение на любое другое. В выбранный в данной настройке параметр запущенного бизнес-процесса попадет старое значение поля "Источник", то есть, "Выставка"


Вкладка "Настройка полей" (доступна только при настройке типа события "создание")



Здесь можно настроить условие, по которому будет отрабатывать запуск БП при создании элемента. Можно задать одно из двух условий для каждого из выбранных во вкладке "настройка профиля" поля.

Отличное от значения по умолчанию
Бизнес-процесс при создании элемента будет запущен, только если значение в поле отличается от того, что задано по умолчанию

Не пустое
Бизнес-процесс при создании элемента будет запущен всегда, когда поле не пустое


Запуск бизнес-процессов по делам

Важно: для корректной работы этого блока настроек модуля с шаблонами БП, необходимо в настройках шаблонов в отключить автозапуск (и на создание, и на изменение)

Чтобы настроить запуск бизнес-процессов в зависимости от изменения/создания дел, необходимо перейти во вкладку "Бестранк" -> "Расширение модуля бизнес-процессы" -> "Запуск бизнес-процессов по делам"



Необходимо выбрать сущности CRM, для которых будет активен запуск бизнес-процессов по делам. Выбранные сущности после нажатия кнопки "Применить" отобразятся в соответствующей вкладке в левом меню. Для продолжения настроек нужно перейти в появившийся пункт





Во вкладках сверху (красный цвет на скриншоте) нужно выбрать дело, для которого будут заданы настройки

Настройки можно задать отдельно для создания дела (синий цвет на скриншоте) и для изменения дела (фиолетовый цвет на скриншоте)

Список доступных настроек идентичен как для создания, так и для изменения дела



1. Выбор запускаемых бизнес-процессов (можно выбрать несколько шаблонов с помощью клавиши ctrl, или зажав кнопку мыши)

2. Выбор параметра, в который попадет ID измененного/созданного дела (при желании, можно не выбирать никакой параметр)


Поиск шаблонов бизнес-процессов

Для того, чтобы перейти к поиску шаблонов бизнес-процессов, необходимо открыть соответствующую страницу в настройках модуля в блоке "Поиск и Аналитика":



Для того, чтобы настроить фильтр, по которому будут найдены шаблоны бизнес-процессов, необходимо кликнуть на "Фильтр + поиск":




Поиск по активити

Чтобы получить шаблоны бизнес-процессов, в которых есть нужное активити, выберите активити во вкладке "Название активити". Также, можно выбрать, включено активити или выключено. (Искать можно также отдельно как по активности, так и по названию активити). После этого кликните "Найти.



После этого будет доступен список всех бизнес-процессов согласно выставленному фильтру:



1. Здесь можно настроить поля, которые будут отображаться в списке
2. Кликабельная ссылка на шаблон бизнес-процесса
3. Кликабельная ссылка на сущность, на которой настроен шаблон бизнес-процесса
4. Названия активити в шаблоне БП, тоже кликабельные (ссылка ведет на шаблон бизнес-процесса)
5. Количество искомых активити в шаблоне бизнес-процесса


Поиск по названию глобальной константы/переменной

Чтобы получить шаблоны бизнес-процессов, в которых есть нужная глобальная константа/переменная, выберите глобальную константу/переменную во вкладке "Название глобальной константы" или "Название глобальной переменной". После этого кликните "Найти"



После этого будет доступен список всех бизнес-процессов, в которых содержится выбранная глобальная константа/переменная:



1. Здесь можно настроить поля, которые будут отображаться в списке
2. Кликабельная ссылка на шаблон бизнес-процесса
3. Кликабельная ссылка на сущность, на которой настроен шаблон бизнес-процесса
4. Названия активити, в которых используется искомая глобальная константа/переменная
5. Количество активити с искомой глобальной константой/переменной в шаблоне БП

Примечание:
Если настроить фильтр одновременно и по активити, и по глобальной константе/переменной, то будут отобраны только шаблоны бизнес-процессов, в которых есть искомое активити + в этом активити используется искомая глобальная константа/переменная:







Поиск по типу параметра/константы/переменной

Чтобы получить шаблоны бизнес-процессов, в которых есть параметр/константа/переменная нужного типа, выберите в фильтре нужный тип параметра/константы/переменной (Выбор доступен из типов, которые созданы в любом из шаблонов на портале. Константа/переменная должна содержаться в каком-либо активити). После этого кликните "Найти"




После этого будет доступен список всех бизнес-процессов, в которых содержатся выбранный тип параметра/константы/переменной:



1. Здесь можно настроить поля, которые будут отображаться в списке
2. Кликабельная ссылка на шаблон бизнес-процесса
3. Кликабельная ссылка на сущность, на которой настроен шаблон бизнес-процесса
4. Названия активити, в которых используется искомая глобальная константа/переменная
5. Количество активити с искомой глобальной константой/переменной в шаблоне БП


Аналитика истории работы бизнес-процессов

Данная функция, обращаясь к таблице b_bp_tracking, позволяет отследить, в какое время какие бизнес-процессы были запущены на портале.

Для того, чтобы начать работу с аналитикой истории работы бизнес-процессов, перейдите в соответствующую вкладку в разделе "Бестранк" -> "Расширение модуля бизнес-процессы"-> "Поиск и аналитика" -> "Аналитика истории работы бизнес-процессов".

Далее в фильтре необходимо задать Дату начала и Дату окончания периода, по которому будут отобраны запущенные бизнес-процессы. Можно выбрать и дату, и время. Затем кликните "Найти".

Важно:

• Если не заполнено поле "Дата начала", то она автоматически будет "-1ч от Даты окончания"
  
• Если не заполнено поле "Дата окончания", то она автоматически будет "+1ч от Даты начала"
  

Это сделано во избежание слишком большой выборки и последующей усиленной нагрузки на систему.



После сохранения фильтра на странице отобразится список запущенных бизнес-процессов, согласно выставленному промежутку времени:



1. Здесь можно настроить поля, которые будут отображаться в списке
2. Кликабельная ссылка на шаблон бизнес-процесса
3. Кликабельная ссылка на сущность, на которой настроен шаблон бизнес-процесса
4. Количество запущенных бизнес-процессов за указанный промежуток времени
5. Количество записей в таблице b_bp_tracking за указанный промежуток времени
6. Количество активити в шаблоне бизнес-процесса
7. Количество включенных активити в шаблоне бизнес-процесса на момент поиска


Бизнес-процессы в делах таймлайна

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



Перейдем в окно создания правила:




1. Активность правила
2. Выбор типа дела
3. Выбор типа сущности (на выбор доступны все сущности CRM)
4. Ссылка на выбранную сущность CRM
5. Название для пункта с запуском бизнес-процессов в контекстном меню дела
6. Выбор шаблонов бизнес-процессов, которые будут отображаться в контекстном меню дел в таймлайне элемента выбранной сущности
7. Если в каком-то из выбранных шаблонов бизнес-процессов есть параметр/ы с типом "строка", "число" или "целое число", то можно выбрать, в какой из параметров БП будет передан ID дела, из контекстного меню которого был запущен бизнес-процесс.
8. Ссылка на шаблон бизнес-процесса
9. Название для бизнес-процесса в контекстном меню дела

Все созданные правила отображаются в общем списке правил (в нем по умолчанию доступны фильтр, сортировка, а также выбор отображаемых полей):




1. Контекстное меню. С помощью него можно изменить или удалить правило
2. Фильтр
3. Ссылка на сущность CRM
4. Ссылка на шаблон бизнес-процесса

Чтобы запустить бизнес-процесс согласно настроенному правилу, перейдем в публичную часть и откроем элемент одной из сущностей, на которой мы настроили правило:




Откроем контекстное меню и увидим, что там появился пункт "Новый бизнес-процесс", а в нем - выбранный шаблон бизнес-процесса. Чтобы запустить бизнес-процесс, достаточно кликнуть по нему.