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

Перечень типов действий

Тип действия (портал)Имя activity в ElsaОбработчикID типа элемента действияПроверка условий«Исходный элемент(ы)»
Установить значение атрибутаУстановить значение поляSetItemFieldActivity5e016e29-262e-467b-9d27-ac05dcf0c292ДаДа
Установить значение атрибута связанных объектовУстановить значение поля вложенияSetReferenceItemFieldActivity62603ea8-bf37-40f9-8114-44655d2287aeДаДа
Установить права доступаУстановить права на элементSetItemPermissionActivity4b1ae7af-7fea-4dc0-b62a-dcd94614666fДаДа
Забрать права доступаЗабрать права на элементRevokeItemPermissionActivity272df0b0-bb2f-45e3-bc3d-2f0a46f14fa1ДаДа
Создать этап процесса— (встраивается шаблон этапа)WorkflowStageActivity41b23e3a-9385-45b5-883f-353bfdd7043dНетНет
Обработка вложений по результатам согласованияУстановить значение поля вложенияSetReferenceItemStatusActivityf2b37167-f793-4aff-b1dc-959a98cb1b45ДаДа
Переход на этапПереход на этапMoveToStepActivitye6d3a8b6-597b-46b2-8b27-f29651da7e01ДаДа
Вызов внешнего сервисаВызов внешнего сервисаExtServiceActivity23b0d24a-dea5-42b0-ada3-7dc545f5bfacДаДа
Опубликовать документОпубликовать документPublishDocumentActivity75cc50d2-b6cd-4aa4-9baa-52e7dd98ab3aДаДа
Выполнить процедуруВыполнить процедуруExecuteProcedureActivityd6cb2a35-fa75-4557-95b9-bbbaf7eb06feДаДа
Добавить штампДобавить штампAddStampActivity7430e850-7da0-43a3-9392-d43ed781bf74ДаДа
Добавить штамп (шаблон) Добавить штампAddStampActivityd1b55110-1258-4e05-8321-cbdd8acca085ДаДа
Добавить пустую страницуДобавить пустую страницуAddEmptyPageActivitycf47af15-5f3a-41f9-bc0f-08415e8f5272ДаДа
Отправить оповещениеОтправить оповещениеSendMailActivity59345258-ce20-4150-b904-46a10f1f57bdДаДа

Столбец «Имя activity в Elsa» — отображаемое имя обработчика в панели Elsa Dashboard. Идентификаторы типов действий пригодятся при диагностике и переносе настроек между стендами.

Общие поля и правила выполнения действий

Общие атрибуты карточки действия

АтрибутОписание
НазваниеТекст. Название действия; отображается в карточке правила и как имя activity в движке. Рекомендуется отражать суть: «Установить значение атрибута (Статус файла)».
АвтоматизацияПравило автоматизации, к которому относится действие. Заполняется автоматически при создании действия из карточки правила.
ПорядокЧисло; определяет последовательность выполнения действий внутри правила (по возрастанию).
Исходный элемент(ы) (формула)Необязательно (присутствует не у всех типов действий). Формула, возвращающая элемент(ы), над которыми выполняется действие вместо элемента-триггера: элемент, значение подстановки, GUID (в том числе строкой) или список таких значений. Пустой результат — действие не выполняется ни для одного элемента.

Правила выполнения

  1. Действия правила выполняются последовательно по полю «Порядок»; если на событие сработало несколько правил, их действия образуют одну цепочку.
  2. Перед каждым действием проверяются все условия его правила в контексте элемента-триггера. Если хотя бы одно не выполнено — действие пропускается, цепочка продолжается.
  3. Затем определяются исходные элементы: результат формулы «Исходный элемент(ы)» или сам элемент-триггер.
  4. Для каждого исходного элемента действие выполняется в отдельной транзакции. Формулы действия (значение атрибута, получатели, комментарий и т.п.) вычисляются в контексте исходного элемента.
  5. Действия выполняются от имени системного пользователя: права инициатора события не проверяются, в «Изменено кем» записывается системная учётная запись (GUID 00000000-0000-0000-0000-000000000001) — это можно использовать в условиях, чтобы отличать изменения пользователя от изменений автоматизации.
  6. Изменения элементов, сделанные действием, — новые события, которые могут вызвать другие правила (каскад).
  7. Ошибка при выполнении действия прерывает цепочку.

Контекст формул

Где используется формулаКонтекст (This())
Условие правилаЭлемент-триггер
«Исходный элемент(ы) (формула)»Элемент-триггер
Формулы действия («Формула», «Получатели», «Комментарий версии», «Сервис обработки», «Исполнители» и др.)Исходный элемент (по умолчанию — элемент-триггер)
Формула действия «Установить значение атрибута связанных объектов»Исходный элемент (процесс/задача), а не связанный объект
Формулы элементов профиля штампаДокумент, на который наносится штамп

Несколько действий одного типа

В одном правиле можно настроить несколько действий одного типа — они выполнятся последовательно при срабатывании триггера. Для добавления действия нажмите «+» в разделе действий карточки правила. Если нужны действия разных типов на одно событие, создайте несколько правил в том же столбце Канбан-доски.

Страницы типов действий

  • No labels