Решение
Решение — элемент модели, который принимает входные данные и, применяя бизнес-правила (заданные в виде таблицы или выражения), формирует один или несколько выходных результатов.
При создании новой модели по умолчанию добавлен элемент решение:
При клике на решение в правой части становятся доступны свойства элемента:
Переименовать элемент можно двойным кликом по нему или через свойства.
Для ввода данных в таблицу кликните:
Откроется таблица для заполнения:
По клику правой кнопки мыши на ячейку шапки таблицы становится доступно меню:
Используя меню, можно добавить, скопировать/вставить, или удалить ячейки.
По клику на View DRD осуществляется переход назад к модели принятия решения.
Далее рассмотрим элементы таблицы принятия решения.
Описание элементов таблицы принятия решений
Таблица решений представляет собой логику принятия решений, которая может быть представлена в виде таблицы. Логика состоит из входов, выходов и правил.
Наименование таблицы решений
Политика выбора
Входной элемент
Выходной элемент
Правило
По клику правой кнопки мыши на строку решения становится доступно меню:
Используя меню, можно добавить, скопировать/вставить, или удалить строки решений, изменить язык выражения.
Политика выбора
Таблица решений имеет политику выбора, которая указывает, из чего состоят результаты оценки таблицы решений.
Политика выбора определяет, сколько правил таблицы решений может быть удовлетворено и какие из удовлетворяемых правил включаются в результат таблицы решений.
Политики выбора Unique, Any и First всегда будут возвращать не более одного удовлетворяемого правила.
Политики выбора Rule Order и Collect могут возвращать несколько удовлетворённых правил.
В используемом движке Camunda 7.24 поддерживаются Unique, Any, First, Rule Order и Collect. Политики Priority и Output order предусмотрены нотацией DMN, но не поддерживаются этим движком. См. поддерживаемые политики выбора.
Политика |
Описание |
|---|---|
Unique (Уникальная) |
Может быть выполнено только одно правило или вообще не может быть выполнено правило. Результат таблицы решений содержит выходные записи удовлетворённого правила.
Если выполняется более одного правила, нарушается политика уникального выбора.
Является политикой выбора по умолчанию.
|
First (Политика первого совпадения) |
Можно удовлетворить несколько правил. Результат таблицы решений содержит только вывод первого выполненного правила.
|
Priority |
Выходные данные правил имеют приоритет.
Правила могут перекрываться, но учитывается только совпадение с наивысшим выходным приоритетом.
Не поддерживается используемым движком Camunda 7.24.
|
Any (Любая) |
Можно удовлетворить несколько правил. Однако все удовлетворяемые правила должны генерировать один и тот же результат.
Результат таблицы решений содержит только вывод одного из удовлетворённых правил.
Если выполняются несколько правил, которые генерируют разные выходные данные, политика выбора нарушается.
|
Collect (Сбор) |
Можно удовлетворить несколько правил. Результат таблицы решений содержит вывод всех удовлетворяемых правил в произвольном порядке в виде списка.
Кроме того, для политики выбора Collect можно указать агрегатор.
Если указан агрегатор, результат таблицы решений будет содержать только одну выходную запись. Агрегатор сгенерирует выходную запись из всех удовлетворённых правил.
При использовании агрегатора таблица должна содержать только одну выходную колонку.
Для политики выбора Collect доступны следующие операторы
|
Rule order (Порядок применения правил) |
Можно удовлетворить несколько правил.
Результат таблицы решений содержит выходные данные всех удовлетворяемых правил в порядке следования правил в таблице решений.
|
Output order |
Результатом всех сопоставленных правил является список выходов, упорядоченных по их (убывающему) приоритету выхода.
Не поддерживается используемым движком Camunda 7.24.
|
Операторы для политики выбора Collect:
SUM |
Агрегатор SUM суммирует все выходные данные выполненных правил. |
MIN |
Агрегатор MIN можно использовать для возврата наименьшего выходного значения всех удовлетворяемых правил. |
MAX |
Агрегатор MAX можно использовать для возврата наибольшего выходного значения всех удовлетворяемых правил. |
COUNT |
Агрегатор COUNT можно использовать для возврата количества выполненных правил. |
Языки выражений
В стандартной конфигурации Camunda 7.24 язык по умолчанию для входного выражения, условия правила, выходного выражения и литерального выражения решения — FEEL.
Язык отдельного выражения задаётся атрибутом XML expressionLanguage. Если он не указан, применяется глобальный язык модели из definitions.expressionLanguage, а при его отсутствии — значение по умолчанию в конфигурации движка. Для использования JUEL выберите его явно; на стендах с legacy-конфигурацией значения по умолчанию могут отличаться.
Сервер также поддерживает JavaScript при явном указании expressionLanguage="javascript" в XML. Набор вариантов в меню зависит от версии редактора. Контекст DMN-выражения отличается от BPMN Script Task: доступность всех переменных и сервисов скриптовой задачи не предполагается.
Входной элемент
Таблица решений может иметь один или несколько входных элементов. Входной элемент определяет идентификатор, метку, выражение и тип ввода таблицы решений.
Ввод можно редактировать, дважды кликнув заголовок соответствующего столбца в таблице решений.
1 |
Наименование входного элемента |
Краткое описание. Обратите внимание, что наименование не обязательно, но рекомендуется, поскольку оно помогает понять суть решения. |
2 |
Expression |
Входное выражение указывает, как генерируется значение входного предложения.
Это выражение будет оцениваться механизмом DMN. Обычно это просто ссылка на переменную, которая доступна во время оценки.
|
3 |
Expression language |
Язык входного выражения. Основные варианты — FEEL и JUEL.
По умолчанию — FEEL. См. настройку языков выражений.
|
4 |
Input variable |
Имя входной переменной. Когда входное выражение оценивается, возвращаемое значение сохраняется в переменной.
Переменная может использоваться в выражении входной записи.
|
5 |
Type |
Тип входного предложения. После того как входное выражение оценивается механизмом DMN, он преобразует результат в указанный тип.
Поддерживаемые типы:
|
Примечание
В FEEL строковый литерал записывается в двойных кавычках: "Канцелярские товары". Имя переменной указывается без кавычек: входное выражение type получает значение переменной, а "type" возвращает постоянную строку. Тип string не меняет это правило.
Выходной элемент
Таблица решений может иметь один или несколько выходных элементов.
Выходной элемент определяет идентификатор, метку, имя и тип вывода таблицы решений.
1 |
Наименование выходного элемента |
Краткое описание. Обратите внимание, что наименование не обязательно, но рекомендуется, поскольку оно помогает понять суть решения. |
2 |
Output name |
Имя выхода используется для ссылки на значение выхода в результате таблицы решений.
Если таблица решений имеет более одного выхода, то все выходы должны иметь уникальное имя.
|
3 |
Type |
После того, как выходная запись оценивается механизмом DMN, он преобразует результат в указанный тип.
Поддерживаемые типы:
|
Примечание
В FEEL для строкового результата укажите литерал в двойных кавычках, например "Разрешить". Если результат нужно получить из переменной, используйте её имя без кавычек.
Правило
Таблица решений может иметь одно или несколько правил. Каждое правило содержит входные и выходные элементы.
Входные элементы являются условием, а выходные элементы — заключением правила. Если каждый входной элемент (условие) выполняется, то правило выполняется и результат решения содержит выходные элементы (заключение) этого правила.
Поле |
Описание |
|---|---|
Входной элемент |
Если входной элемент не имеет отношения к правилу, то выражение пусто.
Если в качестве языка выражений используется FEEL, то пустой входной элемент представлен как
-. В противном случае выражение пусто.Если язык не задан для выражения или модели, в стандартной конфигурации используется FEEL. См. настройку языков выражений.
|
Выходной элемент |
Правило может иметь один или несколько выходных элементов, которые являются выводами правила.
Если выходной элемент пустой, то выходные данные игнорируются и не являются частью результата таблицы решений.
Если язык не задан для выражения или модели, в стандартной конфигурации используется FEEL. Для JUEL язык нужно выбрать явно. См. настройку языков выражений.
|
Описание |
В правило может быть добавлено описание, содержащее дополнительную информацию. |
Типы решения
Для решения в свойствах доступны:
По нажатию на Literal Expression доступен ввод литерального выражения.
Литеральное выражение решения представляет собой логику решения, которая может быть представлена в виде выражения в DMN 1.3. Оно состоит из буквенного выражения и переменной.
Буквенное выражение указывает, как генерируется значение решения. Это выражение будет оцениваться механизмом DMN. Его можно использовать для выполнения сложных вычислений, для вызова bean-компонента, обеспечивающего логику принятия решений, или для объединения выходных значений решений.
Литеральное выражение решения должно иметь переменную, которая определяет имя и тип результата решения.
Пример создания таблицы принятия решений
Пример: Решение по закупке
Кликните дважды на поле и установите название решения «Решение по закупке». Далее перейдите к таблице решений, кликнув значок таблицы в верхней части решения:
Для установки наименования входного элемента, дважды кликните поле под «When» и введите «Группа товаров» в самом верхнем поле.
Для установки наименования выходного элемента, дважды кликните поле под «Then» и введите «Согласование» в самом верхнем поле.
Предполагая, что входное значение для «Группа товаров» представляется переменной с именем «type», входное выражение должно быть «type» c типом string.
Дважды кликните поле «Группа товаров». В появившемся модальном меню установите
typeбез кавычек в качестве выражения, язык FEEL и тип string, затем закройте меню.
Затем дважды щелкните поле «Согласование» и установите «agreement» в качестве названия выходного элемента и тип string.
Далее добавьте первое правило, указывающее, что для «Канцелярские товары» — «Разрешить».
Нажмите кнопку «+» внизу таблицы или просто нажмите в любом месте последней строки.
Для условия и выходного выражения используйте язык FEEL. В добавленной строке введите
"Канцелярские товары"в столбце ввода и"Разрешить"в столбце вывода, включая двойные кавычки.
"Канцелярские товары"— условие правила в FEEL, которое проверяет, равно ли значение переменнойtypeстроке «Канцелярские товары»."Разрешить"— выходное выражение правила в FEEL, возвращающее строку «Разрешить».Затем добавьте второй входной элемент «Стоимость» с входным выражением
costбез кавычек, языком FEEL и типом integer. Заполните таблицу дополнительными правилами для оставшихся Групп товаров.
Установите для политики выбора значение «Unique», которое указывает, что может совпадать только одно правило. Убедитесь, что таблица решений содержит только одно правило, которое может соответствовать входным данным.
Кликните раскрывающийся список «Политика выбора» и выберите политику «Unique».
Реализация DMN для динамической роли
Динамическая роль назначается в типе данных на вкладке Роли и устанавливает гибкую логику, по которой будет произведено вычисление состава пользователей роли.
Входными данными для вычисления DMN является заполненная Модель на основе рекорда. Рекорд — сущность с набором атрибутов и идентификатором записи (RecordRef), см. подробно о Records API.
В модели могут быть использованы системные атрибуты.
По ключу модели будут доступны вычисленные данные рекорда в контексте DMN.
Модель заполняется в Описании DMN:
Предупреждение
Переменные бизнес-процесса, в том числе documentRef, при вычислении роли недоступны — роль пересчитывается вне процесса. Входные данные передаются только через Модель.
Решение DMN должно вернуть String с именами реципиентов. Если в одной строке DMN необходимо перечислить несколько реципиентов, то их можно разделить запятой:
Реципиента можно указать именем пользователя ("ivan.petrov"), группой с префиксом GROUP_ ("GROUP_administrators") или recordRef пользователя либо группы ("emodel/person@ivan.petrov", "emodel/authority-group@administrators").
Hit policy выбирается из поддерживаемых движком политик в зависимости от необходимого результата. См. Политика выбора.
Конечный Output variable name значения не имеет, можно оставить пустым. Главное указать тип String.
В состав роли попадают значения всех выходных колонок всех сработавших правил. Выходных колонок, не являющихся именами реципиентов, в таком решении быть не должно — их значения тоже будут добавлены в роль. Для пояснений используйте колонку Annotations, она в результат не входит.
При вычислении всегда используется последняя опубликованная версия DMN.
См. пример использования DMN для динамической роли.
См. также