01.11.24

Как работают Conditional Events?

Мстислав Мартынюк
Автор:Мстислав Мартынюк
15 мин · Обучающие





Дисклеймер. Эта статья посвящена использованию Conditional Events в Camunda 7. Поддержка этих событий в Camunda 8 пока (в версии 8.6) не реализована.


Из нотации BPMN нам известно, что Conditional Event (или событие-условие) – это такое событие, которое срабатывает, когда связанное с ним условие становится истинным (true).


Conditional Event обзор


Как и большинство других событий, Conditional Event может быть:


  • Начальным (Start) – запускать процесс или подпроцесс по событию (Event Subprocess);

  • Промежуточным (Intermediate) – находится в потоке управления (Catching) или быть связанным с какой-то активностью (Boundary).


Conditional Event  бывает следующих типов:


  • Прерывающий (Interrupting) – имеет сплошную границу и, в случае срабатывания, прерывает связанную активность (Boundary Event), запуская исходящий из него поток управления (Exceptional Flow);

  • Непрерывающий (Non-interrupting) – имеет прерывистую границу и запускает дополнительный поток управления, не прерывая работу связанной активности.



Как события этого типа работают в Camunda? 


При указании типа события на Conditional появится группа Condition. Что важно здесь указать?


  • Condition expression (Условное выражение) – выражение на языке JUEL, которое должно возвращать булево значение (true / false). В выражении могут использоваться переменные процесса, бины Spring или CDI: ${ isReady }, ${ calcState }, ${ ticketService.calcState() };

  • Variable name (Имя переменной) – переменная, изменения которой будут отслеживаться;

  • Variable events (Типы событий) – позволяет ограничить отслеживаемые изменения переменной нужными типами событий (create, update, delete).


Как заполняется условие для Conditional Event



Рассмотрим на примере упрощенной модели процесса печати модели на 3D-принтере. В данном процессе Conditional Event присутствует в четырех местах.


Области видимости (scopes) Conditional Events

Intermediate Catching Event


Printer is ready. Промежуточное событие. При поступлении токена на это событие выполнение процесса будет приостановлено, пока условие, заданное в поле Condition (в нашем случае это переменная процесса isReady) не приобретет значение true. Система будет отслеживать изменения переменной, заданной в разделе Condition и при изменении переменной заданного имени заданным действием (create, update) произойдет проверка выражения. Если выражение вернет истину, Camunda продолжит выполнение процесса.  



Boundary Event


Exception during printing. Связанное событие. Если во время выполнения задачи Print Model переменная isException приобретет значение true, выполнение задачи будет прервано, а токен переместится на задачу Convert Model to g-code.



Start Event subprocess 


Printing interruption requested. Начальное событие, прерывающее выполнение основного процесса и запускающего подпроцесс по событию. Срабатывает, если переменная isInterrupted приобретет значение true.



Области видимости переменных


Conditional Events могут быть вызваны изменениями только тех переменных процесса, которые видимы для событий (находятся в том же или вышестоящем скоупе).


На примере модели процесса из официальной документации Camunda 7:


Области видимости (scopes) Conditional Events


Задача UserTask A и подпроцесс находятся в одной и той же области видимости (scope), тогда как задача UserTask B находится внутри подпроцесса. Если значение переменной будет установлено внутри области видимости подпроцесса (scope = Subprocess), сработает Conditional Event, установленный на задаче UserTask B. Событие же, установленное на UserTask A, "не увидит" изменений, так как не имеет доступа к нижестоящему скоупу.


Это важный момент, который стоит учитывать при работе с событиями-условиями.



Изменение значения переменной


Вы можете установить значение переменной для срабатывания Conditional Event следующими способами:


  • Через Cockpit, добавив переменную в нужный скоуп.

  • При помощи User Task, выполняющейся в параллельном потоке управления. При этом переменная должны быть доступа и для выражения в Conditional Event и для User Task, то есть находиться в глобальном или вышестоящем скоупе.

  • Извне процесса, через Java API, путем вызова runtimeService.setVariable(processInstanceId, variableName, variableValue).

  • Извне процесса, путем вызова REST API: POST /condition.

  • В делегатном коде: delegateExecution.setVariable(variableName, variableValue). Обратите внимание, что в этом случае событие сработает только после завершения выполнения логики делегата.


Запуск процесса при помощи Conditional Start Event


Модель процесса может иметь одно или более событий с типом Conditional Start Event. Однако, эти события должны иметь разные условия, иначе Camunda не даст развернуть описание процесса! При развертывании новой версии процесса, подписки (subscription) на условия, существовавшие в предыдущих версиях, автоматически прекращаются. 


Запускать процесс, стартующий с Conditional Event можно при помощи:


  • Java API, билдер runtimeService.conditionEvaluation();

  • REST API: POST /condition.


Значение, передаваемое при вызове, будет установлено для соответствующих переменных в контексте запускаемого процесса.