БП настраивается в графическом интерфейсе редактора в виде схемы (графической модели). На схеме определяются: 

• последовательность этапов процесса;
• условия переходов между этапами.

После построения схемы определяются данные, с которыми осуществляется работа в рамках БП, и производится настройка операций.

Навигатор по разделу:

Редактор БП доступен в разделе "Настройка процессов" → "Схемы" веб-интерфейса администратора Avanpost IDM.

Раздел "Настройка процессов" → "Схемы"

Создание бизнес-процесса

Для создания (добавления) нового БП необходимо в разделе "Настройка процессов" → "Схемы" веб-интерфейса администратора нажать → "Новая схема". Откроется окно создания БП "new schema".

Добавление БП

Загрузка бизнес-процесса

Для загрузки сохраненного БП или шаблона БП необходимо:

1. Нажать → "Загрузить" в разделе "Настройка процессов" → "Схемы" веб-интерфейса администратора.
2. В открывшемся окне выбрать схему или шаблон для загрузки на вкладке "Схемы" или "Шаблоны".
3. Нажать .

Откроется новая вкладка в редакторе с выбранной схемой.

Загрузка БП

Настройка бизнес-процесса

Интерфейс редактора БП состоит из следующих функциональных областей:

Интерфейс редактора БП

• [1] – Вкладки с открытыми в редакторе БП. Нажимая на них, можно переключаться между открытыми схемами БП.
• [2] – Кнопки управления БП:
  
  • – экспорт открытого БП на локальный компьютер в формате JSON;
  • – импорт БП в формате JSON с локального компьютера;
  • – проверка заданной схемы на корректность настройки БП;
  • – сохранение текущей схемы БП;
  • – активация схемы БП в Системе.
• [3] – Кнопка настроек БП. Открывает окно с настройкой переменных и уровня журналирования.
• [4] – Кнопки управления масштабом отображения схемы в редакторе:
  
  • – увеличение масштаба;
  • – уменьшение масштаба;
  • – масштаб в соответствии с размером схемы.
    

    Примечание

    Регулировка масштаба так же доступна с помощью колеса прокрутки компьютерной мыши

• [5] – Кнопка добавления блока БП. Открывает список доступных блоков. Схема БП строится с помощью механизма "Drag-and-Drop" (то есть путём перемещения блоков, зажимая ЛКМ).
• [6] – Кнопка включения отображения мини-карты.
• [7] – Мини-карта схемы БП. С её помощью можно перемещаться по открытому в редакторе БП.
• [8] – Кнопки отмены изменения и его повторного применения.

Для изменения положения схемы на экране необходимо поставить курсор мыши в любое место схемы, зажать ЛКМ и "перетянуть" схему на новое место.

Настройка схемы бизнес-процесса

Для настройки схемы БП необходимо открыть схему в редакторе и добавить в нее нужные блоки БП и связи между ними.

Блок бизнес-процесса

Блок БП – это функциональная единица для построения БП. Блок может содержать параметры:  входные и выходные.

В редакторе реализованы следующие типы блоков:

Каждый блок описывает этап БП. Настроенные блоки выстраиваются в последовательность этапов с помощью связей блоков, представленных в редакторе стрелками.

Добавление блоков БП в схему

Для добавления блока необходимо:

1. Нажать в левом нижнем углу редактора.
2. Перетащить выбранный блок из списка в рабочую область редактора.

Добавление блока в схему

Изменение имени блоков БП

Для изменения имени блока необходимо:

1. Дважды нажать ЛКМ по блоку. 
2. Изменить имя блока.
3. Нажать ЛКМ в любом месте рабочей области редактора БП.

Удаление блоков БП

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

Удаление блока

Настройка блоков БП

Для настройки блока БП необходимо:

1. Нажать на нужном блоке.
2. В открывшейся форме нажать .
3. Задать настройки блока в открывшемся окне при их наличии. Нажать .
4. Указать входные и выходные параметры блока при их наличии.
5. Закрыть форму настроек, нажав .

Настройка блока БП

Входные параметры

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

Значения и логические выражения в параметрах блока прописываются на языке программирования C#.

Выходные параметры 

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

Каждому выходному параметру необходимо сопоставить переменную БП, в которую будет записан результат прохождения блока.

Переменные БП

Переменные БП – это глобальные переменные в рамках БП, использующиеся во входных и выходных параметрах блоков БП.

Добавление переменной БП

Для добавления переменной БП необходимо:

1. Нажать в левом нижнем углу редактора БП. Откроется окно с настройками схемы. На вкладке "Переменные" представлен список всех переменных этого БП.
2. Ввести название новой переменной в поле "Название".
3. Выбрать из списка тип переменной БП (строка, число, логический).
4. Нажать .

Добавление переменной БП

Удаление переменной БП

Для удаления переменной БП необходимо:

1. Нажать в левом нижнем углу редактора БП. Откроется окно с настройками схемы.
2. На вкладке "Переменные" нажать в строке нужной переменной в списке.

Удаление переменной БП

Связывание блоков БП

Изменение расположения блока осуществляется с помощью механизма "Drag-and-Drop" (то есть путём перемещения, зажимая ЛКМ).

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

Простое связывание блоков

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

1. Выделить блок, от которого будет идти стрелка. Контур выделенного блока станет синим.

2. Зажать ЛКМ на выходе на границе блока и протянуть появившуюся стрелку к входу на границе следующего блока.
3. Отпустить ЛКМ.

Простое связывание блоков

Связывание блоков через событие

Этап БП может завершаться следующими событиями:

Чтобы связать блоки БП через событие необходимо:

1.  Выделить родительский блок, от которого будет идти связь. Контур выделенного блока станет синим.
2. Зажать ЛКМ на иконке события на границе блока (,  или ) и "протянуть" появившуюся стрелку ко входу на границе следующего блока.
3. Отпустить ЛКМ.

Связывание блоков через событие

Удаление связи блоков

Для удаления связки между блоками необходимо выбрать нужную стрелку и нажать на клавишу "Delete" на клавиатуре.

Проверка настроенного БП 

Схема БП для активации в Системе должна соответствовать следующим критериям:

1.  У всех имеющих входы блоков в схеме заданы родительские блоки для всех входов.
2. У всех имеющих выходы блоков в схеме заданы дочерние блоки для всех выходов (выходы-события ,  или использовать не обязательно).
3. Все обязательные настройки и параметры всех блоков в схеме заданы.

После завершения настройки схемы БП необходимо проверить её на корректность. Для этого нажать  на панели с кнопками в левой части редактора.

Если схема отвечает всем критериям, то в правом нижем углу веб-интерфейса выведется сообщение "Схема корректна".

В противном случае выведется сообщение "На схеме присутствуют ошибки" и откроется окно с описанием проблемы, а блок не прошедший проверку подсветится красным цветом.

Сообщение об ошибке

Сохранение настроенного БП

Настроенный БП для активации в системе необходимо сохранить. БП можно сохранить как схему или как шаблон.
Сохранённые схемы можно использовать в заявках и планировщиках в Системе. Сохраненные шаблоны предназначены для настройки новых БП на их основе и не используются в заявках и планировщиках.

Сохранение настроенного БП как схемы

Для сохранения настроенного БП как схемы необходимо:

1. Проверить соответствие схемы БП всем критериям (см. раздел "3.1.10. Проверка настроенного бизнес-процесса").
2. Нажать  на панели с кнопками в левой части редактора.
3. В открывшемся списке выбрать "Сохранить схему".
4. В открывшемся окне выбрать один из вариантов:
   1. "Существующая" – для сохранения новой версии уже существующей схемы.
      

      Версии не перезаписывают друг друга. Для дальнейшей загрузки в редакторе БП будут доступны все сохраненные версии схемы

      
      
   2. "Новая" – для сохранения нового БП.
5. Указать название БП или выбрать существующий БП из списка.
6. Установить флажок "Активировать", если БП полностью готов и необходимо разрешить его использование в Системе.
   

   В случае с несколькими версиями одного БП в Системе будет работать последняя активированная версия

   
   
   
7. Нажать .

Сохранение БП как схемы

Сохранение настроенного БП как шаблон

Для сохранения настроенного БП как шаблон необходимо:

1. Нажать на панели с кнопками в левой части редактора.
2. В открывшемся списке выбрать "Сохранить шаблон".
3. Указать название шаблона.
4. Нажать .

Как шаблон можно сохранять любые схемы БП, даже если они не соответствуют критериям из раздела "3.1.10. Проверка настроенного бизнес-процесса".

Сохранение БП как шаблон

Активация настроенного БП в Системе

Если настроенный БП не был активирован при сохранении, то это можно сделать в редакторе. Для этого необходимо нажать на панели с кнопками в левой части редактора и подтвердить активацию во всплывающем окне.

Активация БП

Блоки бизнес-процессов 

Асинхронное обращение к сервису

Блок "Асинхронное обращение к сервису" обеспечивает вызов функции и создание задачи для отложенного получения ответа.

Настройки блока:

Вывести строку (устаревший блок)

Блок "Вывести строку" обеспечивает вывод текста в лог.

Добавить в ACL (устаревший блок)

Блок "Добавить в ACL" обеспечивает бессрочное добавление пользователей в ACL.

Настройки блока:

Добавить в финальный ACL (устаревший блок)

Блок "Добавить в финальный ACL" обеспечивает добавление пользователей в ACL после завершения бизнес-процесса.

Настройки блока:

Запуск подпроцесса

Блок "Запуск подпроцесса" обеспечивает запуск подпроцесса на основе выбранной схемы БП. Используется для схем, в которых какой-либо этап маршрута является отдельным БП.

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

Настройки блока:

subprocessData=[{"key1":1, "key2":2},{"key3":3}]
subprocessData

{"key1":1, "key2":2}

{"key3":3}

value=Workflow.ContextAdditionalData["key1"]

Ожидание

Блок "Ожидание" обеспечивает отложенное выполнение БП до указанного в параметрах блока времени.

Настройки блока:

task1=Tasks[0]

	public int Id {get;set;}
    public ApplicationUser Executor {get;set;}
    public IEnumerable<ApplicationUser> Assignees {get;set;}
    public string Result {get;set;}
    public string Comment {get;set;}
    public string TaskScope {get;set;}
    public string TaskObject {get;set;}

 public string Id { get; set; }
 public string Login { get; set;}

Параллельное принятие решения

Блок "Параллельное принятие решения" обеспечивает создание задач на пользователей-участников БП и ожидает их исполнения.

Настройки блока:

Рассылка e-mail

Блок "Рассылка email" предназначен для настройки уведомлений по электронной почте участникам БП.

Настройки блока:

import json
settings = json.loads(
    """
    {
        'attachments': [{
            path: "/opt/avanpost/attach/test1.docx",
            format: 'word',
            useDynamicReplace: false}],
        'copyRecipients' : [],
        'fromAddress' : 'mail@avanpost.ru',
        'saveAttachments': false
    }
    """)
settings

Синхронное обращение к сервису

Блок "Синхронное обращение к сервису" обеспечивает вызов функции, и возврат результата выполнения в переменную БП.

Настройки блока:

Выбор

Блок "Выбор" предназначен для выбора маршрута БП в зависимости от значения выражения, заданного в параметрах блока.

Для настройки переходов к дальнейшим шагам БП необходимо:

1. Добавить любое количество блоков для следующих шагов БП.
2. Соединить блок "Выбор" с каждым из дочерних блоков стрелками, используя выход на нижней или правой границе блока. Выход на нижней границе используется для создания связей с заданным значением для сравнения. Выход на правой границе используется для создания связи "по умолчанию".
   

   Примечание

   В случае несовпадения результата выражения в блоке «Выбор» с заданными на других выходах значениями движение процесса производится через выход «по умолчанию».

   Если выход процесса «по умолчанию» не настроен и совпадения результата выражения по другим выходам нет, то процесс прервётся

3. Нажать на блок, расположенный на стрелке связи с значением. Откроется форма "Редактирование выражения связи". Указать на форме значение, с которым будет сравниваться результат вычисления выражения, прописанного в параметре "Condition" и нажать .
   
   
4. Повторить шаг 3 для всех связей блока "Выбор" с дочерними блоками, кроме связи с блоком по умолчанию.
   Настройка блока "Выбор"
   
   

Если

Блок "Если" обеспечивает ветвление БП на два маршрута в зависимости от значения логического выражения.

Для настройки переходов "true" и "false" необходимо:

1. Добавить два блока для следующих шагов БП.
2. Соединить блок "Если" с дочерними блоками стрелками "true" и "false". Выход на верхней границе блока "Если" используется для связи с значением "true", выход на нижней границе — с значением "false".

Настройка блока "Если"

Проверка документа

Блок "Проверка документа" предназначен для проверки возможности прохождения этапа БП.

Настройки блока:

Получить поле

Блок "Получить поле" предназначен для получения данных из определенного поля заявки и записи этих данных в переменные БП.

Присвоить

Блок "Присвоить" предназначен для присвоения переменной БП заданного или вычисляемого значения.

Решение пользователя

Блок "Решение пользователя" предназначен для создания задач для документа заявки на пользователей-участников БП и ожидания их исполнения.

Настройки блока:

Стартовый блок

"Стартовый блок" обязательно используется в каждой схеме БП в качестве первого блока.

Настройки блока:

Завершение БП

Блок "Завершение БП" обязательно используется в каждой схеме БП в качестве последнего блока.

Настройки блока:

Точки маршрута

Точки маршрута отражают этапы исполнения БП. Они присваиваются блокам БП в редакторе БП. Точки маршрута необходимы для отображения текущего статуса выполнения заявки в документе заявки и этапов в истории на вкладке "Ход исполнения заявки" документа заявки. 

Добавление и настройка точек маршрута осуществляются в разделе "Настройка процессов" → "Точки маршрута" веб-интерфейса администратора Avanpost IDM.

Окно добавления точек маршрута

Действия

Действия, используемые при настройке бизнес-процессов, добавляются и настраиваются в разделе "Настройка процессов" → "Действия" веб-интерфейса администратора Avanpost IDM.

Добавление действия

Для добавления действия необходимо:

1. Нажать в левом верхнем углу раздела. Откроется карточка действия для настройки.
2. Настроить параметры действия на вкладке "Основные параметры" карточки.
3. Настроить область действия на соответствующей вкладке карточки.
4. При необходимости настроить параметры для этого действия на вкладке "Параметры действия" карточки.
5. Нажать .

Добавление действия

Карточка действия

Для изменения настроек действия необходимо нажать на него в списке в разделе "Настройка процессов" → "Действия" веб-интерфейса администратора Avanpost IDM. Откроется карточка действия.
После внесения изменений в карточку нажать .

Вкладка "Основные параметры" 

Диалоговое окно действия

Вкладка "Область действия"

На вкладке необходимо выбрать из списка в первом поле область действия настраиваемой кнопки:

• "Документ" – используется, если действие распространяется на весь документ (заявку). В таком случае для выполнения действий по заявке будет создана одна задача, включающая все доступы заявки.
• "Роль" – используется, если действие распространяется на отдельную роль в заявке (например, разные роли в заявке согласуются разными согласующими). В таком случае для выполнения действий по заявке будут созданы отдельные задачи для каждой роли.

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

Вкладка "Параметры действия" 

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

Добавление параметра действия

Для добавления параметра необходимо:

1. Нажать .
2. Выбрать из списка нужный тип параметра. Новый параметр откроется в списке.
3. Нажать в строке добавленного параметра. Откроется форма с настройками добавленного параметра. Для каждого типа параметра предусмотрен свой набор настроек.
4. Заполнить поля в открывшейся форме в соответствии с таблицей:

fields: [
  {
    "Name": "name",
    "Type": "JSONString" | "string",
    "Value": "string value"
  },
  ....
]

subjects: Employee[]

['<h1>Заголовок</h1>']

Удаление параметра действия

Для удаления параметра необходимо:

1. Нажать в строке добавленного параметра. Откроется форма с настройками добавленного параметра.
2. Нажать "Удалить" в правом нижнем углу формы.
3. Подтвердить удаление в окне.

Удаление параметра действия

Удаление действия

Для удаления действия необходимо:

1. Нажать на действие в списке в разделе "Администрирование" → "Действия" веб-интерфейса администратора Avanpost IDM. Откроется карточка действия.
2. Нажать "Удалить" в левом нижнем углу карточки.
3. Подтвердить удаление.

Удаление действия

Приложение. Примеры скриптов для бизнес-процессов

1. Пример фильтра поиска ролей по описанию 

SEARCH_DESCRIPTION = 'Пример для фильтра'

builder_filter_roles = IdmWebClient.Roles.CreateRoleFilterBuilder()
roles = IdmWebClient.Roles.EnumerateRole(builder_filter_roles.Description.Equal(SEARCH_DESCRIPTION));

roles 

2. Пример фильтра поиска аккаунтов у юнитов по свойству

PROPERTY_NAME = 'hr_login'
identifier = 'Какой-то логин'

builder_filter_unit = IdmWebClient.Accounts.CreateUnitAccountFilterBuilder() 
units = IdmWebClient.Accounts.EnumerateUnitAccounts(builder_filter_unit.Properties.ContainsValue(PROPERTY_NAME, str(identifier), False))

units