Модификация экземпляра процесса

Эта функция доступна только в редакции OpenBPM Control Enterprise.

OpenBPM Control предоставляет инструменты для перемещения токенов выполняющегося процесса из одной активности в другую.

Используйте модификацию, когда нужно восстановить выполняющиеся процессы, повторно протестировать отдельную часть большого процесса или синхронизировать выполнение процесса после получения некорректных данных из внешней системы. Вы можете модифицировать сразу несколько экземпляров процесса на экране Модификация или модифицировать один выполняющийся экземпляр непосредственно на странице деталей экземпляра процесса.

Дополнительные сведения о модификации экземпляров процесса в Camunda см. в следующих материалах:

Модификация экземпляра процесса меняет состояние выполнения выбранных экземпляров. Используйте эту функцию только если вы понимаете бизнес- и технические последствия отмены исходной активности и запуска выполнения на целевой активности.
Функцию модификации можно отключить с помощью свойства приложения openbpm.control.features.modification-enabled.

Модификация нескольких экземпляров

Используйте экран Модификация, когда одно и то же перемещение токена нужно применить к нескольким выполняющимся экземплярам процесса.

Открытие массовой модификации

Выберите Модификация в меню приложения, чтобы открыть мастер модификации экземпляров процесса.

Мастер содержит три шага:

  • Процесс и активности - выбор процесса, версии, исходной активности и целевой активности.

  • Фильтрация экземпляров - выбор выполняющихся экземпляров процесса, которые нужно модифицировать.

  • Подтверждение - проверка сгенерированного запроса на модификацию и запуск выполнения.

process instance modification 1

Выбор процесса и версии

На первом шаге выберите процесс в списке Процесс.

Список процессов отсортирован, чтобы упростить поиск нужного процесса.

После выбора процесса выберите нужную версию определения процесса.

process instance modification 2

OpenBPM Control загружает BPMN-диаграмму и включает выбор исходной и целевой активностей.

Выбор исходной и целевой активностей

Мастер модификации формирует перемещение токена из исходной активности в целевую:

  • Исходная активность - текущая активная активность, которую нужно отменить.

  • Целевая активность - активность, в которой нужно запустить новый токен.

Активности можно выбрать из отсортированного выпадающего списка.

process instance modification 3

Также активность можно выбрать непосредственно на BPMN-диаграмме. Нажмите кнопку выбора на диаграмме рядом с полем исходной или целевой активности, выберите нужный BPMN-элемент и подтвердите выбор кнопкой OK.

process instance modification 4
process instance modification 5

Для целевой активности выберите, как должен быть создан новый токен:

  • Начать до - запускает выполнение перед выбранной активностью.

  • Начать после - запускает выполнение после выбранной активности.

Когда исходная и целевая активности выбраны, нажмите Далее.

process instance modification 6

Фильтрация экземпляров

На втором шаге отображаются выполняющиеся экземпляры процесса, соответствующие выбранному определению процесса и исходной активности.

process instance modification 7

Используйте диалог фильтрации, чтобы сузить набор экземпляров перед применением модификации.

process instance modification 8

Доступные фильтры:

  • Бизнес-ключ

  • С открытыми инцидентами

  • Сообщение инцидента

  • Условия по переменным процесса

  • Поиск по именам и значениям переменных без учета регистра

Количество экземпляров, выбранных для модификации, отображается над таблицей. Внимательно проверьте этот список, потому что модификация будет применена ко всем подходящим экземплярам.

Подтверждение массовой модификации

На шаге подтверждения отображается сводка по выбранному процессу, активностям и количеству экземпляров процесса.

Перед запуском модификации можно добавить комментарий.

Нажмите Сформировать запрос, чтобы сгенерировать и проверить запрос на модификацию, который будет отправлен в BPM-движок.

process instance modification 9

Сгенерированный запрос включает:

  • processDefinitionId

  • processInstanceIds

  • инструкцию cancel для исходной активности

  • инструкцию startBeforeActivity или startAfterActivity для целевой активности

Нажмите Модифицировать, чтобы запустить модификацию.

Отслеживание прогресса массовой модификации

При массовой модификации OpenBPM Control запускает обработку и показывает уведомление после принятия запроса.

process instance modification 10

Используйте Детали пакета в уведомлении, чтобы посмотреть прогресс выполнения, или обновите связанные данные, чтобы проверить обновленное состояние процесса.

Модификация одного экземпляра

Используйте действие Модифицировать экземпляр, когда нужно переместить токен только для одного выполняющегося экземпляра процесса.

Действие доступно на панели действий страницы деталей экземпляра процесса, если:

  • экземпляр процесса не завершен;

  • свойство openbpm.control.features.modification-enabled имеет значение true.

single process instance modification 1

Интерактивный режим диаграммы

Нажмите Модифицировать экземпляр, чтобы перевести диаграмму процесса в интерактивный режим. В этом режиме диаграмму можно использовать для выбора исходной и целевой активностей, а под диаграммой появляются кнопки OK и Отмена.

single process instance modification 2

Интерактивный режим работает по следующим правилам:

  • Если в экземпляре процесса активна только одна активность, а не экземпляр активности, она автоматически выбирается как исходная. Нужно выбрать только целевую активность, но исходную активность при необходимости можно поменять.

  • Если активно несколько активностей, сначала выберите исходную активность или активности, а затем выберите целевую активность.

  • При нескольких активных активностях выбор выполняется в порядке "источник - цель": после выбора исходной активности следующий щелчок выбирает целевую активность. После выбора целевой активности следующий щелчок снова выбирает исходную активность.

  • Чтобы выбрать несколько исходных активностей, удерживайте Ctrl в Windows или Linux либо Cmd в macOS и щелкните нужные элементы диаграммы. После отпускания клавиши следующий выбор активности считается выбором целевой активности.

  • В режиме выбора Источник доступны для щелчка только выполняющиеся активности экземпляра процесса.

  • В режиме выбора Цель доступны для щелчка все элементы, кроме выполняющихся активностей экземпляра процесса.

  • Перед нажатием OK должны быть выбраны исходная и целевая активности.

Выбранные элементы отображаются на диаграмме с рамкой выделения.

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

  • Нажать Отмена под диаграммой.

  • Повторно нажать Модифицировать экземпляр на панели действий.

Подтверждение модификации одного экземпляра

Нажмите OK под диаграммой, чтобы открыть диалог Модификация экземпляра процесса.

single process instance modification 3

В этом диалоге проверьте выбранные исходные активности и целевую активность, выберите Начать до или Начать после и при необходимости добавьте комментарий.

Также можно настроить переменные процесса, которые будут добавлены или обновлены при модификации:

  • Создать открывает диалог создания новой переменной.

  • Добавить открывает диалог выбора существующей переменной экземпляра процесса.

  • Редактировать обновляет выбранную переменную перед модификацией.

  • Удалить удаляет выбранную переменную из запроса на модификацию.

Поле Локальная отображается только при добавлении или редактировании переменной для модификации экземпляра. Оно не отображается при добавлении переменной непосредственно в экземпляр процесса из обычного представления переменных.

Нажмите Модифицировать, чтобы применить модификацию к текущему экземпляру процесса.

single process instance modification 4