Платформа 3V/Согласование/Реестр процессов

Реализовано в версии 0.40

Реализовано отображение реестра всех процессов согласования, в котором существует возможность редактировать экземпляры процесса. Для этого следует нажать на требуемый изменения экземпляр основного процесса или его подпроцесса и перейти в открывшееся окно с JSON. Реестр открывается по кнопке на левой панели управления навигатора. Для его настройки в конфигурационном файле указывается код настроенного отчёта с реестром процессов.

Для того, чтобы настроить отчет для реестра процессов согласования требуется настроить Внешний справочник на объекте Соединение с источником данных .../workflow/api/WorkflowDataSourceView/Processes/ и в качестве идентификатора объекта задать AllRunnedProcesses. Так же в справочнике необходимо настроить следующее:

• Тип атрибута StateId должен быть указан как Идентификатор
  
• Тип атрибута ParentStateId должен быть указан как Родитель
  
• Тип атрибута Name должен быть указан как Наименование
  

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

• Идентификатор процесса или подпроцесса(Id)
• Идентификатор родительского процесса(для подпроцессов)(ParentId)
• Наименование объекта согласования/экземпляра процесса/подпроцесса с наименованиями параметров(Name)
• Идентификатор экземпляра процесса(EntityId)
• Идентификатор типа объекта: 1 - объект согласования, 2 - объект согласования подпроцесса, 3 - экземпляр процесса/подпроцесса, (EntityType)
• Наименование текущего состояния(StateName)
• Значение свойства localizedComment объекта согласования (StateModelComment)
• Дата запуска процесса (StartedDate)
• Дата перехода в текущее состояние (StateChangedDate)
• Регламентная дата, если она настроена для текущего состояния (StateRegulationDate)
• Ответственные за шаги на текущем состоянии (StateResponsible)
• Признак "завершенности" экземпляра подпроцесса (IsFinished)
• Общее количество процессов (TotalProcessCount)
• Количество завершенных процессов (FinishedProcessCount)

Далее необходимо создать сам отчет с идентификатором REPORT_WORKFLOW_STATUSES (данный код указывается в конфигурационном файле, как было написано выше), настроить отчет можно в любом виде, на усмотрение пользователя. Единственное, необходимо, чтобы первым столбцом выводился атрибут Name, для корректного формирования названия объекта - экземпляра процесса и наименование параметров, с которыми он запущен.

Примеры

Пример настройки реестра процессов

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

JSON пример настройки гиперссылок для строк с экземплярами процесса и подпроцесса

 1   "hyperlinkOptions": {
 2             "metaObjectSource": {
 3               "formula": {
 4                 "expression": "if(IsNullOrEmpty([2]) or [3] <> 3, Null(), [1])",
 5                 "operands": [
 6                   {
 7                     "dictionaryId": 125348,
 8                     "attribute": {
 9                       "discriminator": "OwnAttributeDefinitionDto",
10                       "id": 23
11                     },
12                     "attributeId": 23,
13                     "discriminator": "AttributeFormulaOperandDto",
14                     "code": null,
15                     "id": 1,
16                     "name": null
17                   },
18                   {
19                     "dictionaryId": 125348,
20                     "attribute": {
21                       "discriminator": "OwnAttributeDefinitionDto",
22                       "id": 4
23                     },
24                     "attributeId": 4,
25                     "discriminator": "AttributeFormulaOperandDto",
26                     "code": null,
27                     "id": 2,
28                     "name": null
29                   },
30                   {
31                     "dictionaryId": 125348,
32                     "attribute": {
33                       "discriminator": "OwnAttributeDefinitionDto",
34                       "id": 24
35                     },
36                     "attributeId": 24,
37                     "discriminator": "AttributeFormulaOperandDto",
38                     "code": null,
39                     "id": 3,
40                     "name": null
41                   }
42                 ],
43                 "code": null,
44                 "id": 1,
45                 "name": null
46               },
47               "discriminator": "FormulaValueSourceDto"
48             },
49             "parameterSources": [],
50             "discriminator": "MetaObjectHyperlinkOptionsDto",
51             "openTarget": "SameWindow"
52           }

Настройка параметра

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

• Добавить объект "Соединение с источником данных" .../repository/api/RepositoryDataSource/
• Добавить внешний справочник на этом соединении, в качестве идентификатора объекта задать MetaObjects
• Для следующих атрибутов настроить тип:

Тип атрибута Id должен быть указан как Идентификатор
Тип атрибута ParentId должен быть указан как Родитель
Тип атрибута Name должен быть указан как Наименование

• Справочник должен быть с включенным кэшем
• В справочник реестра процессов необходимо добавить параметр

JSON пример настройки параметра в справочнике

 1 "parameters": {
 2     "definitions": [
 3       {
 4         "id": 1,
 5         "name": "Число"
 6       }
 7     ],
 8     "defaultValues": [
 9       {
10         "discriminator": "SimpleParameterValueDto",
11         "parameterId": 1,
12         "value": [
13           1
14         ]
15       }
16     ]
17   },

• В отчете реестра процессов добавить, созданный ранее, внешний справочник объектов в качестве параметра, для параметра настроить фильтр на тип объекта согласования

JSON пример настройки параметра с фильтром в отчете реестра процессов

 1 "parameters": [
 2     {
 3       "dictionaryId": 0,
 4       "options": {
 5         "groupingMethod": "Default",
 6         "virtualElements": [],
 7         "dictionaryId": 195546,
 8         "filter": {
 9           "value": [
10             9
11           ],
12           "skipIfValueNull": false,
13           "attributeId": null,
14           "attribute": {
15             "discriminator": "OwnAttributeDefinitionDto",
16             "id": 23
17           },
18           "conditionType": "AttributeEqualConstant",
19           "discriminator": "ValueConditionalDictionaryFilterDto",
20           "inversion": false
21         },
22         "hierarchyId": null,
23         "limit": null
24       },
25       "discriminator": "DictionaryParameterDto",
26       "defaultValue": [
27         114228
28       ],
29       "value": [
30         114228
31       ],
32       "isMultiselect": true,
33       "isEmptyValuePossible": true,
34       "isDisableable": false,
35       "isDisabled": false,
36       "id": 1,
37       "name": "Согласования"
38     }
39   ],

• Сохранить изменения в отчете, далее при открытии реестра в нем должна появиться панель с параметром.

!Важно: есть ограничение со стороны справочников, если для справочника процессов указать наличие параметра, но в отчете скинуть его на null - то упадет ошибка, что значение параметра не задано.