Настройка действий для шаблона шага

Действия в конструкторе могут быть входящими и исходящими.

Входящие действия — действия, направленные на объект, создаваемый или изменяемый в рамках данного шага выполнения маршрута:

• Действия при смене статуса в других шагах — действие с объектом в рамках шага инициируется изменением статуса объекта в рамках другого шага.
• Действия по событиям в системе — действие с объектом в рамках шага инициируется событием с головным объектом маршрута.

Исходящие действия — действия, направленные на головной объект или объект, создаваемый или изменяемый в рамках другого шага выполнения маршрута:

• Действия при смене статуса на другие шаги — изменение статуса объекта в рамках данного шага инициирует действие с объектом на другом шаге.
• Действия при смене статуса с головным объектом — изменение статуса объекта в рамках данного шага инициирует действие с головным объектом.

Добавление действия

Чтобы добавить действие, откройте карточку шаблона шага, на вкладке "Входящие действия" / "Исходящие действия" нажмите кнопку Добавить в соответствующем блоке, заполните поля на форме добавления действия и нажмите кнопку Сохранить.

Поля на форме добавления действия при смене статуса:

• Исходный шаблон — шаблон шага, в рамках которого изменяется статус объекта и инициируется действие.
• Исходный статус — статус объекта в рамках исходного шага, при переходе в который должно выполняться действие.
• Исходный код решений — код решения, установленный у исходного шага, который инициирует действие
• Действие — выполняемое действие: создать объект или изменить объект.
• Целевой шаблон — шаблон шага, в рамках которого выполняется действие с объектом.
• Целевой статус — статус, в который переводится объект в рамках целевого шаблона при выполнении действия.
• Целевой код решений — код решения, который устанавливается у целевого шаблона при выполнении действия.

• Создать экземпляры шага — исходный объект, от которого создаются шаги (головной объект или предыдущий шаг).

  • По атрибуту головного объекта / предыдущего шага — атрибут головного объекта / предыдущего шага, на объекты которого создаются шаги (количество экземпляров шага равно количеству объектов атрибута).

  • Сохранить в атрибут экземпляра шага — атрибут текущего объекта, в который сохраняется значение атрибута головного объекта.

  Параметр связан с функциональностью "Многоэкземплярность".

Поля с параметрами действия по событиям в системе:

• Исходное событие — событие с головным объектом, инициирующее действие.
• Исходный тип объекта — тип объекта, в рамках которого должно произойти событие.
• Действие — выполняемое действие: создать объект или изменить объект.
• Целевой статус — статус, в который переводится целевой объект при выполнении действия.
• Целевой код решений — код решения, который устанавливается у целевого шаблона при выполнении действия.

• Создать экземпляры шага — исходный объект, от которого создаются шаги (головной объект или предыдущий шаг) [Доступно с версии 2.0].

  • "По атрибуту головного объекта / предыдущего шага" — атрибут головного объекта / предыдущего шага, на объекты которого создаются шаги (количество экземпляров шага равно количеству объектов атрибута).
  • "Сохранить в атрибут экземпляра шага" — атрибут текущего объекта, в который сохраняется значение атрибута головного объекта.

  Параметр связан с функциональностью"Многоэкземплярность", которая позволяет при создании объекта на шаге маршрута автоматически "размножить" его: создать несколько объектов, отличающихся значением отдельного атрибута головного объекта / предыдущего шага. Например, при выборе в запросе нескольких ИТ-активов для каждого ИТ-актива может быть создана отдельная задача.

  Пример настройки описан в разделе Пример настройки маршрута "Заказ новой техники" с использованием многоэкземплярности.

Заполнение обязательных атрибутов

На шаге маршрута могут создаваться объекты, у которых есть обязательные атрибуты, например, задача с атрибутом "Описание". При незаполнении обязательных атрибутов во время создания объекта будет возникать ошибка.

Необходимо настроить заполнение обязательных атрибутов одним из способов:

• Настроить соответствия атрибутов между шагами. При этом значение атрибута будет взято из шаблона шага, см. Настройка соответствия атрибутов шаблона и объекта.
• Настроить копирование атрибутов, см. Копирование атрибутов.

Некоторые атрибуты объекта заполняются в результате настройки параметров действия для шаблона шага (например, "Целевой шаблон", "Целевой статус"). Если среди оставшихся незаполненных атрибутов создаваемого объекта нет обязательных, настройка не требуется.

Копирование атрибутов

Копирование атрибутов позволяет прямо указать, значение какого атрибута должно использоваться в атрибуте объекта, который будет создан/изменен на шаге маршрута.

В рамках действий есть возможность настроить:

• Копирование атрибутов между шагами;
• Копирование атрибутов из головного объекта;
• Копирование атрибутов из текущего объекта в шаг.

Чтобы настроить копирование атрибутов, откройте карточку действия и в соответствующем блоке нажмите ссылку Добавить.

Заполните поля формы настройки и нажмите кнопку Сохранить.

Поля с параметрами настройки копирования:

• Исходный атрибут — атрибут исходного объекта, из которого копируется значение.

• Предварительная обработка — дополнительные обработки значения атрибута перед действием, выбирается только для текста RTF.

• Действие — действие, которое нужно произвести со значением атрибута:

  • Заменить — значение целевого атрибута будет взято из исходного атрибута.

    Действие доступно для всех типов атрибутов.

  • Добавить — к значению целевого атрибута будет добавлено значение исходного, оба значения будут сохранены, например, ответственный по заявке будет добавлен к подписчикам задачи.

    Действие рекомендуется использовать для атрибутов типа "Обратная ссылка", "Набор ссылок на бизнес объект" и "Набор элементов справочника".

  • Удалить — если значение исходного атрибута содержалось в значении целевого, то оно будет удалено из значения целевого атрибута.

    Действие рекомендуется использовать для атрибутов типа "Обратная ссылка", "Набор ссылок на бизнес объект" и "Набор элементов справочника".

• Целевой атрибут — атрибут целевого объекта, в который копируется значение.

Особенности копирования

Для успешного копирования атрибутов их типы должны совпадать или поддерживать копирование из другого типа.

Копирование доступно:

• Из атрибута типа "Ссылка на бизнес объект" в атрибуты типа:
  • "Ссылка на бизнес объект";
  • "Набор ссылок на бизнес объект" с использованием действия "Добавить".

• Из атрибута типа "Набор ссылок на бизнес объект" в атрибуты типа:

  • "Набор ссылок на бизнес объект";

  • "Обратная ссылка".

• Из атрибута типа "Обратная ссылка" в атрибуты типа:

  • "Набор ссылок на бизнес объект";

  • "Обратная ссылка".

• Из атрибута типа "Элемент справочника" в атрибуты типа:

  • "Набор элементов справочника";

  • "Элемент справочника".

• Из атрибута типа "Текст" и "Текст в формате RTF" в атрибуты типа:

  • "Текст";

  • "Текст в формате RTF";

  • "Текст комментария".

• Из атрибута типа "Строка" в атрибуты типа:

  • "Строка";

  • "Текст";

  • "Текст в формате RTF";

  • "Текст комментария".

• Из атрибута типа "Целое число" в атрибуты типа:

  • "Целое число";

  • "Вещественное число";

  • "Строка".

• Из атрибута типа "Вещественное число" в атрибуты типа:

  • "Вещественное число";

  • "Строка".

• Атрибуты типа "Набор элементов справочника", "Дата", "Дата и время", "Логический", "Временной интервал" и "Тип объекта" — только в атрибуты своего типа.

Ограничения копирования

• В качестве исходного атрибута не могут выступать атрибуты типов:

  • "Счетчик времени";

  • "Счетчик времени (обратный)";

  • "Автор комментария";

  • "Текст комментария".

• В качестве целевого атрибута не могут выступать атрибуты типов:

  • "Счетчик времени";

  • "Счетчик времени (обратный)".

• Атрибут типа “Атрибут связанного объекта” может выступать в качестве исходного и целевого атрибута, если:

  • Тип целевого атрибута и атрибута, значение которого принимает атрибут связанного объекта, совпадают.

  • Тип исходного атрибута и атрибута, значение которого принимает атрибут связанного объекта, совпадают.