Kernel
Plugins
Решения
CHANGES
Может использоваться в простых типовых случаях, без необходимости написания динамического кода. Позволяет гибко ограничивать в конфигурации правила правки процессов и автоматически выполняемые с ними операции.
Реализуется одним или несколькими правилами в конфигурации типа процесса вида:
onProcessEvent.<n>.events=<events>
onProcessEvent.<n>.eventsExclude=<eventsExclude>
# обязателен хотя бы один из двух
onProcessEvent.<n>.doExpression=<doExpression>
onProcessEvent.<n>.commands=<commands>
# необязательные параметры
onProcessEvent.<n>.ifExpression=<ifExpression>
onProcessEvent.<n>.checkExpression=<checkExpression>
onProcessEvent.<n>.checkErrorMessage=<checkErrorMessage>Где:
<n> - ordered int rule’s number;
<events> - обрабатываемые правилом события через точку с запятой, если параметр не указывается - то обрабатываются все события связанные с данным типом процесса;
<eventsExclude> - исключаемые из обработки правилом события через точку с запятой, если параметр не указывается - то никакие событие не исключаются;
<ifExpression> - JEXL выражение проверки условия при котором отрабатывают команды макроса;
<checkExpression> - JEXL выражение проверки условия при невыполнении которого генерируется ошибка <checkErrorMessage>, используется только с checkErrorMessage;
<checkErrorMessage> - текст ошибки, сообщаемой при невыполнении условия <checkExpression>;
<commands> - команды макроса обработки;
<doExpression> - выполняемый JEXL скрипт, более гибкий аналог <commands>.
В <events> поддержаны следующие события:
| Event | Description | event class |
|---|---|---|
statusChanging:<statusIds> |
Cтатус изменяется на одно на одно из значений, коды которых указаны через запятую в <statusIds> |
|
descriptionAdding |
В описание процесса добавляется текст. |
|
descriptionChanging |
Описание процесса изменяется целиком. |
|
executorsChanging |
Изменяются исполнители процесса. |
|
linkAdding |
К процессу добавляется привязка. |
|
linkRemoving |
Удаляется привязка процесса. |
|
paramChanging:<paramIds> |
Изменяется параметр процесса, код которого указан через запятую в <paramIds>. |
|
statusChanged:<statusIds> |
Cтатус изменился на одно из значений, коды которых указаны через запятую в <statusIds> |
|
created |
Process was created. |
|
createFinished |
Завершено создание процесса в мастере |
|
createdAsLink |
Процесс создан как привязанный к другому процессу. |
|
removed |
Process was removed. |
|
descriptionAdded |
В описание процесса добавлен текст. |
|
descriptionChanged |
Описание процесса изменилось целиком. |
|
executorsChanged |
Изменились исполнители процесса. |
|
linkAdded |
К процессу добавлена привязка. |
|
linkRemoved |
Удалена привязка процесса. |
|
messageAdded |
В процесс поступило новое сообщение. |
|
paramChanged:<paramIds> |
Изменился параметр процесса, код которого указан через запятую в <paramIds>. |
События *ing отличаются от *ed событий тем, что они гененрируются до момента записи в БД.
В JEXL процессор передаётся типовой набор объектов для обработки процесса плюс:
event - объект события, расширяющий класс ru.bgcrm.event.UserEvent.
Правила просматриваются в порядке их номеров. Первое правило выдавшее сообщение прерывает просмотр и отменяет изменение связанное с процессом.
В <commands> указывается макрос обработки процесса, состоящий из команд, разделённых точкой с запятой. Все команды макроса выполняются последовательно и в рамках текущей транзакции. Ошибка в любой из команд прерывает текущую транзакцию, откатывая внесённые в БД изменения.
|
Более гибким и рекомендуемым способом выполнения команд является использование JEXL выражений с помощью doExpression. Обратите внимание на примеры. Значительная часть команд ядра может быть заменена вызовами функций из ru.bgcrm.dao.expression.ProcessChangeFunctions. |
Уведомить о изменение процесса исполнителей, за исключением пользователя, иницировавшего событие, посредством сообщения (простого или всплывающего) в новости.
<subject> - начало темы новости, если не указано - то "Изменился процесс".
Продолжение темы новости генерируется с помощью макроса описаний. Первым ищется описание с ключом newsNotifySubject, затем processCard. Если описание не найдено то добавляются наименование типа и код процесса.
Установить в процесс исполнителей, коды которых указаны через запятую в <executorIds>. Исполнители привязываются к одной группе процесса, код которой попадает в перечень указанный в <groupIds> через запятую, существующие исполнители заменяются.
Аналогично предыдущему, но исполнители устанавливаются, только если к группе-роли из перечня не приязан исполнитель.
Установить статус процесса, код которого указан в <statusId>.
| Устарел, использовать ru.bgcrm.dao.expression.ProcessChangeFunctions. |
Проверить наличие исполнителей с группами, коды которых указаны через запятую в <groupIds>.
Перейти в текущую открытую очередь процессов и обновить её. Команда на браузер пользователя.
Создание привязанного к данному процессу процесса. <configId> - код правила создания связанного процесса.
| Устарели, использовать JEXL скрипты по образцу. |
Копировать из привязанного договора BGBilling адресный параметр в параметр процесса. <billingId> - идентификатор биллинга, <billingParamId> - числовой идентификатор адресного параметра в биллинге, <crmParamId> - числовой код параметра BGERP типа address. === bgbilling:getLinkedContractParam:<billingId>:<billingParamId>:<crmParamId> Копировать из привязанного договора BGBilling строковое представление параметра (как в таблице параметров) в текстовый параметр процесса. <billingId> - идентификатор биллинга, <billingParamId> - числовой идентификатор параметра в биллинге, <crmParamId> - числовой код параметра BGERP типа text. === bgbilling:linkedContractParamToDescription:<billingId>:<billingParamId>:<prefix> Копировать из привязанного договора BGBilling текстовое представление параметра (как в таблице параметров) в конец описания процесса. <billingId> - идентификатор биллинга, <billingParamId> - числовой идентификатор параметра в биллинге, <prefix> - каким префиксом сопроводить параметр, необязательно, если не указан - префиксом выступает имя параметра. === bgbilling:linkedContractParamToDescriptionBefore:<billingId>:<billingParamId>:<prefix> Идентично предыдущему, но строка с префиксом добавляется в начало описание процесса.
Копировать комментарий привязанного договора биллинга в конец описания процесса. <billingId> - идентификатор биллинга, <prefix> - каким префиксом сопроводить комментарий, необязательно.
Идентично предыдущему, но строка добавляется в начало описания процесса.
Копировать комментарий привязанного договора биллинга в параметр процесса с типом text. <billingId> - идентификатор биллинга, <crmParamId> - код параметра процесса типа text.
В команды могут быть подставлены переменные из объединённой конфигурации пользователя.