¶ Описание модуля
Позволяет осуществлять автоматическое создание рабочих процессов из шаблона процесса, а также управление созданными рабочими процессами. Модуль работает с помощью сценариев автоматизации, которые добавляются во вкладке Автоматизация в приложении Pilot-myAdmin.
Для использования модуля сценарий автоматизации должен содержать действие (activity) LMPCreateTasksFromTemplateAction и id шаблона процесса.
Информация о структуре сценариев автоматизации находится в инфоцентре cистемы Pilot в подразделе Pilot-myAdmin раздела Администрирование
¶ Пример сценария и его описание
Ниже в качестве примера приведён сценарий автоматизации рабочего процесса, который запускается, если атрибуты документа Состояние (status) и Вид документа (document_type) имеют значения Замечаний нет (noRemarks) и Чертеж соответственно
[
{
"when": "AttributeChanged",
"params": {
"triggerType": "Client,Server",
"sourceTypes": [
"document"
],
"attributeNames": [
"status",
"document_type"
],
"itemChangeKind": "Create,Modify"
},
"then": [
{
"activity": "LMPCreateTasksFromTemplateAction",
"params": {
"sourceTypes": [
"document"
],
"target": "Self",
"targetTypes": [],
"template": "c6ac27ca-f8ef-4e68-9b34-e02a9f679768",
"andConditions": {
"conditions": [
{
"attribute": "document_type",
"value": "Чертеж"
},
{
"attribute": "status",
"value": "noRemarks"
}
]
}
}
}
]
}
]
Действие (activity) LMPCreateTasksFromTemplateAction создаёт рабочий процесс из шаблона для объекта на котором сработал сценарий автоматизации. Действие добавляет следующие параметры:
- template - идентификатор шаблона рабочего процесса. Обязательный параметр. Чтобы узнать id шаблона процесса нужно во вкладке заданий приложеия Pilot на панели управления нажать Шаблоны. Откроется вкладка с таблицей, которая содержит информацию о существующих шаблонах.
- orConditions (или andConditions) - json-объект задающий дополнительные условия. Необязательный параметр. Если объект попадает под заданные условия то действие будет выполнено. Объект является рекурсивным, то есть может содержать вложения самого себя.
Рис. 33. Кнопка открытия таблицы шаблонов
Рис. 34. Таблица шаблонов
Объект orConditions (или andConditions) содержит ключи:
- conditions - простые условия вида
ключ: значениедля проверки, которые будут обработаны как логическое И (andConditions) или логическое ИЛИ (orConditions) в зависимости от того в каком объекте объявлены эти условия (вorConditionsили вandConditions). Обязательный параметр. - orConditions - вложенный объект orConditions. Может отсутсвовать
- andConditions - вложенный объект andConditions. Может отсутсвовать
"orConditions" (или "andConditions"): {
"conditions": [
{
"attribute": "name",
"value": "ets"
}
],
"orConditions": { }, --- Может отсутствовать
"andConditions": { },--- Может отсутствовать
}
В зависимости от того в каком объекте объявлены ключи, указанные выше, логика обработки объекта будет отличаться:
- для объекта
orConditionsвнутренние ключи будут обработаны какрезультат = conditions или orConditions или andConditions - для объекта
andConditionsвнутренние ключи будут обработаны какрезультат = conditions и orConditions и andConditions
То есть логическая связь между списком простых условий (conditions) и вложенными объектами (orConditions, andConditions) зависит от родительского ключа, в котором они были объявлены.
В примере сценария автоматизации использован ключ andConditions, а значит под условия выполнения действия попадают только те документы, которые имеют и вид документа "Чертеж" и состояние "Замечаний нет".
В примере сценария автоматизации json-объект andConditions содержит только простые условия для проверки conditions, но не содержит вложенных orConditions и/или andConditions.
Рассмотрим вариант сценария, где json-объект имеет более сложную вложенность, на примере orConditions:
"orConditions": {
"conditions": [
{
"attribute": "lmp_revision",
"value": "IFA"
},
{
"attribute": "lmp_revision",
"value": "IFC"
}
],
"andConditions": {
"conditions": [
{
"attribute": "document_type",
"value": "Чертеж"
},
{
"attribute": "status",
"value": "noRemarks"
}
]
}
}
Под условия попадают объекты, у которых Ревизия "IFA" или "IFC", или Вид документа "Чертеж" и Состояние "Замечаний нет".
Предположим что есть объект, который проходит проверку соответствия сценарию и содержит следующие арибуты и их значения:
- Вид документа (document_type) имеет значение Локальная смета (или любое другое, отличное от "Чертеж")
- Состояние (status) имеет значение Замечаний нет (noRemarks)
- Ревизия (lmp_revision) имеет значени IFC
Для понимания логики обработки структуру json-объекта orConditions следует рассмотреть с самой глубокой вложенности, то есть с конца. В данном случае конечный json-объект это andConditions, который содержит массив conditions.
Так как значение атрибута Тип не попадает под условия сценария, обозначим его false. Значение атрибута Состояние удовлетворяет условие, обозначим его true. Исходя из этого получается:
"orConditions": {
"conditions": [
{
"attribute": "lmp_revision",
"value": "IFA"
},
{
"attribute": "lmp_revision",
"value": "IFC"
}
],
"andConditions": {
"conditions": [
false,
true
]
}
}
Результатом обработки массива будет false, так как все условия conditions находятся внутри andConditions, а значит связаны логическим "И":
"orConditions": {
"conditions": [
{
"attribute": "lmp_revision",
"value": "IFA"
},
{
"attribute": "lmp_revision",
"value": "IFC"
}
],
"andConditions": {
"conditions": false
}
}
Так как объект andConditions под собой больше не имеет вложенных объектов, то результатом обработки конечного json-объекта будет false ("andConditions": false).
Аналогично рассмотрим массив выше. Так как у объекта, проходящего проверку соответствия сценарию, атрибут Ревизия имеет значение IFC, то первое условие обозначим как false, а второе как true
"orConditions": {
"conditions": [
false,
true
],
"andConditions": false
}
Результатом обработки массива будет true, так как все conditions находятся внутри orConditions и связаны логическим "ИЛИ":
"orConditions": {
"conditions": true,
"andConditions": false
}
Так как json-объект orConditions является родительским, то общим результатом его обработки будет true. То есть предполагаемый объект, проходящий проверку соответствия сценарию, попадает под условия сценария.
Атрибуты типа Справочник, Организационная единица и Наследуемый не поддерживают conditions
¶ Просмотр связанных процессов
Для просмотра связанных процессов выбрать комплект, документ, лист замечаний или трансмиттал. На панели инструментов нажать кнопку «Связанные процессы». Откроется новая вкладка со сводной таблицей по всем связанным с выбранным объектом системы процессам.
Для сортировки по нескольким колонкам необходимо нажать на заголовки колонок с зажатой клавишей Shift. Для фильтрации по колонкам нажать на кнопку «Фильтр», расположенной на панели инструментов.
Рис. 35. Открытие сводной таблицы со связанными процессами