Разработка > Элементы разработки > Разработка задач и заданий > Настройка схемы задачи > Блоки схемы

«Мониторинг» (MonitoringBlock). Блок предназначен для контроля наступления определенного события. Например, блок добавляют, чтобы отправить уведомление, когда у документа изменится свойство.

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

Свойство	Описание
Период (Period)	Интервал времени, через который выполняется мониторинг
Срок прекращения (RelativeDeadline)	Срок принудительного завершения мониторинга относительно даты и времени старта
Наследуемые от BlockBase
Идентификатор (Id)	Присваивается блоку автоматически при создании. Свойство доступно только для просмотра. Отображается в лог-файлах сервиса выполнения блоков схем задач (WorkflowBlockService) при обработке блока
Заголовок (Title)	Отображается в схеме задачи

Событие

Назначение

Аргументы события

Возвращаемое значение

Старт блока (StartBlock<ИД блока>)

Заполнение свойств блока.

Событие выполняется на сервисе выполнения блоков схем задач (WorkflowBlockService) при старте обработки блока

_obj – задача, в рамках которой обрабатывается блок;

e.Block – блок, в рамках которого выполняется событие

Результат мониторинга (Monitoring<ИД блока>Result)

Определение завершения мониторинга.

Событие выполняется на сервисе выполнения блоков схем задач (WorkflowBlockService) при каждом выполнении мониторинга

_obj – задача, в рамках которой обрабатывается блок

Результат мониторинга. Возможные значения:

True. Ожидаемое событие наступило, переход по стрелке Успешно. Мониторинг завершится.

False. Ожидаемое событие не наступило. В этом случае проверяется свойство Срок прекращения (RelativeDeadline):

•если время, указанное в свойстве, еще не наступило, то вычисляется, что ближе по времени: следующий период мониторинга или срок прекращения. Сообщение с этим временем отправляется в DelayedOperationsService. Событие будет запущено еще раз через заданный период, при наступлении срока прекращения или при вызове события из кода;

•если время, указанное в свойстве, наступило, то происходит переход по стрелке Срок истек. Мониторинг завершится

Принцип работы блока

На работу блока «Мониторинг» влияет то, как заполнены свойства Период и Срок прекращения:

•если оба свойства Период и Срок прекращения заполнены, мониторинг выполняется через равные промежутки времени и прекращается по истечении указанного срока. Например, каждый день проверяется, наступило ли событие. Если да, то происходит выход из блока и процесс идет по ветке Успешно. Если нет, ожидается следующий период проверки. Через 3 дня, когда подошел срок прекращения, опять проверяется, наступило ли событие. Если да, то процесс идет по ветке Успешно. Если нет, то по ветке Срок истек. То есть, когда наступает срок прекращения, выход из блока происходит в любом случае:

•если заполнено только свойство Период, мониторинг выполняется через указанный период времени, например каждый день. Выход из блока происходит, если событие наступило, то есть по ветке Успешно. Мониторинг повторяется до тех пор, пока не наступит событие:

•если заполнено только свойство Срок прекращения, мониторинг выполняется один раз. Используйте этот вариант, если нужна пауза в бизнес-процессе. Например, сотруднику отправлено поручение. Нужно подождать 3 дня. Только после этого, если поручение выполнено, отправить контролеру уведомление (выход по ветке Успешно), а если не выполнено – задачу (выход по ветке Срок истек):

•если свойства Период и Срок прекращения не указаны, мониторинг выполняется только, если из кода вызвано событие блока «Результат мониторинга».

Как вызвать выполнение блока из кода

Вызвать из кода выполнение события «Результат мониторинга» можно при любом варианте заполнения свойств. Например, у блока «Мониторинг» заполнен Период и Срок прекращения проверки. Можно не дожидаться, когда наступит указное время, а запустить проверку принудительно. Для этого в серверном или разделяемом коде достаточно вызвать метод:

•Sungero.Workflow.Blocks.Block<Идентификатор блока мониторинг>.Execute(), чтобы выполнить событие конкретного блока;

•ExecuteAllMonitoringBlocks(), чтобы выполнить события всех активных блоков «Мониторинг» в схеме задачи.

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

СМ. ТАКЖЕ