Компоненты

Общая схема взаимодействия

Пользователь / действие системы
        │  сохранение элемента (создание или изменение атрибутов)
        ▼
┌─────────────────────────── ПОРТАЛ ───────────────────────────┐
│ 1. Определение изменённых атрибутов                          │
│ 2. Поиск правил в списке «Автоматизация» (automation):       │
│    Тип элемента + Атрибут + [Значение]                       │
│ 3. Группировка сработавших правил по событию                 │
└───────────────┬──────────────────────────────────────────────┘
                │ POST api/workflow/Execute/{itemId}
                │ { "itemIdList": [ <ID правил автоматизации> ] }
                ▼
┌────────────────── WORKFLOW.MANAGER (Elsa 2.13) ──────────────┐
│ 4. Сборка definition «automationWorkflow_<ТЭ>_<значение>»    │
│    из действий (automation_action) всех правил группы        │
│ 5. Создание и запуск экземпляра процесса Elsa                │
│ 6. Выполнение activity по порядку:                           │
│    проверка условий (automation_condition) → действие        │
│    ├─ изменения элементов → новые события → вложенные цепочки│
│    ├─ Этап процесса → задачи → ожидание (bookmark)           │
│    ├─ Отправить оповещение ──► Портал: модуль Mail (API)     │
│    └─ Штамп / пустая страница ► Портал: модуль Stamp (API)   │
└───────────────▲──────────────────────────────────────────────┘
                │ POST api/workflow/SendSignalTaskClosed/{taskId}
                │ POST api/workflow/Abort/{workflowInstanceId}
┌───────────────┴───── ПОРТАЛ: модуль Workflows ───────────────┐
│ • запуск процесса, маршрут, задачи, решения по вложениям      │
│ • сигнал «задача завершена» при переходе задачи в «Завершена» │
│ • при завершении процесса: права → только чтение, отмена      │
│   экземпляра Elsa                                             │
└──────────────────────────────────────────────────────────────┘

Модель данных правил

Правило автоматизации (список «Автоматизация», automation)

Элемент списка создаётся с типом «Изменено значение атрибута (правило автоматизации)». Основные атрибуты:

Условия (список «Автоматизация (условия)», automation_condition)

• Каждое условие ссылается на правило (атрибут «Автоматизация») и имеет «Порядок».
• Поддерживаемый тип условия — «Формула». Условия других типов движком игнорируются (считаются выполненными).
• Все условия правила объединяются по «И».

Действия (список «Автоматизация (действия)», automation_action)

• Каждое действие ссылается на правило (атрибут «Автоматизация») и имеет «Порядок», задающий последовательность выполнения.
• Тип элемента действия определяет обработчик (activity), который его выполнит. Соответствие типов и обработчиков приведено на странице Типы автоматических действий .

Формирование процесса (definition) в Elsa

1. Портал передаёт в Workflow.Manager идентификатор элемента-триггера и список идентификаторов правил, сработавших на одно событие.
2. Имя definition формируется по шаблону automationWorkflow_<Название типа элемента>_<Название значения> с транслитерацией (для одиночных правил часть «значение» пустая). Имя берётся по первому правилу группы; для одного события существует одно definition, которое пересобирается при каждом срабатывании (список activity и связей очищается и формируется заново).
3. Для каждого правила группы действия выбираются в порядке поля «Порядок» и добавляются в definition последовательно, соединяясь исходом Done. Идентификатор activity: <№ правила>_<Обработчик>_automation_<ID правила>_action_<ID действия>_<GUID>, отображаемое имя — «Название» действия.
4. Действие «Создать этап процесса» не добавляется как одна activity: в цепочку встраиваются все activity шаблона этапа (definition Elsa, указанное в поле «Шаблон процесса» по его внутреннему имени). Шаблон обязан содержать activity ForEach; activity, подключённая к исходу Done цикла, считается финальной точкой этапа, к ней присоединяется следующее действие цепочки.
5. В переменные definition записываются: itemId — элемент-триггер; stage — параметры этапа (ID действия и вычисленный список исполнителей); stampProfile — профиль штампа текущего этапа процесса (для штампа по профилю этапа).
6. Создаётся экземпляр процесса (режим сохранения — при приостановке, Suspended), его идентификатор записывается в атрибут элемента elsa_workflow_id (если атрибут есть у типа элемента).
7. Экземпляр запускается. Если выполнение завершилось с ошибкой, ошибка возвращается вызывающей стороне.

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

Обработчики большинства типов действий наследуют общий алгоритм (базовая activity):

...

• Все действия выполняются от имени системного администратора. Права пользователя, инициировавшего событие, не проверяются.
• Изменения, сохранённые действием, порождают новые события, которые обрабатываются синхронно (вложенные цепочки) до перехода к следующему действию.
• Ошибка в обработчике прерывает выполнение цепочки: последующие действия не выполняются.
• Исключения из общего алгоритма: «Создать этап процесса» (встраиваемый шаблон, условия не проверяются) и служебные activity шаблона этапа.

Этап процесса и ожидание задач

1. activity «Добавить узел маршрута» создаёт (или находит) узел маршрута текущего этапа — этап определяется атрибутом «Этап процесса» (workflow_step), а при его отсутствии — «Статус процесса».
2. Цикл ForEach по списку исполнителей вызывает activity «Создать задачу»: создаётся задача, к ней привязываются все вложения процесса связью «вложение задачи на согласование», назначаются права.
3. activity ожидания завершения задач (TaskClosedActivity) создаёт закладки (bookmark) по идентификаторам задач, и экземпляр процесса Elsa переходит в состояние Suspended.
4. Когда исполнитель завершает задачу (статус задачи — «Завершена»), модуль Workflows портала отправляет в движок POST api/workflow/SendSignalTaskClosed/{taskId}. Движок возобновляет экземпляр, переводит завершённую задачу в режим «только чтение» и проверяет, все ли задачи этапа завершены.
5. Когда завершены все задачи, рассчитывается статус согласования этапа (единый статус задач или «частично согласовано» при расхождении), и цепочка продолжается следующими действиями.

Завершение процесса

• Процесс считается завершённым, когда «Статус процесса» принимает значение «Завершен» или «Прерван».
• При переходе в такой статус модуль Workflows переводит права на процесс в режим «только чтение» и отправляет в движок POST api/workflow/Abort/{elsa_workflow_id} — ожидающий экземпляр Elsa отменяется, его закладки удаляются.
• При прерывании процесса инициатором (или администратором) незавершённые задачи текущего этапа удаляются, вложениям восстанавливается статус, который был до запуска (атрибут «Предыдущий статус документа», если он есть у типа файла).

REST API

Workflow.Manager

Доступ к API и к панели Elsa Dashboard (открывается по базовому пути приложения) возможен только с действующим токеном сессии пользователя портала; движок обращается к порталу с токеном системного пользователя.

API портала, вызываемые движком

Адрес портала для этих вызовов берётся из параметра конфигурации локального адреса портала; адрес, подставляемый в письма, — из параметра публичного адреса портала.

API модуля Workflows

Конфигурация

Диагностика

• Экземпляры процессов и их журнал выполнения доступны в Elsa Dashboard приложения Workflow.Manager; идентификатор последнего экземпляра хранится в атрибуте elsa_workflow_id элемента.
• Definition каждого события называется automationWorkflow_... — по имени удобно найти, какие действия и в каком порядке попали в цепочку.
• Если действие «не срабатывает», проверьте: условия правила (в контексте элемента-триггера), наличие изменяемого атрибута у типа целевого элемента (иначе действие пропускается без ошибки), расширение файла для действий с PDF, наличие связей нужного типа для действий со связанными объектами.

...