Как работают Conditional Events?
Дисклеймер. Эта статья посвящена использованию Conditional Events в Camunda 7. Поддержка этих событий в Camunda 8 пока (в версии 8.6) не реализована.
Из нотации BPMN нам известно, что Conditional Event (или событие-условие) – это такое событие, которое срабатывает, когда связанное с ним условие становится истинным (true).

Как и большинство других событий, 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).

Рассмотрим на примере упрощенной модели процесса печати модели на 3D-принтере. В данном процессе Conditional Event присутствует в четырех местах.
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:

Задача 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.
Значение, передаваемое при вызове, будет установлено для соответствующих переменных в контексте запускаемого процесса.
другие статьи
Смотреть всёНачальные события в BPMN
Краткий ликбез по начальным (стартовым) событиям BPMN
Создаем неструктурированный процесс в Camunda
или как выжить без Ad Hoc и CMMN?
