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

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

Атрибуты и форма

../../../../../_images/54.png

Указать Имя.

 ../../../../../_images/55_0.png
Указать реципиентов - пользователей - исполнителей задачи.
Реципиент может быть выбран из списка ролей или указан вручную.
 ../../../../../_images/55_1.png
При выборе из списка представлен список ролей, заполненных в типе данных:
../../../../../_images/55_2.png

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

Примечание

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

Важно

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

  • «Реципиенты задачи»;

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

Иначе в линтере будет выдана ошибка.

Функционал Lazy approval для задачи

Примечание

Доступно только в Enterprise версии.

Lazy approval – функционал, позволяющий принимать решения из электронной почты, не заходя в ECOS.

Например - письмо о согласовании:

../../../../../_images/LA_example.png

В письме выбран вердикт На доработку:

../../../../../_images/user_task_LA_1.png

О предварительных настройках функционала см. подробно

Для включения функционала lazy approval для определенной задачи необходимо выставить чекбокс «Согласование по почте».

Примечание

Данная панель доступна на стендах, где есть лицензия разработчика или лицензия с включенным функционалом lazy approval.

Тип уведомления по умолчанию выставлен Электронная почта.
Выберите шаблон уведомления из созданных ранее.
 ../../../../../_images/user_task_LA.png

Форма задачи

Примечание

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

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

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

../../../../../_images/57.png

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

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

../../../../../_images/58.png

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

См. подробный пример См. создания формы

Использование переменных на форме

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

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

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

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

Темы для кнопок вердикта

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

../../../../../_images/56_4.png

../../../../../_images/56_5.png

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

../../../../../_images/56_6.png

Примеры:

../../../../../_images/56_7.png

1

По умолчанию

2

Основная

3

Информация

4

Успешно

5

Опасно

6

Предупреждение