Действие процесса

Одним из способов решения бизнес-задач в BPMSoft являются бизнес-процессы. Система предоставляет набор пользовательских действий, но возникают ситуации, при которых они могут не подойти к требованиям конкретной задачи.

Для создания новых пользовательских действий используется конфигурационные элемент «Действие процесса». Для запуска действия процесса используется элемент «Выполнить действие процесса». Познакомиться с этим элементом и описанием преднастроенных действий процесса можно в статье Элемент процесса «Выполнить действие процесса».

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

Создание пользовательского действия процесса

Для создания действия процесса выполните следующее:

1. Откройте раздел «Конфигурация».
2. Выберите пользовательский пакет, в который хотите добавить действие процесса.
3. На панели инструментов рабочей области раздела «Конфигурация» нажмите «Добавить» и выберите «Действие процесса».

Рисунок 1 — Конфигурационный элемент «Действие процесса»

4. Заполните свойства элемента:

Таблица 1 — Свойства элемента «Действие процесса»

Рисунок 2 — Свойства элемента «Действие процесса»

5. После нажмите «Применить».

После нажатия на кнопку «Применить» начнется генерация кода для действия. После окончания генерации вы будете перемещены в раздел «Конфигурация».

6. Добавьте параметры. Для этого откройте созданную схему, после нажмите на кнопку .

Рисунок 3 — Добавление параметров действия

Заполните параметры действия процесса:

• Код — название схемы (обязательный свойство);
• Заголовок — локализуемый заголовок схемы;
• Тип данных — тип данных параметра (обязательное свойство);
• Справочник — свойство доступно, если свойстве «Тип данных» выбрано значение «Справочник»;
• Схема — название схемы, связанной с параметром;
• Признак «Обязательный для заполнения» — указывает является ли параметр обязательным для заполнения;
• Признак «Результирующий» — указывает является ли параметр результирующим. Можно использовать в условии условного потока;
• Признак «Содержит Id исполнителя» — идентификатор исполнителя действия. Свойство доступно, если свойстве «Тип данных» выбрано значение «Справочник»;
• Признак «Отложенная загрузка» — позволяет без задержек загружать диаграмму процесса. Параметр загружается непосредственно перед его использованием;
• Признак «Сериализуемый» — значение текущего параметра сохраняется в процессе выполнения действия процесса (между вызовами методов InternalExecute() и CompleteExecuting()). Используется для интерактивных действий процесса;
• Признак «Копировать значение» — если признак установлен, значение параметра копируется при его повторном использовании. Данное свойство является устаревшим, не рекомендуется к использованию.

Для реализации примера создадим параметр:

Таблица 2 — Параметр пользовательского действия

Для реализации логики действия-процесса BPMSoft предоставляет два базовых класса:

• Класс ProcessUserTask;
• Класс ProcessUserTaskSchemaExtension.

Действия процесса делятся на два типа: интерактивные и неинтерактивные. В зависимости от типа действия дизайнер действия процесса позволяет классам-наследникам замещать определенные методы. Ниже представлена таблица зависимости замещаемых методов от типа действия процесса.

Таблица 3 — Таблица зависимости замещаемых методов от типа действия

7. Напишите логику действия в методе InternalExecute.

// Получаем схему Reminding. 
var remindingSchema = UserConnection.EntitySchemaManager.GetInstanceByName("Reminding");
// Создаем экземпляр объекта Reminding.
var reminding = remindingSchema.CreateEntity(UserConnection);
// Заполнение полей по умолчанию.
reminding.SetDefColumnValues();
// Идентификатор уведомления в таблице.
reminding.SetColumnValue("Id", Guid.NewGuid());
// Автор уведомления.
reminding.SetColumnValue("AuthorId", UserConnection.CurrentUser.ContactId);
// Получатель уведомления.
reminding.SetColumnValue("ContactId", BpmNotificationReceiver);
// Идентификатор из таблицы RemindingSource, указывающий на автора уведомления.
reminding.SetColumnValue("SourceId", new Guid("a66d08e1-2e2d-e011-ac0a-00155d043205"));
// Время отправки уведомления.
reminding.SetColumnValue("RemindTime", UserConnection.CurrentUser.GetCurrentDateTime());
// Содержание уведомления.
reminding.SetColumnValue("SubjectCaption", "Содержание уведомления");
// Заголовок уведомления.
reminding.SetColumnValue("PopupTitle", "Заголовок уведомления");
// Идентификатор таблицы (схемы) раздела, данное значение взято из имеющихся в таблице Reminding примеров уведомления.
// При реализации примера на своих стендах замените данное значение.
reminding.SetColumnValue("SysEntitySchemaId", new Guid("1BAB9DCF-17D5-49F8-9536-8E0064F1DCE0"));
// Сохраняем запись.
reminding.Save();
// При возвращении значения true, действие процесса завершает работу, устанавливается статус "Выполнено". 
// Сам бизнес-процесс продолжит работу.
return true;

8. Сохраните и опубликуйте схему.

Добавление пользовательского действия процесса в бизнес-процесс

Для демонстрации написанного пользовательского действия создадим бизнес-процесс.

1. Откройте раздел «Конфигурация».
2. Выберите пакет, в который хотите добавить бизнес-процесс.

3. На панели инструментов рабочей области раздела «Конфигурация» нажмите «Добавить» и выберите «Бизнес-процесс».
4. Заполните свойства «Название» и «Имя».

Рисунок 4 — Свойства бизнес-процесса

5. Вынесите на рабочую область элемент «Выполнить действие процесса».

Рисунок 5 — Элемент «Выполнить действие процесса»

Рисунок 6 — Схема бизнес-процесса

6. Добавьте параметр бизнес-процесса:

Рисунок 7 — Параметр процесса

В качестве значения параметра выберите значение системной переменной «Контакт текущего пользователя».

7. Настройте элемент «Выполнить действие процесса»:
   • «Какое пользовательское действие выполнить» = «Отправить уведомление пользователю»;
   • Заполните параметр «Получатель уведомления».

Рисунок 8 — Параметры элемента «Выполнить действие процесса»

8. Сохраните бизнес-процесс.

После завершения работы бизнес-процесса уведомление появится в коммуникационной панели для получателя.

Рисунок 9 — Уведомление в коммуникационной панели

Добавление пользовательского действия на вкладку «Действия пользователя»

Система позволяет добавить пользовательское действие в меню «Действия пользователя».

Рисунок 10 — Список «Действия пользователя»

Для добавления пользовательского действия в список необходимо выполнить SQL-сценарий в базе данных системы:

INSERT INTO SysProcessUserTask(SysUserTaskSchemaUId, Caption)
SELECT s.UId, s.Caption FROM SysSchema s WHERE s.Name = '[Имя действия процесса]'

INSERT INTO "SysProcessUserTask" ("SysUserTaskSchemaUId", "Caption")
SELECT s."UId", s."Caption" FROM "SysSchema" AS s WHERE s."Name" = '[Имя действия процесса]';

После того как SQL-сценарий выполнится, рекомендуется повторно зайти в систему или перекомпилировать систему. Пакет с реализованным примером доступен по ссылке.

Рисунок 11 — Список «Действия пользователя» после выполнения SQL-сценария

Чтобы настроить параметры элемента бизнес-процесса, нужно заполнить поле «Страница редактирования параметров». Укажите страницу, которая будет отображать эти параметры в дизайнере. Можно выбрать стандартную страницу UserTaskPropertiesPage.

Рисунок 12 — Свойство «Страница редактирования параметров»

Базовые классы реализации действия процесса

Класс ProcessUserTask

Данный класс находится в пространстве имен BPMSoft.Core.Process и предназначен для реализации основной логики действия процесса. Для реализации своей логики действия классы-наследники должны заместить методы базового класса. Методы, которые можно заместить, зависят от типа действия процесса.

Таблица 4 — Методы класса ProcessUserTask

Класс ProcessUserTaskSchemaExtension

Данный класс находится в пространстве имен BPMSoft.Core.Process и предназначен для расширения возможностей действий процесса, например, синхронизации параметров, установке зависимостей, и т.д. Для класса-наследника существует правило, по которому должно формироваться его имя: к названию реализовываемого класса необходимо добавить суффикс SchemaExtension.

Например, для пользовательского действия процесса BpmTestProcessUserTask название класса-наследника будет — BpmTestProcessUserTaskSchemaExtension.

Таблица 5 — Методы класса ProcessUserTaskSchemaExtension

Рекомендуем изучить

Бизнес-процессы
Элемент процесса «Выполнить действие процесса»