Функциональные блоки схемы процесса.

Функциональные блоки схемы процесса:

Изначально на пустой схеме присутствуют: блок "Старт", инструмент масштабирования схемы процесса, полосы прокрутки.

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

Блок "Старт"

Блок "Старт" является точкой старта процесса.

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

Панель свойств параметра процесса

Данные инициатора:

В свойствах у блока "Старт" доступен раздел — "Данные инициатора". Он предназначен для того, чтобы при запуске процесса автоматически получать информацию о пользователе, который запускает процесс, и использовать эти данные в других блоках процесса без необходимости заполнять их вручную.

В разделе есть 4 поля:

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

Каждое из этих полей можно привязать к переменной типа "Строка". Когда процесс будет запущен, в выбранные переменные автоматически запишутся значения из полей в карточке пользователя, который его запустил.

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

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

Параметры добавляются после нажатия на кнопку "Добавить параметр":

У каждого параметра процесса своя панель, на которой размещены:

1. порядковый номер параметра (1 параметр)
2. кнопки с иконками:
   1. "-" - свернуть панель параметра;
   2. "+" - развернуть панель параметра;
   3. "Корзина" - удалить параметр процесса.
      
      
3. по центру - свойства параметра процесса:
   1. название параметра (произвольное, можно использовать буквы русского алфавита);
   2. тип параметра:
      • число;
      • строка;
      • логический;
      • дата и время.
        
        
   3. значение параметра – заполняется вручную
      Также можно выбрать переменную соответствующего типа, в которую будет записано значение параметра при запуске процесса
      
      
      

Пример задания параметра:

Типы параметров процесса:

Строка

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

Логическая

Этот параметр может принимать только два значение - True или False.

Число

Число может быть положительным, отрицательным, с плавающей или фиксированной точкой.

Дата-время

Можно указать дату, время и часовой пояс

Использование данных Инициатора в процессе

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

Либо записать значение в строковую переменную, выбрав её в нужном поле:

Таким образом, можно передавать данные пользователя, который запускает процесс, в другие блоки процесса и использовать их для соответствующих задач.

Блок "Финиш"

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

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

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

Блок "Робот"

Блок "Робот" выполняет роботизированную задачу. У блока есть такие свойства, как:

1. Название робота (заполняется автоматически после выбора робота).
2. Описание робота (заполняется автоматически после выбора робота).
3. Цвет блока (заполняется дизайнером процесса).
4. Условия выполнения — определяют, сколько входящих направляющих нужно дождаться перед запуском робота. Свойство не настраивается и не отображается (является встроенным). Блок по умолчанию всегда ожидает хотя бы одну направляющую.
5. Место запуска:
   • Машина инициатора 
   • Заданная машина
   • Любые доступные машины
6. Входные параметры (заполняются дизайнером процесса после выбора робота).
7. Результаты (заполняются дизайнером процесса после выбора робота).

Выбор робота

Чтобы выбрать робота в качестве исполнителя задачи нужно нажать на кнопку "Выбрать робота".

При нажатии на кнопку "Выбрать робота" появляется список готовых роботов, в котором необходимо выбрать тот, который будет выполнять задачу. Выбор робота осуществляется с помощью ЛКМ. В качестве примера выбран робот "Возведение числа в степень":

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

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

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

• Имя робота

• Описание робота

Также появляется дополнительные свойства:

• Место запуска — выбор, на какой машине и под какой учётной записью будет запущен робот.

• Входные параметры — если у робота предусмотрены входные параметры.

• Результаты — если у робота предусмотрены выходные параметры.

Выбор места запуска робота

После выбора робота станет доступна секция "Место запуска". 

Здесь указывается, на какой машине будет выполняться робот:

• Машина инициатора — робот запускается на машине пользователя, который запустил процесс. Это значение выбрано по умолчанию.
• Заданная машина — позволяет явно указать машину и учётную запись для запуска. Необходимо выбрать машину и учётную запись из выпадающих списков.
• Любые доступные машины — робот будет запущен на любой машине, доступной инициатору процесса.

Рекомендации:

• Если вы не уверены, на какой машине должен запускаться робот, оставьте вариант "Машина инициатора"

• Используйте "Заданную машину", если требуется строгий контроль над тем, где и под какой учётной записью должен выполняться робот

• Вариант "Любые доступные машины" подойдёт, если важна гибкость и нет требований к конкретной машине.

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

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

В примере привяжем входные параметры робота к параметрам процесса: "x1" и ""n1"", которые задаются в блоке "Старт":

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

Результаты:

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

Блок "Экранная форма"

Блок "Экранная форма" используется в процессе, как пользовательская задача. 

Изначально у блока имеются свойства, которые заполняются или выбираются, в зависимости от назначения:

Выбор ЭФ

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

При нажатии на кнопку "Выбрать экранную форму" открывается модальное окно со списком опубликованных экранных форм, из которого необходимо выбрать ту, которая будет использована в качестве шага для выполнения пользовательской задачи: 

Предположим, что мы хотим выбрать из списка ЭФ с названием "Заявка на отпуск".

Выполняемые действия:

• в поисковой строке вводим текст "Заявка", при этом список экранных форм автоматически сокращается до тех, которые в своем названии имеют слово "Заявка" 
  
• Кликаем на ЭФ и нажимаем на кнопку "Выбрать"
• Выбранная экранная форма и ее версия отображается под кнопкой "Выбрать экранную форму"
• В свойствах блока поля "Название" и "Описание" заполняются автоматически с использованием свойств выбранной ЭФ:
  
  

Свойства ЭФ, которые появляются после выбора блока:

• Приоритет
  
• Крайний срок исполнения
  
• Входные параметры
  
• Результаты
  
  

Выбор исполнителя

Исполнитель — это пользователь или группа пользователей, которые будут работать с задачей. По умолчанию исполнителем является Инициатор процесса –  пользователь, запустивший экземпляр процесса.

Для назначения задачи используется блок контролов "Исполнитель". Доступны два способа указания исполнителя:

Несколько пользователей (с помощью кнопки "Выбрать значение")

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

• После выбора элемента из списка поле "Исполнитель" заполняется автоматически.

• Это позволяет динамически назначать нескольких пользователей в качестве исполнителей задачи на основе данных, полученных в процессе (например, из результата предыдущего шага)
  

Один или группа пользователей (с помощью кнопки "Заполнить значение" )

При нажатии на кнопку откроется модальное окно с выбором исполнителя. В списке отображаются пользователи с одной из ролей "Исполнитель задач", "Владелец процесса" или "Администратор процессов", которые будут работать с ЭФ или группа пользователей.

Если дизайнер процесса хочет назначить на пользовательскую задачу одного конкретного сотрудника, то он должен выбрать его из списка пользователей.

Если дизайнер процесса хочет назначить на пользовательскую задачу группу пользователей, то он должен выбрать ее в качестве исполнителей. В этом случае каждому пользователю из этой группы будет предоставлена возможность взять эту задачу на себя в разделе "Задачи". При этом задачу может назначить на себя только один пользователь. Подробнее в вкладка "Активные" для роли "Исполнитель задач".

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

Приоритет

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

У задачи могут быть следующие приоритеты:

1. Высокий.
2. Средний.
3. Низкий.

Крайний срок исполнения

Свойство позволяет задать время, по истечении которого задача либо помечается как просроченная (подсвечивается красным во вкладке «Задачи»), либо автоматически завершается системой — в зависимости от выбранного режима.

Крайний срок задается в днях, часах и минутах и отсчитывается от момента назначения задачи на конкретного исполнителя.

Если крайний срок исполнения задачи истекает, то задача будет помечаться красным цветом во вкладке «Задачи».

Дополнительно доступен чекбокс «Автоматическое завершение»

• Если чекбокс не активирован, то время в полях «Дни/Часы/Минуты» будет использовано, как крайний срок выполнения задачи (отображается только визуально, задача помечается красным, если срок исполнения истекает).

• Если чекбокс активирован, указанное время будет использовано, как таймер для автоматического завершения задачи системой.

При активации автоматического завершения становится доступно обязательное поле "Значение кнопки подтверждения". Указанное в нём значение будет присвоено в результате полю "__form_result" при автоматическом завершении задачи. Подробнее про поле см. в Результаты.

Особенности работы:

1. Ограничение времени применяется только если хотя бы одно значение в полях «Дни/Часы/Минуты» больше 0.

2. Отсчёт времени начинается с момента назначения задачи исполнителю.

3. Полю «__form_result» присваивается значение, указанное в настройках блока в поле «Значение кнопки подтверждения» (значения, заданные в редакторе кнопок ЭФ, в этом случае не учитываются).

4. Если в экранной форме остались пустые обязательные поля, процесс останавливается с ошибкой, а в лог экземпляра выводится сообщение:
   "Процесс остановлен из-за ошибки в задаче. При автоматическом завершении обязательные поля должны быть заполнены." 
   

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

• на этапе создания экранной формы — в редакторе экранных форм у конкретного элемента в поле «Значение по умолчанию»;

• или при настройке блока «Экранная форма» в конструкторе процессов –  у обязательного входного параметра.

Или убрать обязательность у элемента на этапе создания Экранной формы.

Пример:
В блоке выбрана опубликованная экранная форма с текстовым полем и кнопкой (значение у кнопки подтверждения = 1).
В свойствах блока активировано автоматическое завершение и задано значение кнопки подтверждения = 0.

• При завершении пользователем в результат «__form_result» записывается значение 1.

• При автоматическом завершении в результат «__form_result» записывается значение 0.

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

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

Поля с входными параметрами создаются автоматически на основе внутренней спецификации ЭФ. Каждому элементу на форме, у которого в редакторе экранных форм было задано "Название входного параметра", соответствует свой входной параметр. Дизайнеру процесса остается только задать значения этих параметров при настройке блока.

Поля с входными параметрами создаются автоматически на основе внутренней спецификации на ЭФ. Дизайнеру процесса остается только задать значения этих параметров.

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

Например, у процесса, схема которого изображена ниже на рисунке, есть 2 входных параметра "a" и "b". У ЭФ №1 тоже 2 входных параметра. Можно привязать значения входных параметров процесса к входным параметрам ЭФ №1:

В этом случае исполнитель задачи во время работы с ЭФ №1 увидит в ней 2 поля со значениями параметров процесса, которые были заданы либо по умолчанию, либо при старте.

Результаты

После выполнения пользовательской задачи данные, введенные пользователем в экранной форме/значения по умолчанию становятся доступны другим блокам процесса в виде результатов.

Поля с результатами создаются автоматически на основе настроенной ЭФ. Дизайнер процесса может выбрать переменные, в которые будут записаны полученные результаты, либо оставить поля пустыми.

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

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

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

При автоматическом завершении в это поле записывается значение, указанное в поле "Значение кнопки подтверждения" на этапе настройки крайнего срока исполнения.

Результаты при назначении на нескольких исполнителей:

Когда задача назначается на нескольких пользователей (через динамический выбор в свойстве "Исполнитель", результаты экранной формы формируются в виде коллекций.

• Коллекция пользователей: Содержит структурированные данные о каждом назначенном пользователе (ID, ФИО, должность, логин, почта, статус). Поле __form_executors с коллекцией пользователей не отображается в свойствах "Результаты".
  Результат можно выбрать во входных параметрах с типом коллекция у других блоков для передачи, например, в робота или снова в поле с выбором исполнителя у другой экранной формы
  
  

• Коллекции результатов ЭФ: Для каждого параметра в результате экранной формы создается отдельная коллекция. Эти коллекции содержат данные, введенные каждым из пользователей, в порядке выполнения ими задач.

  • Пример: Если трое пользователей заполнили текстовое поле "Достопримечательность" (название результата Достопримечательность), то после выполнения экранной формы всеми тремя пользователями результат будет представлять собой коллекцию из трех строк. Пустые поля также занимают свое место в коллекции, сохраняя порядок и количество элементов соответственно ответам каждого пользователя
    .

Настройка задачи с автоматическим завершением

1. В редакторе экранных форм пользователь настраивает и публикует экранную форму с двумя кнопками подтверждения. Значение кнопки "Подтвердить" – Подтверждение, значение кнопки "Отменить" – Отмена.
   
2. В Конструкторе процессов пользователь выбирает опубликованную экранную форму в соответствующем блоке и настраивает срок исполнения, активируя чекбокс "Автоматическое завершение"
   
3. В поле "Значение кнопки подтверждения" пользователь вводит то значение, которое будет присвоено в результате полю __form_result, если задача завершится автоматически. 
4. Пользователь запускает отладку процесса. Подробнее см. в Отладка схемы процесса

Логический шлюз "И"

Логический шлюз "И" предназначен для распараллеливания процесса по нескольким веткам. Число параллельных веток не ограничено и они должны сходиться в одном блоке.

У блока имеются свойства:

• Название
• Описание
• Цвет
• Условия выполнения. Свойство не настраивается и не отображается (является встроенным). Блок по умолчанию всегда ожидает все направляющие.

Логический шлюз "Или"

Логический шлюз "Или" предназначен для ветвления процесса по условию. Условие может быть одно или несколько.
Условие задается только после создания направляющей с последующими блоками схемы. Число задаваемых условий блока равно числу исходящих из блока направляющих.

Конструктор условий

На схеме, изображенной ниже, блок "Или" имеет две исходящие направляющие к двум блокам "ЭФ":

Соответственно такой блок будет иметь 2 условия. Условия располагаются под общими свойствами блока на панели "Условия". Условия задаются с помощью конструктора условия. Чтобы задать условие нужно нажать на иконку "Шестеренка" у выбранного условия.
В результате нажатия появится модальное окно конструктора условия следующего вида:

В конструкторе условия можно задавать одно или несколько условий, соединенных логическим операторами "И" или "Или". Каждое условие задается 2 операндами (первый и второй параметры) и логической операцией, расположенной между операндами. 

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

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

В конструкторе доступны следующие логические операции:

• равно
• не равно
• больше
• меньше
• содержит
• не содержит

В качестве примера зададим для нашего блока "Или" условие для ветки "1 условие" вида: i1 >= 0. Это можно сделать с помощью двух условий, соединенных операцией "Или":

Сохраним условие, нажав на кнопку "Создать".

Аналогично создаем и второе условие  для ветки "2 условие" типа: i1 < 0:

В результате получим 2 условия у блока "Или":

Условия можно редактировать в любой момент времени, нажав на "Шестеренку". Чтобы удалить условие, нужно нажать на иконку с крестиком на панели условий или на "Корзину" в конструкторе условий.

Блок "Процесс"

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

У блока имеются свойства:

• Название (заполняется автоматически после выбора подпроцесса);
• Запуск подпроцесса автономно – чекбокс для настройки автономного запуска 
• Описание процесса (заполняется автоматически после выбора подпроцесса);
• Условия выполнения. Свойство не настраивается и не отображается (является встроенным). Блок по умолчанию всегда ожидает хотя бы одну направляющую.
• Цвет блока (заполняется дизайнером процесса);
• Входные параметры (заполняются дизайнером процесса после выбора процесса)
• Результаты

Выбор процесса

Чтобы выбрать процесс в качестве подпроцесса нужно нажать на кнопку "Выбрать процесс".

При нажатии на кнопку "Выбрать процесс" появляется список опубликованных процессов, в котором необходимо выбрать тот, который будет выполнять задачу. Выбор процесса осуществляется с помощью ЛКМ.
В качестве примера выбран процесс "Сложение двух чисел", который, как ясно из названия, выполняет сложение двух чисел:

При выборе процесса мы воспользовались строкой поиска.

Общие свойства

После выбора процесса на панели свойств блока "Процесс" появятся:

1. Название процесса,
2. Описание процесса.

Остальные свойства должен заполнить дизайнер процесса.

Настройка автономного запуска

В свойствах блока после выбора процесса отображается чекбокс "Запускать подпроцесс автономно":

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

При активации чекбокса:

• На схеме у блока появляется специальный значок в виде замка
  
  

• В инспекторе блока скрывается блок контролов "Результаты", а все ранее заполненные в нём данные очищаются
  
  

• Результаты этого подпроцесса перестают быть доступны для выбора в качестве входных параметров в других блоках схемы.

• В инспекторе блока во время отладки скрывается кнопка "Открыть процесс", так как во время отладки происходит лишь отметка о запуске автономного процесса, а его реальный экземпляр не создается. После публикации и запуска процесса эта кнопка в инспекторе экземпляра родительского процесса отобразится и позволит перейти к экземпляру запущенного автономного подпроцесса.

При деактивации чекбокса:

• Значок в виде замка на схеме пропадает
  
  

• Если у выбранного подпроцесса есть результаты (блок "Финиш"), блок контролов "Результаты" снова отображается в инспекторе.

• Результаты подпроцесса снова выводятся при выборе входных параметров в других блоках.
  Примечание: Если ранее в полях результатов были указаны значения, они не восстанавливаются после повторного отображения контрола).

• При отладке в инспекторе снова начинает отображаться кнопка "Открыть процесс".

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

Поля для входных параметров подпроцесса появляются автоматически на основе выбранного подпроцесса:

• Входные параметры у блока "Процесс" = параметры в блоке "Старт" в выбранном подпроцессе. 
• Если на схеме выбранного подпроцесса в блоке "Старт" не было создано входных параметров, то и в свойствах блока в основном процессе они не отобразятся.

Результаты

Поля для входных параметров подпроцесса появляются автоматически на основе выбранного подпроцесса:

• Результаты у блока "Процесс" = параметры в блоке "Финиш" в выбранном подпроцессе.
• Если на схеме выбранного подпроцесса в блоке "Финиш" не было создано параметров, то и в свойствах блока в основном процессе они не отобразятся.

Блок "API"

Блок API представляет собой звено в процессе взаимодействия с REST API, которая управляет отправкой запросов к внешнему серверу и обработкой ответов от него. 

У блока имеются основные свойства:

• Название – название или идентификатор блока, который используется для обозначения конкретного действия REST API
• Описание – краткое пояснение к блоку, описывающее его
• Цвет блока 
• Условия выполнения. Свойство не настраивается и не отображается (является встроенным). Блок по умолчанию всегда ожидает хотя бы одну направляющую.

Помимо основных свойств блок "API" имеет следующие свойства:

Блок "Заметка"

Блок "Заметка" не влияет на ход выполнения процесса и предназначен для создания комментариев в процессе. 

В заметке можно изложить любые соображения, касающиеся назначения процесса, принципов его разработки, особенности при выполнении процесса.

У блока есть следующие свойства:

• Текст - текст, который будет отображаться в заметке;
• Цвет фона (по умолчанию белый);
• Цвет рамки (по умолчанию черный);
• Цвет текста (по умолчанию черный);
• Размер шрифта текста (по умолчанию 16).

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

Блок "Обработка значений"

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

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

Свойства блока