Типы автоматических действий
1. Автоматические действия в системе имеют следующие типы:
- «Установить значения атрибута» - присвоение значения указанному атрибуту заданного элемента. Элемент можно задать отличный, от текущего, для этого есть поле Исходный элемент(ы) (формула)
- «Установить права доступа» - установка прав на указанный элемент
- «Забрать права доступа» - снятие прав доступа на элемент
- «Установить значения атрибута связанного элемента» - присвоение значения атрибуту у связанного элемента. Нужно сделать ссылку на расшифровку значения связанного элемента. .
- «Создать этап процесса» - привязка события к этапу процесса
- «Вызов внешнего сервиса» - вызов внешнего сервиса по REST API
- «Опубликовать документ» - публикация новой версии документа
- «Выполнить процедуру» - выполнение процедуры (например, копирование документа)
- «Добавить штамп» - проставление QR-кода, штампа ВПР и пр.
- «Обработка вложений по результатам согласования» - смена статуса вложения по завершении этапа согласования
- «Добавить пустую страницу» - разделение документа пустой страницей
- «Отправить оповещение» - направление оповещения по электронной почте
2. Описание типов действий и их атрибутов приведено в таблице ниже.
Примечание об отображении типа элемента действия
При настройке автоматизации процесса в карточке действия теперь отображается Тип элемента действия, что облегчает идентификацию нужного правила при наличии нескольких однотипных действий с близкими названиями. (VITROCAD-5823)
№ | Название типа действия | Атрибут для типа действия | Описание атрибута | Пример |
|---|---|---|---|---|
1 | Вызов внешнего сервиса | Название | Текст. Название действия. |
| Скопировать папки внутри вложения процесса. | ||||
Сервис обработки |
| Format('{0}/api/automation/post?baseUrl={0}/api/item/copy/{1}¶m={2 |
Привязать файлы(Установить вложения)*действие неактуально
Название
Текст. Название действия.
Перечень разрешённых типов документа
Выбор из списка типов элементов. Допустимо несколько значений.
Перечень разрешённых статусов документа
Выбор из списка статусов документов. Допустимо несколько значений.
3
}', Cfg('Site.PortalUrl'), Id(This('destination')), '[{' + Replace(Join('},{', Select(GetList(Id(), false), 'Format(\"#id#:#{0}#,#isChildListCopy#:true,#isFileCopy#:true,#isMetadataCopy#:true,#isPermissionCopy#:false\", Id(Ref('Вложение процесса')))')), '#', '\"') + '}]') Копирует все папки (включая подпапки), находящиеся внутри папки - вложения процесса, в папку/список, уникальный идентификатор (GUID) которой указан в поле destination текущего процесса. |
2 |
Установить значения атрибута(Установить значение поля) | Название | Текст. Название действия. |
| Установить статус процесса | |
Атрибут | Выбор из списка атрибутов текущего типа элемента (Доступен выбор из всех атрибутов системы.). Допустимо одно значение. |
| Статус процесса | |
Формула | Значение атрибута или формула для его расчёта (зависит от типа атрибута). Также есть поле Исходный элемент(ы) (формула) в котором в виде формулы можно указать элемент/элементы для которых надо выполнить данное действие. |
Lookup('Статус процесса.Согласующие') Устанавливает значение "Согласующие" атрибута "Статус процесса" текущего экземпляра процесса. | |||
3 | Установить значения атрибута связанного элемента(Установить значение поля связанного элемента) | Название | Текст. Название действия. |
| Установить значение атрибута (Статус файла) | |
Атрибут | Выбор из списка атрибутов связанного типа элемента (Доступен выбор из всех атрибутов системы). Допустимо одно значение. |
| Статус файла | |
Формула | Значение атрибута или формула для его расчёта (зависит от типа атрибута).* |
Lookup('Статусы документов.На согласовании') Устанавливает значение "На согласовании" атрибута "Статус файла" для элементов, являющихся вложениями текущего экземпляра процесса. | |
4 |
Установить права доступа(изменить права на элемент) | Название | Текст. Название действия. |
| Установить права доступа ГИПу | |
Уровень доступа | Выбор из списка «Уровни доступа». Допустимо одно значение. |
| Просмотр | ||
ФормулаСм. примечение D8 | Формула расчёта значения элемента/элементов списка Пользователи, для которых будет присвоен уровень доступа на элемент текущего типа. Формула должна вернуть объект списка. | Field(Parent(Ref('Вложение процесса'), 'Проект'), 'ГИП') Установить право на просмотр на текущий процесс, для пользователей/групп пользователей, указанных в поле "ГИП" родительской папки вложения процесса с типом "Проект". |
5 | Создать этап процесса(Этап процесса) | Название | Текст. Название действия. |
| Этап процесса (Согласующие) | |
Исполнители | Формула расчёта списка пользователей, которым будет назначен доступ на элемент. Формула должна вернуть объект списка. |
| This("approval_user_list_2") | |
Шаблон процесса | Выбор из списка «Шаблоны процесса». Допустимо одно значение. |
| Параллельный этап процесса |
Подписание ЭЦП | требовать ли подписания ЭЦП на данном этапе для закрытия задачи со статусом Согласовано |
| False |
Пакетный режим согласования | единый статус согласования для всех вложений задачи |
| False |
Тип элемента | тип задачи, которая будет создаваться на данном этапе |
| Задача на согласование | |||
6 | Опубликовать документ | Название | Текст. Название действия. |
| Опубликовать документ |
Комментарий версии | Текст комментария к версии, которую опубликует данное действие. Может содержать формулу |
. | Format('Согласованно в процессе {0}', This('Процесс.Название')) Вернет строку "Согласовано в процессе " + Название процесса, указанного в атрибуте Процесс текущего файла. |
7 |
Выполнить процедуру | Название | Текст. Название действия. |
| Копировать файл в Согласовано | |
Формула | Формула процедуры. Для выполнения процедур типа «копирование документа по пути» используется соответствующая функция формульного языка системы. |
Copy(Path(Parent("В разработке"), "../Согласовано", true), "a8bcd156-ffe3-4a96-9fea-d5ba9a557006") Скопирует текущий элемент и его родительские папки, начиная от папки с названием "В разработке" (не включая её) , в папку с названием "Согласовано", находящуюся на том же уровне, что и папка "В разработке" и установит связь между текущим элементом и его копией, уникальный идентификатор типа которой: "a8bcd156-ffe3-4a96-9fea-d5ba9a557006" | |
8 |
Добавить штамп | Название | Текст. Название действия. |
| Штамп "В производство работ" | ||||||||
Размер штампа | Настройка размеров штампа в точках (pt). |
|
150;120 |
Расположение от | Установка точки привязки штампа от листа (угол, сторона). |
| Правый нижний угол |
Расположение штампа | Положение штампа на листе. Значение в pt. |
| 190;245 |
Профиль штампа | Выбор профиля штампа из списка «Профили штампов». | В производство работ |
9 | Обработка вложений по результатам согласования | Правило обработки документа | Выбор из списка «Правила обработки документа». Указывается переход статуса документа при различных результатах согласования на этапе (Согласовано / Отклонено / Согласовано с замечаниями). |
Выбрано два правила:
| |
10 |
Добавить пустую страницу | Название | Текст. Название действия. |
Номер страницы | До или после какой страницы размещать пустую страницу. |
Альбомная ориентация | Флаг (Да/Нет). Если установлено «Да», пустая страница создаётся в альбомной ориентации. |
11 | Отправить оповещение | Название | Текст. Название действия. |
| Отправить оповещение (Наблюдатели) | |
Получатели | Список пользователей (или формула для их расчёта), которым будет отправлено оповещение по электронной почте. |
| Select(This('Наблюдатели', true), 'Field(\"Почта\")') | ||
Шаблон оповещения | Выбор шаблона оповещения из списка «Шаблоны оповещения». Подробнее о создании и редактировании шаблонов - в статье Настройка шаблонов оповещений. | DocumentApproval.trdp |
12 | Забрать права доступа | Название | Текст. Название действия. |
| Забрать права доступа (Исполнитель) | |
Уровень доступа | Выбор из списка «Уровни доступа». Допустимо одно значение. Указывается уровень доступа, который необходимо снять с указанных пользователей. |
| Изменить | |
ФормулаСм. примечение D8 | Формула расчёта значения элемента/элементов списка Пользователи, у которых будет снят уровень доступа на элемент текущего типа. Формула должна вернуть объект списка. |
...
This("Исполнитель") Забрать права доступа на изменение у пользователя/группы пользователей, указанных в атрибуте "Исполнитель" текущего элемента. Например для блокировки изменения задачи после её завершения. |
Важно: несколько действий одного типа
В одном правиле автоматизации может быть настроено несколько действий одного типа. Все они будут выполнены последовательно при срабатывании триггера. Для добавления нескольких действий нажмите плюсик в соответствующем разделе.