2.11.1.3 Типовые действия бизнес-процессов
В Системе существует несколько типовых действий для создания бизнес-процессов, у типовых действий в свою очередь есть ряд своих параметров.
Типовые действия вместе с параметрами задаются в панеле параметров справа на форме Диаграммы (см. раздел Создание Бизнес Процесса):
Рисунок - Действия и параметры бизнес-процесса
Таблица типовых действий
| Действие |
Назначение |
Основная сущность |
| createItamTask |
Создание задачи |
TASK |
| editItamTask |
Изменение задачи |
TASK |
| createItamAsset |
Создание актива |
ASSET |
| editItamAsset |
Изменение актива |
ASSET |
| createItamService |
Создание услуги |
SERVICE |
| editItamService |
Изменение услуги |
SERVICE |
| editChildAssets |
Изменение дочерних активов (смена статуса) |
ASSET |
| editItamSubTask |
Изменение дочерних задач |
TASK |
| editItamParentTask |
Изменение родительской задачи (смена статуса) |
TASK |
| createItamFinanceOperation |
Создание финансовой операции |
FINANCE_OPERATION |
| distributeItamFinanceOperation |
Распределение финансовой операции |
FINANCE_OPERATION |
createItamTask
1. Краткое описание действия
Создает новую задачу. Поддерживает создание:
- от другой задачи (с копированием данных)
- как подзадачи
- от актива
- от услуги
- по шаблону (от источника или по расписанию)
2. Когда использовать
| Сценарий |
Описание |
| Создание задачи от задачи |
Создается новая задача на основании существующей задачи. Данные копируются в соответствии с маппингом |
| Создание подзадачи |
Создается новая задача, которая становится подзадачей задачи-источника. Данные копируются в соответствии с маппингом |
| Создание задачи от актива |
Создается новая задача на основании существующего актива. Данные копируются в соответствии с маппингом |
| Создание задачи от услуги |
Создается новая задача на основании существующей услуги. Данные копируются в соответствии с маппингом |
| Создание задачи по шаблону |
Создается новая задача по предопределенному шаблону. Может создаваться: - от источника (SERVICE/TASK/ASSET) с копированием данных - по расписанию (источник не требуется) |
3. Особенности работы
- Если указан
templateName, задача создается по шаблону; typeCode при этом можно не указывать.
- Если одновременно указаны
sourceAttributes и templateName, значения из sourceAttributes могут перезаписать значения шаблона.
- При
fillParent = true создаваемая задача становится подзадачей задачи-источника (источник обязательно должен быть типа TASK).
sourceAttributes работает только при наличии sourceType.- Автором созданной задачи всегда является системный пользователь (
system-user), если не указано иное.
- В историю источника (ИИ) автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| typeCode |
String or expression |
Да |
testBusiness |
Тип создаваемой задачи (код типа объекта). Не требуется, если указан templateName. |
| templateName |
String or expression |
Нет (если нет typeCode) |
ИмяШаблона |
Создание задачи по шаблону. Указывается имя шаблона. |
Параметры источника (для копирования данных)
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceType |
String or expression |
Да (при копировании) |
TASK |
Тип объекта-источника: TASK, ASSET, SERVICE. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между источником и создаваемой задачей. Поддерживает attributeCodeMapping, allSame, excludeAttributes. где CodeA -- коды атрибутов создаваемой задачи, CodeB -- код атрибута источника. |
Параметры подзадачи
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| fillParent |
String or expression |
Нет |
true |
Если true, новая задача становится подзадачей задачи-источника (источник - TASK). |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает |
| fillParent |
sourceType = TASK |
Только для задач-источников |
| templateName |
- |
Не требует typeCode и источника |
editItamTask
1. Краткое описание действия
Редактирует существующую задачу. Поддерживает изменение:
- на основе данных от другой задачи (с копированием данных)
- на основе данных от актива
- на основе данных от услуги
- с использованием данных самой задачи
2. Когда использовать
| Сценарий |
Описание |
| Редактирование задачи от задачи |
Редактируется существующая задача на основании данных другой задачи-источника. Данные копируются в соответствии с маппингом. |
| Редактирование задачи от актива |
Редактируется существующая задача на основании данных актива. Данные копируются в соответствии с маппингом. |
| Редактирование задачи от услуги |
Редактируется существующая задача на основании данных услуги. Данные копируются в соответствии с маппингом. |
| Редактирование задачи самой себя |
Редактируется текущая задача на основе собственных данных (например, перенос значения из одного атрибута в другой). |
3. Особенности работы
- Для редактирования необходимо указать идентификатор редактируемой задачи (
editEntityId, определяющий целевую задачу).
- Если указаны
sourceType и sourceAttributes, данные для изменения копируются из объекта-источника в соответствии с маппингом.
- Автором изменения задачи всегда является системный пользователь (
system-user), если не указано иное.
- В историю изменений (ИИ) задачи-источника автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| editEntityId |
String or expression |
Да |
Нет |
ID задачи, которая будет отредактирована. |
Параметры источника (для копирования данных)
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceType |
String or expression |
Да (при копировании) |
TASK |
Тип объекта-источника: TASK, ASSET, SERVICE. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между источником и редактируемой задачей. Поддерживает attributeCodeMapping, allSame, excludeAttributes. где CodeA -- коды атрибутов редактируемых задач, CodeB -- код атрибута источника. |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает. |
createItamAsset
1. Краткое описание действия
Создает новый актив. Поддерживает создание:
- от задачи (с копированием данных)
- от актива (с копированием данных и созданием связи)
- от услуги (с копированием данных и созданием связи)
- по шаблону (от источника или по расписанию)
2. Когда использовать
| Сценарий |
Описание |
| Создание актива от задачи |
Создается новый актив на основании существующей задачи. Данные копируются в соответствии с маппингом. |
| Создание актива от услуги |
Создается новый актив на основании существующей услуги. Данные копируются в соответствии с маппингом. Между созданным активом и услугой-источником создается связь. |
| Создание актива от актива |
Создается новый актив на основании существующего актива. Данные копируются в соответствии с маппингом. Между созданным активом и активом-источником создается связь. |
| Создание актива по шаблону |
Создается новый актив по предопределенному шаблону. Может создаваться: - от источника (SERVICE/TASK/ASSET) с копированием данных - по расписанию (источник не требуется) |
3. Особенности работы
- Если указан
templateName, актив создается по шаблону; typeCode при этом можно не указывать.
- Если одновременно указаны
sourceAttributes и templateName, значения из sourceAttributes могут перезаписать значения шаблона.
- При создании актива от актива или от услуги с указанием
sourceRelationTypeCode автоматически создается связь между источником и новым активом. Параметр sourceIsLinkedObject определяет положение источника в этой связи.
- При создании актива от задачи связь не создается (копируются только данные)
- Автором созданного актива всегда является системный пользователь (
system-user), если не указано иное.
- В историю источника (ИИ) автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| typeCode |
String or expression |
Да (если нет templateName) |
testBusiness |
Тип создаваемого актива (код типа объекта). Не требуется, если указан templateName. |
| templateName |
String or expression |
Нет (если нет typeCode) |
ИмяШаблона |
Создание актива по шаблону. Указывается имя шаблона. |
Параметры источника (для копирования данных)
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceType |
String or expression |
Да (при копировании) |
ASSET |
Тип объекта-источника: TASK, ASSET, SERVICE. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между источником и создаваемым активом. Поддерживает attributeCodeMapping, allSame, excludeAttributes. где CodeA -- коды атрибутов редактируемых задач, CodeB -- код атрибута источника. |
Параметры связей с источником
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceRelationTypeCode |
String or expression |
Нет |
null |
Код типа связи, которая будет создана между источником и создаваемым активом. |
| sourceIsLinkedObject |
Boolean or expression |
Нет |
true |
Определяет положение источника в создаваемой связи. true - источник справа (linked), false - источник слева (created). |
| relationTypeCodesToCopy |
List |
Нет |
null |
Типы копируемых связей из источника. Перечислить коды типов связи. |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает. |
| sourceRelationTypeCode |
sourceType = ASSET или SERVICE |
Создает связь между источником и новым активом. Для TASK не используется. |
| sourceIsLinkedObject |
sourceRelationTypeCode |
Определяет ориентацию связи. |
| relationTypeCodesToCopy |
sourceType |
Копирует связи из источника в новый актив. |
editItamAsset
1. Краткое описание действия
Редактирует существующий актив. Поддерживает изменение:
- от задачи (с копированием данных)
- от актива (с копированием данных, удалением существующих связей и созданием новой связи)
- от услуги (с копированием данных и копированием связей)
2. Когда использовать
| Сценарий |
Описание |
| Редактирование актива от задачи |
Редактируется существующий актив на основании данных задачи-источника. Данные копируются в соответствии с маппингом. |
| Редактирование актива от услуги |
Редактируется существующий актив на основании данных услуги. Данные копируются в соответствии с маппингом. Связи из услуги-источника копируются в редактируемый актив. |
| Редактирование актива от актива |
Редактируется существующий актив на основании данных другого актива-источника. Данные копируются в соответствии с маппингом. Существующая взаимосвязь в редактируемом активе удаляется, создается новая связь с активом-источником. |
3. Особенности работы
- Для редактирования необходимо указать идентификатор редактируемого актива (
editEntityId).
- Если указаны
sourceType и sourceAttributes, данные для изменения копируются из объекта-источника в соответствии с маппингом.
- При редактировании актива от актива с указанием
sourceRelationTypeCode и sourceIsLinkedObject создается новая связь с активом-источником, а связи, указанные в relationTypeCodesToRemove, удаляются.
- При редактировании актива от услуги с указанием
relationTypeCodesToCopy связи из услуги-источника копируются в редактируемый актив.
- Автором изменения актива всегда является системный пользователь (
system-user), если не указано иное.
- В историю источника (ИИ) автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| editEntityId |
String or expression |
Да |
Нет |
ID актива, который будет отредактирован. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между источником и редактируемым активом. где CodeA -- коды атрибутов редактируемых задач, CodeB -- код атрибута источника. |
Параметры управления связями
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| relationTypeCodesToCopy |
List |
Нет |
null |
Типы связей, которые необходимо скопировать из объекта-источника в редактируемый актив. |
| relationTypeCodesToRemove |
List |
Нет |
null |
Коды типов связей, которые должны быть удалены у редактируемого актива. |
| sourceRelationTypeCode |
String or expression |
Нет |
null |
Код типа связи, которая будет создана между источником и редактируемым активом. |
| sourceIsLinkedObject |
Boolean or expression |
Нет |
true |
Определяет положение источника в создаваемой связи. true - источник справа (linked), false - источник слева (created). |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает. |
| relationTypeCodesToCopy |
sourceType = SERVICE |
Копирует связи из услуги-источника в редактируемый актив. |
| sourceRelationTypeCode |
sourceType = ASSET |
Создает новую связь между активом-источником и редактируемым активом. |
| sourceIsLinkedObject |
sourceRelationTypeCode |
Определяет ориентацию связи. |
| relationTypeCodesToRemove |
sourceType = ASSET |
Удаляет указанные связи у редактируемого актива. |
createItamService
1. Краткое описание действия
Создает новую услугу. Поддерживает создание:
- от задачи (с копированием данных и созданием связей с активами из задачи)
- от услуги (с копированием данных и созданием связи)
- от актива (с копированием данных и созданием связи)
- по шаблону (от источника или по расписанию)
2. Когда использовать
| Сценарий |
Описание |
| Создание услуги от задачи |
Создается новая услуга на основании существующей задачи. Данные копируются в соответствии с маппингом. В созданной услуге создаются взаимосвязи с активами, выбранными у задачи-источника. |
| Создание услуги от услуги |
Создается новая услуга на основании существующей услуги. Данные копируются в соответствии с маппингом. Между созданной услугой и услугой-источником создается связь. |
| Создание услуги от актива |
Создается новая услуга на основании существующего актива. Данные копируются в соответствии с маппингом. Между созданной услугой и активом-источником создается связь. |
| Создание услуги по шаблону |
Создается новая услуга по предопределенному шаблону. Может создаваться: - от источника (SERVICE/TASK/ASSET) с копированием данных - по расписанию (источник не требуется) |
3. Особенности работы
- Если указан
templateName, услуга создается по шаблону; typeCode при этом можно не указывать.
- Если одновременно указаны
sourceAttributes и templateName, значения из sourceAttributes могут перезаписать значения шаблона.
- При создании услуги от задачи с указанием
taskAssetsRelationTypeCode автоматически создаются связи созданной услуги с активами, которые привязаны к задаче-источнику. Параметр targetObjectIsLinkedObject определяет положение создаваемой услуги в этих связях.
- При создании услуги от услуги или от актива с указанием
sourceRelationTypeCode автоматически создается связь между источником и новой услугой. Параметр sourceIsLinkedObject определяет положение источника в этой связи.
- Автором созданной услуги всегда является системный пользователь (
system-user), если не указано иное.
- В историю источника (ИИ) автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| typeCode |
String or expression |
Да (если нет templateName) |
testBusiness |
Тип создаваемой услуги (код типа объекта). Не требуется, если указан templateName. |
| templateName |
String or expression |
Нет (если нет typeCode) |
ИмяШаблона |
Создание услуги по шаблону. Указывается имя шаблона. |
Параметры источника (для копирования данных)
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceType |
String or expression |
Да (при копировании) |
SERVICE |
Тип объекта-источника: TASK, ASSET, SERVICE. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между источником и создаваемой услугой. где CodeA -- коды атрибутов редактируемых задач, CodeB -- код атрибута источника. |
Параметры связей
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| taskAssetsRelationTypeCode |
String or expression |
Нет |
null |
Код типа связи, по которой нужно создать связи с активами из задачи-источника. |
| targetObjectIsLinkedObject |
Boolean or expression |
Нет |
true |
Определяет положение создаваемой услуги в связях с активами. true - услуга справа (linked), false - услуга слева (created). |
| sourceRelationTypeCode |
String or expression |
Нет |
null |
Код типа связи, которая будет создана между источником и создаваемой услугой (для sourceType = ASSET или SERVICE). |
| sourceIsLinkedObject |
Boolean or expression |
Нет |
true |
Определяет положение источника в создаваемой связи. true - источник справа (linked), false - источник слева (created). |
| relationTypeCodesToCopy |
List |
Нет |
null |
Типы копируемых связей из источника. |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает. |
| taskAssetsRelationTypeCode |
sourceType = TASK |
Создает связи созданной услуги с активами задачи-источника. |
| targetObjectIsLinkedObject |
taskAssetsRelationTypeCode |
Определяет ориентацию связей с активами. |
| sourceRelationTypeCode |
sourceType = ASSET или SERVICE |
Создает связь между источником и новой услугой. |
| sourceIsLinkedObject |
sourceRelationTypeCode |
Определяет ориентацию связи. |
| relationTypeCodesToCopy |
sourceType |
Копирует связи из источника в новую услугу. |
| templateName |
- |
Не требует typeCode и источника (при создании по расписанию). |
editItamService
1. Краткое описание действия
Редактирует существующую услугу. Поддерживает изменение:
- от задачи (с копированием данных и созданием связей с активами из задачи)
- от услуги (с копированием данных и копированием связей)
- от актива (с копированием данных, удалением существующих связей и созданием новой связи)
2. Когда использовать
| Сценарий |
Описание |
| Редактирование услуги от задачи |
Редактируется существующая услуга на основании данных задачи-источника. Данные копируются в соответствии с маппингом. С редактируемой услугой создаются взаимосвязи с активами из задачи-источника. |
| Редактирование услуги от услуги |
Редактируется существующая услуга на основании данных другой услуги-источника. Данные копируются в соответствии с маппингом. Связи из услуги-источника копируются в редактируемую услугу. |
| Редактирование услуги от актива |
Редактируется существующая услуга на основании данных актива-источника. Данные копируются в соответствии с маппингом. Существующая взаимосвязь в редактируемой услуге удаляется, создается новая связь с активом-источником. |
3. Особенности работы
- Если указаны
sourceType и sourceAttributes, данные для изменения копируются из объекта-источника в соответствии с маппингом.
- При редактировании услуги от задачи с указанием
taskAssetsRelationTypeCode и targetObjectIsLinkedObject создаются связи редактируемой услуги с активами, которые привязаны к задаче-источнику.
- При редактировании услуги от услуги с указанием
relationTypeCodesToCopy связи из услуги-источника копируются в редактируемую услугу.
- При редактировании услуги от актива с указанием
sourceRelationTypeCode и sourceIsLinkedObject создается новая связь с активом-источником, а связи, указанные в relationTypeCodesToRemove, удаляются.
- Автором изменения услуги всегда является системный пользователь (
system-user), если не указано иное.
- В историю источника (ИИ) автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| editEntityId |
String or expression |
Да |
Нет |
ID услуги, которая будет отредактирована. |
Параметры источника (для копирования данных)
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceType |
String or expression |
Да (при копировании) |
SERVICE |
Тип объекта-источника: TASK, ASSET, SERVICE. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между источником и редактируемой услугой. где CodeA -- коды атрибутов редактируемых задач, CodeB -- код атрибута источника. |
Параметры управления связями
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| taskAssetsRelationTypeCode |
String or expression |
Нет |
null |
Код типа связи, по которой нужно создать связи с активами из задачи-источника. |
| targetObjectIsLinkedObject |
Boolean or expression |
Нет |
true |
Определяет положение редактируемой услуги в связях с активами. true - услуга справа (linked), false - услуга слева (created). |
| relationTypeCodesToCopy |
List |
Нет |
null |
Типы связей, которые необходимо скопировать из объекта-источника в редактируемую услугу. |
| relationTypeCodesToRemove |
List |
Нет |
null |
Коды типов связей, которые должны быть удалены у редактируемой услуги. |
| sourceRelationTypeCode |
String or expression |
Нет |
null |
Код типа связи, которая будет создана между источником и редактируемой услугой. |
| sourceIsLinkedObject |
Boolean or expression |
Нет |
true |
Определяет положение источника в создаваемой связи. true - источник справа (linked), false - источник слева (created). |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает. |
| taskAssetsRelationTypeCode |
sourceType = TASK |
Создает связи редактируемой услуги с активами задачи-источника. |
| targetObjectIsLinkedObject |
taskAssetsRelationTypeCode |
Определяет ориентацию связей с активами. |
| relationTypeCodesToCopy |
sourceType = SERVICE |
Копирует связи из услуги-источника в редактируемую услугу. |
| sourceRelationTypeCode |
sourceType = ASSET |
Создает новую связь между активом-источником и редактируемой услугой. |
| sourceIsLinkedObject |
sourceRelationTypeCode |
Определяет ориентацию связи. |
| relationTypeCodesToRemove |
sourceType = ASSET |
Удаляет указанные связи у редактируемой услуги. |
editChildAssets
1. Краткое описание действия
Редактирует дочерние активы, связанные с задачей-источником. Поддерживает:
- копирование атрибутов из задачи в связанные активы
- смену статуса активов (всех, определенного типа или нескольких типов)
2. Когда использовать
| Сценарий |
Описание |
| Редактирование активов от задачи |
Значения атрибутов задачи, указанных в маппинге, копируются во все связанные с задачей активы. |
| Смена статуса активов (всех) |
Значения атрибутов задачи копируются в связанные активы. Статус всех связанных активов изменяется на указанный в параметре changeStatus. |
| Смена статуса активов (определенного типа) |
Значения атрибутов задачи копируются в связанные активы. Статус изменяется только для активов указанного типа. |
| Смена статуса активов (нескольких типов) |
Значения атрибутов задачи копируются в связанные активы. Статус изменяется для активов типов, указанных в маппинге changeStatus. |
3. Особенности работы
- Действие применяется к активам, связанным с задачей-источником (родительской задачей).
- Если указан
changeStatus без привязки к типу, статус меняется у всех связанных активов.
- Если
changeStatus содержит маппинг типа актива на код статуса, статус меняется только у активов соответствующих типов.
- Изменение статуса выполняется только при наличии допустимого перехода в рамках жизненного цикла (ЖЦ) актива.
- Автором изменения активов всегда является системный пользователь (
system-user), если не указано иное.
- В историю источника (ИИ) задачи автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceType |
String or expression |
Да |
TASK |
Тип объекта-источника. Для editChildAssets всегда TASK. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между задачей-источником и дочерними активами. где CodeA -- коды атрибутов редактируемых задач, CodeB -- код атрибута источника. |
Параметры смены статуса
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| changeStatus |
String or expression |
Нет |
null |
Параметр, определяющий смену статуса активов. - Если указано простое значение - статус меняется у всех связанных активов. - Если указан объект {"Тип актива": "Код статуса"} - статус меняется только у активов указанных типов. |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает. |
| changeStatus |
sourceType = TASK |
Необязательный параметр. Если указан, выполняется смена статуса активов. |
editItamSubTask
1. Краткое описание действия
Редактирует дочерние задачи (подзадачи), связанные с задачей-источником. Поддерживает:
- копирование атрибутов из родительской задачи в подзадачи
- фильтрацию подзадач по типу (один, несколько или все)
- смену статуса подзадач (определенного типа или нескольких типов)
2. Когда использовать
| Сценарий |
Описание |
| Редактирование подзадач (фильтр по одному типу) |
Данные из родительской задачи копируются в подзадачи. Редактируются только подзадачи указанного в typeSubTask типа. |
| Редактирование подзадач (фильтр по нескольким типам) |
Данные из родительской задачи копируются в подзадачи. Редактируются только подзадачи типов, указанных в typeSubTask. |
| Редактирование всех подзадач |
Данные из родительской задачи копируются в подзадачи. Редактируются все подзадачи, прикрепленные к родительской задаче. |
| Редактирование подзадач со сменой статуса (один тип) |
Данные из родительской задачи копируются в подзадачи. Редактируются все подзадачи. Подзадачи указанного в changeStatus типа меняют статус. |
| Редактирование подзадач со сменой статуса (несколько типов) |
Данные из родительской задачи копируются в подзадачи. Редактируются все подзадачи. Подзадачи типов, указанных в changeStatus, меняют статус в соответствии с маппингом. |
3. Особенности работы
- Действие применяется к подзадачам, связанным с задачей-источником (родительской задачей).
- Если указан
typeSubTask, редактируются только подзадачи указанных типов.
- Если
typeSubTask не указан, редактируются все подзадачи, прикрепленные к родительской задаче.
- Если указан
changeStatus (объект с маппингом «тип задачи → код статуса»), подзадачи соответствующих типов меняют статус. Изменение статуса выполняется только при наличии допустимого перехода в рамках жизненного цикла (ЖЦ) задачи.
- Автором изменения подзадач всегда является системный пользователь, если не указано иное.
- В историю источника (ИИ) родительской задачи автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceType |
String or expression |
Да |
TASK |
Тип объекта-источника. Для editItamSubTask всегда TASK. |
Параметры фильтрации подзадач
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| typeSubTask |
List |
Нет |
null |
Конкретные типы подзадач, которые необходимо редактировать. Возможен множественный выбор. Если не указан - редактируются все подзадачи. |
Параметры смены статуса
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| changeStatus |
String or expression (Object) |
Нет |
null |
Параметр, определяющий смену статуса подзадач. Указывается объект {"Тип задачи": "Код статуса"}. Статус меняется только у задач указанных типов. |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает. |
| typeSubTask |
sourceType = TASK |
Ограничивает набор редактируемых подзадач. |
| changeStatus |
sourceType = TASK |
Необязательный параметр. Если указан, выполняется смена статуса подзадач указанных типов. |
editItamParentTask
1. Краткое описание действия
Редактирует родительскую задачу на основании данных дочерних задач (подзадач). Поддерживает:
- копирование атрибутов из подзадачи в родительскую задачу
- смену статуса родительской задачи
- проверку условий по бизнес-правилу (ruleId) с различной политикой применения (changePolicy: ALL / ONE)
2. Когда использовать
| Сценарий |
Описание |
Изменение родительской задачи (changePolicy = ALL) |
При изменении подзадач данные из последней отредактированной подзадачи копируются в родительскую задачу. Статус родительской задачи меняется, если все подзадачи выполнили условия шаблона проверки (ruleId). |
Изменение родительской задачи (changePolicy = ONE) |
При изменении подзадачи данные из отредактированной подзадачи копируются в родительскую задачу. Статус родительской задачи меняется, если хотя бы одна подзадача выполнила условия шаблона проверки (ruleId). |
Изменение родительской задачи (без ruleId) |
При изменении подзадачи данные из отредактированной подзадачи копируются в родительскую задачу. Статус родительской задачи меняется, если любая подзадача попадает под условия бизнес-правила (проверка выполняется без явного ruleId). |
3. Особенности работы
- Действие применяется к родительской задаче, на основании изменений в ее подзадачах.
- При указании
ruleId выполняется проверка условий по бизнес-правилу (шаблону проверки).
- Параметр
changePolicy определяет, сколько подзадач должны выполнить условия для смены статуса родительской задачи:
ALL - все подзадачи должны выполнить условияONE - хотя бы одна подзадача должна выполнить условия- Если
ruleId не указан, политика changePolicy не требуется, и статус родительской задачи меняется при изменении любой подзадачи (при условии, что она попадает под условия бизнес-правила).
- Автором изменения статуса родительской задачи всегда является системный пользователь (
system-user), если не указано иное.
- В историю источника (ИИ) подзадачи автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| changeStatusParent |
String or expression |
Да |
Нет |
Параметр, определяющий, в какой статус переводить родительскую задачу. Указывается код статуса. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между подзадачей (источником) и родительской задачей. где CodeA -- коды атрибутов редактируемых задач, CodeB -- код атрибута источника. |
Параметры бизнес-правила и политики
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| ruleId |
String or expression |
Нет |
null |
ID бизнес-правила, содержащего шаблон проверки условий для подзадач. |
| changePolicy |
String or expression |
Нет (да, если указан ruleId) |
null |
Параметр, определяющий политику проверки смены статуса родительской задачи при изменении дочерней. Доступные значения: - ALL - все подзадачи должны выполнить условия - ONE - хотя бы одна подзадача должна выполнить условия |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
- |
Копирует атрибуты из подзадачи в родительскую задачу. |
| ruleId |
changePolicy |
Если указан ruleId, то changePolicy обязателен. |
| changePolicy |
ruleId |
Определяет, сколько подзадач должны выполнить условия. |
| changeStatusParent |
- |
Обязательный параметр для смены статуса родительской задачи. |
createItamFinanceOperation
1. Краткое описание действия
Создает новую финансовую операцию на основании данных объекта-источника. Поддерживает создание:
- от задачи (TASK)
- от услуги (SERVICE)
- от актива (ASSET)
- от договора (CONTRACT)
2. Когда использовать
| Сценарий |
Описание |
| Создание финансовой операции от задачи |
Создается новая финансовая операция на основании данных задачи. Данные копируются в соответствии с маппингом. |
| Создание финансовой операции от услуги |
Создается новая финансовая операция на основании данных услуги. Данные копируются в соответствии с маппингом. |
| Создание финансовой операции от актива |
Создается новая финансовая операция на основании данных актива. Данные копируются в соответствии с маппингом. |
| Создание финансовой операции от договора |
Создается новая финансовая операция на основании данных договора. Данные копируются в соответствии с маппингом. |
3. Особенности работы
- Для создания финансовой операции необходимо указать
sourceType (тип объекта-источника), typeCode (тип создаваемой финансовой операции) и sourceAttributes (маппинг атрибутов).
- Маппинг
sourceAttributes определяет, какие атрибуты из источника копируются в создаваемую финансовую операцию.
- Автором созданной финансовой операции является системный пользователь (
system-user), если не указано иное.
- В историю источника (ИИ) автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| typeCode |
String or expression |
Да |
Нет |
Тип создаваемой финансовой операции (код типа объекта). |
| sourceType |
String or expression |
Да |
Нет |
Тип объекта-источника: TASK, ASSET, SERVICE, CONTRACT. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между источником и создаваемой финансовой операцией. где CodeA -- коды атрибутов редактируемых задач, CodeB -- код атрибута источника. |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает. |
| typeCode |
- |
Определяет тип создаваемой финансовой операции. |
distributeItamFinanceOperation
1. Краткое описание действия
Создает финансовую операцию на основании объекта-источника и автоматически создает дочерние финансовые операции для связанных объектов с распределением суммы. Поддерживает:
- пропорциональное распределение (PROPORTIONAL)
- равное (эквивалентное) распределение (EQUAL)
- Поддерживает создание от:
- услуги (SERVICE)
- актива (ASSET)
- договора (CONTRACT)
- задачи (TASK)
2. Когда использовать
| Сценарий |
Описание |
| Создание фин. операций с пропорциональным распределением из Услуг/Активов/Договоров |
В родительском объекте создается финансовая операция. В связанных объектах (тип указан в targetObjectTypeVariable) создаются дочерние финансовые операции. Сумма распределяется пропорционально значению атрибута, указанному в proportionalVariableCode. |
| Создание фин. операций с эквивалентным распределением из Услуг/Активов/Договоров |
В родительском объекте создается финансовая операция. В связанных объектах (тип указан в targetObjectTypeVariable) создаются дочерние финансовые операции. Сумма распределяется равными долями. |
| Создание фин. операций с пропорциональным распределением из Задачи |
Создается финансовая операция от задачи с пропорциональным распределением по связанным объектам. |
| Создание фин. операций с распределением из Задачи |
Создается финансовая операция от задачи с распределением по связанным объектам. |
3. Особенности работы
- Действие создает одну родительскую финансовую операцию у объекта-источника и несколько дочерних финансовых операций у связанных объектов.
- Параметр
distributeTypeVariable определяет тип распределения суммы:
PROPORTIONAL - сумма распределяется пропорционально значению атрибута, указанному в proportionalVariableCode (например, доля распределения).EQUAL - сумма распределяется равными долями между всеми целевыми объектами.- Параметр
targetObjectTypeVariable указывает, у каких типов объектов (ASSET, TASK, SERVICE, CONTRACT) создавать дочерние финансовые операции.
- При использовании
EQUAL необходимо указать targetObjectVariable - код атрибута, который ссылается на таблицы основных сущностей.
- При использовании
PROPORTIONAL необходимо указать proportionalVariableCode - динамический атрибут, принадлежащий типу взаимосвязи, содержащий долю распределения.
- Автором созданных финансовых операций является системный пользователь (
system-user), если не указано иное.
- В историю источника (ИИ) автоматически записывается действие «Запуск бизнес-правила».
4. Параметры
Основные параметры
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| typeCode |
String or expression |
Да |
Нет |
Тип создаваемой финансовой операции (код типа объекта). |
| sourceType |
String or expression |
Да |
Нет |
Тип объекта-источника: TASK, ASSET, SERVICE, CONTRACT. |
Параметры копирования атрибутов
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| sourceAttributes |
String or expression |
Да |
{"attributeCodeMapping": { {CodeA1: CodeB2}, {CodeA2: CodeB2}... }, "allSame": false, "excludeAttributes": null } |
Маппинг атрибутов между источником и создаваемой финансовой операцией. где CodeA -- коды атрибутов редактируемых задач, CodeB -- код атрибута источника. |
Параметры распределения
| Параметр |
Тип |
Обязательность |
Значение по умолчанию |
Описание |
| distributeTypeVariable |
String or expression |
Да |
Нет |
Тип распределения. Доступные значения: - PROPORTIONAL - пропорциональный тип - EQUAL - равный тип |
| targetObjectTypeVariable |
String or expression |
Да |
Нет |
Класс(ы) объектов, где будут создаваться дочерние финансовые операции. Возможные значения: ASSET, TASK, SERVICE, CONTRACT (можно указывать несколько через запятую). |
| proportionalVariableCode |
String or expression |
Да (при PROPORTIONAL) |
Нет |
Указывается динамический атрибут, принадлежащий типу взаимосвязи, содержащий долю распределения. |
| targetObjectVariable |
String or expression |
Да (при EQUAL) |
Нет |
Код атрибута, который ссылается на таблицы основных сущностей. |
Совместимость параметров
| Параметр |
Используется с |
Комментарий |
| sourceAttributes |
sourceType |
Без источника не работает. |
| proportionalVariableCode |
distributeTypeVariable = PROPORTIONAL |
Обязателен для пропорционального распределения. |
| targetObjectVariable |
distributeTypeVariable = EQUAL |
Обязателен для равного распределения. |