Skip to content

Latest commit

 

History

History
206 lines (150 loc) · 9.58 KB

ecos_bpmn_components_user_task.rst

File metadata and controls

206 lines (150 loc) · 9.58 KB

Пользовательская задача

Пользовательская задача выполняется пользователем или участником процесса. При выполнении таких задач обычно требуется ввод данных, манипуляции с объектами и т.д.

_static/user_task/54.png
Указать Имя. _static/user_task/55_0.png
Указать реципиентов - пользователей - исполнителей задачи.
Реципиент может быть выбран из списка ролей или указан вручную.
_static/user_task/55_1.png
При выборе из списка представлен список ролей, заполненных в :ref:`типе данных<roles_statuses>`:
_static/user_task/55_2.png

_static/user_task/55_3.png
Для ввода вручную необходимо выставить флаг "Ручное назначение"
В поле указывается имя или recordRef реципиента. Поддерживаются expression для получения реципиентов из переменных или сервисов.
Expression может вернуть множественное значение - строки разделенные запятой: user1,user2,user3
Например:
ivan.petrov
GROUP_company_accountant
emodel/authority-group@company_accountant
${someVariable}
${someService.getRecipients()},petya.voks
_static/user_task/55_4.png
Форма задачи определяет то, что будет отображено при назначении задачи пользователю.
Форму задачи можно выбрать из списка, создать.
Если форму задачи не указывать - тогда пользователю будут отображены только результаты задачи, указанные в соответствующем поле.
_static/user_task/56.png
Указать срок выполнения задачи, конкрентную дату.
Дата должна быть указана в формате ISO8601
Например:
2022-06-26T10:30:00 - 20 июня 2022 года 10 часов 30 минут 0 секунд
или в виде выражения: ${someDate}
_static/user_task/56_1.png
Выбрать приоритет задачи
_static/user_task/56_2.png
Или указать приоритет (выражение) - Expression для получения приоритета задачи из переменных или сервисов.
Выражение должно вернуть число, представляющее собой приоритет:
- Высокий - 1
- Средний - 2
- Низкий - 3
_static/user_task/56_2_1.png
Указать результат задачи (вердикт) – идентификатор и название.
В вердиктах можно настроить темы для кнопки. :ref:`См. подробно о результатах задачи<user_task_result_themes>`
_static/user_task/56_3.png

Note

Срок выполнения задачи также можно изменить с помощью TaskService или в TaskListeners с помощью переданного DelegateTask.

Important

При сохранении, сохранении/публикации процесса проверяется обязательность заполнения следующих полей:

  • «Реципиенты задачи»;
  • «Приоритет задачи»: Приоритет или Приоритет (выражение)

Иначе в :ref:`линтере<bpmn_linter>` будет выдана ошибка.

Note

Если форма задачи не указана, то будут отображаться доступные вердикты задачи, заполненные в поле Результат задачи.

Результаты задачи версионируются вместе с описанием процесса.

Форму можно создать, нажав Выбрать - Создать форму

_static/user_task/57.png

Для добавления кнопок вердиктов задачи на вашу форму, можно воспользоваться компонентом формы Task Outcome, который автоматически формирует кнопки вердиктов исходя из настроек Результатов задачи.

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

_static/user_task/58.png

Если какие-то задачи могут совпадать, то можно использовать одинаковую форму.

См. подробный пример :ref:`См. создания формы<approve_form_bpmn>`

Элементы формы задачи связаны с переменными инстанса (экземпляра) процесса. Если в области видимости задачи/процесса есть переменная с таким же id (Имя свойства), как и у элемента формы, то ее содержимое отобразится на форме.

При сабмите (публикации) формы задачи переменные будут записаны в переменные процесса.

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

Для отображения и обновления переменных документа на форме задачи необходимо добавить элемент с id (Имя свойства) с префиксом _ECM_, например _ECM_paymentSum, где paymentSum - свойства документа.

В вердиктах доступна настройка темы кнопок. Настройка влияет на цвет кнопки по аналогии с кнопками на форме.

_static/user_task/56_4.png

_static/user_task/56_5.png

Возможные варианты:

_static/user_task/56_6.png

Примеры:

_static/user_task/56_7.png


1 По умолчанию
2 Основная
3 Информация
4 Успешно
5 Опасно
6 Предупреждение