Назначение
Присваивает значение атрибуту у элементов, связанных с исходным элементом. Типичное применение — смена статуса файлов, вложенных в процесс (например, «На согласовании» при старте этапа).
Сведения о типе действия
| Параметр | Значение |
|---|---|
| Название в портале | Установить значение атрибута связанных объектов |
| Также встречается как | Установить значения атрибута связанного элемента; Установить значение поля связанного элемента |
| Activity в Elsa (обработчик) | Установить значение поля вложения (SetReferenceItemFieldActivity) |
| ID типа элемента действия | 62603ea8-bf37-40f9-8114-44655d2287ae |
| Проверка условий правила | Да |
| Поддержка «Исходный элемент(ы) (формула)» | Да |
Что такое «связанный элемент»
Связанный элемент — элемент, связанный с текущим через элемент специального типа связь (список связей): в поле source связи указан текущий элемент, в поле destination — связанный. Действие использует системные типы связей в зависимости от того, где находится исходный элемент:
| Исходный элемент | Тип связи | Что считается связанными объектами |
|---|---|---|
| Процесс (любой элемент, кроме задачи) | «Вложение процесса» (ID 9ea7ecc3-0886-4b4b-9e40-b0a957d689dd) | Вложения процесса — файлы/папки, попавшие в процесс при запуске. |
| Задача (элемент списка «Задачи») | «Вложение задачи на согласование» (ID 70a8952c-539f-49a5-aa4b-31ff67d1663f) | Вложения задачи этапа (связи создаются при создании задачи для каждого вложения процесса). |
Тип связи
Действие работает только с указанными системными типами связей. Если в настройках процесса («Тип связи процесса» на вкладке «Привязки») выбран другой тип связи, используйте «Установить значение атрибута» с полем «Исходный элемент(ы) (формула)», например Refs('Название типа связи').
Атрибуты действия
| Атрибут | Обязательный | Описание | Пример |
|---|---|---|---|
| Название | Да | Текст. Название действия. | Установить значение атрибута (Статус файла) |
| Атрибут | Да | Атрибут связанного элемента. Выбор из всех атрибутов системы, одно значение. | Статус файла |
| Формула | Да | Значение или формула. Вычисляется один раз в контексте исходного элемента (процесса/задачи), и полученное значение присваивается всем связанным объектам. | Lookup('Статусы документов.На согласовании') |
Как работает
- Проверяются условия правила.
- Для исходного элемента выбираются связи нужного типа и их элементы-destination.
- Формула вычисляется для исходного элемента.
- Каждому связанному элементу, тип которого содержит атрибут, присваивается значение; элементы без атрибута пропускаются.
Пример
На статусе процесса «Согласующие» установить вложениям «Статус файла» = «На согласовании»: Атрибут — Статус файла, Формула — Lookup("Статусы документов.На согласовании").
Особенности
- В формуле
This()ссылается на процесс (задачу), а не на вложение. Если значение должно зависеть от атрибутов самого вложения, используйте «Установить значение атрибута» с исходными элементами. - Изменение атрибута вложений — событие для их типа элемента: могут сработать правила файлов (например, сброс статуса или копирование).