Выражения в DMN-движке
В таблицах решений и литеральных выражениях решений можно задавать выражения нескольких типов. В этом разделе описаны эти типы, перечислены поддерживаемые языки выражений и показано, как сменить язык для отдельного выражения.
Выражения в DMN
Как описано в справочнике по таблицам решений и литеральным выражениям решений, поддерживаются четыре типа выражений:
-
Input Expression (входное выражение): задает входное значение столбца таблицы решений;
-
Input Entry (входное условие): определяет, применимо ли правило таблицы решений;
-
Output Entry (выходное условие): возвращает значение, которое попадает в выход подходящего правила;
-
Literal Expression (литеральное выражение): задает значение литерального выражения решения.
Подробнее см. справочник по DMN 1.3. В XML DMN 1.3 выражения находятся в элементах inputExpression, inputEntry, outputEntry и literalExpression:
<definitions xmlns="https://www.omg.org/spec/DMN/20191111/MODEL/" id="definitions" name="definitions" namespace="http://camunda.org/schema/1.0/dmn">
<decision id="decision" name="Decision">
<decisionTable>
<input id="input">
<!-- входное выражение задает входное значение столбца -->
<inputExpression>
<text>age</text>
</inputExpression>
</input>
<output id="output"/>
<rule id="rule1">
<!-- входное условие определяет, применимо ли правило -->
<inputEntry>
<text>[18..30]</text>
</inputEntry>
<!-- выходное условие задает результат правила, если оно применимо -->
<outputEntry>
<text>"okay"</text>
</outputEntry>
</rule>
</decisionTable>
</decision>
<decision id="decision2" name="Decision 2">
<!-- литеральное выражение задает значение этого решения -->
<literalExpression>
<text>a + b</text>
</literalExpression>
</decision>
</definitions>
Поддерживаемые языки выражений
DMN-движок OpenBPM Engine сразу поддерживает два языка выражений:
-
JUEL: сопровождаемая в OpenBPM Engine реализация Unified Expression Language для Java; -
FEEL: Friendly Enough Expression Language из стандарта DMN 1.2.
Если в classpath есть реализация JavaScript для JSR-223, например GraalJS, доступен и язык javascript.
Можно использовать любой другой скриптовый язык с реализацией JSR-223, например groovy, python или ruby. Для этого добавьте в проект соответствующую зависимость.
Например, чтобы использовать для выражений groovy, добавьте в pom.xml проекта следующие зависимости:
<dependency>
<groupId>org.apache.groovy</groupId>
<artifactId>groovy</artifactId>
<version>${GROOVY_VERSION}</version>
</dependency>
<dependency>
<groupId>org.apache.groovy</groupId>
<artifactId>groovy-jsr223</artifactId>
<version>${GROOVY_VERSION}</version>
</dependency>
<dependency>
<groupId>org.apache.groovy</groupId>
<artifactId>groovy-json</artifactId>
<version>${GROOVY_VERSION}</version>
</dependency>
<dependency>
<groupId>org.apache.groovy</groupId>
<artifactId>groovy-xml</artifactId>
<version>${GROOVY_VERSION}</version>
</dependency>
<dependency>
<groupId>org.apache.groovy</groupId>
<artifactId>groovy-templates</artifactId>
<version>${GROOVY_VERSION}</version>
</dependency>
<dependency>
<groupId>org.apache.groovy</groupId>
<artifactId>groovy-dateutil</artifactId>
<version>${GROOVY_VERSION}</version>
</dependency>
<dependency>
<groupId>org.apache.groovy</groupId>
<artifactId>groovy-datetime</artifactId>
<version>${GROOVY_VERSION}</version>
</dependency>
Язык выражений по умолчанию
По умолчанию DMN-движок использует для выражений следующие языки:
-
входные выражения (Input Expression):
FEEL; -
входные условия (Input Entry):
FEEL; -
выходные условия (Output Entry):
FEEL; -
литеральные выражения (Literal Expression):
FEEL.
|
Устаревшее поведение
Как вернуть устаревшее поведение, при котором для входных выражений, выходных условий и литеральных выражений использовался |
Язык по умолчанию можно сменить прямо в XML DMN 1.3: задайте глобальный язык выражений атрибутом expressionLanguage элемента definitions:
<!-- назначает javascript языком по умолчанию -->
<!-- для всех выражений в этом файле -->
<definitions xmlns="https://www.omg.org/spec/DMN/20191111/MODEL/" id="definitions" name="definitions" namespace="http://camunda.org/schema/1.0/dmn" expressionLanguage="javascript">
<decision id="decision" name="Decision">
<decisionTable>
<!-- ... -->
</decisionTable>
</decision>
</definitions>
Язык выражений по умолчанию можно также изменить в конфигурации DMN-движка, как описано в руководстве пользователя.
Язык отдельного выражения
Язык можно задать и для каждого выражения отдельно атрибутом expressionLanguage:
<definitions xmlns="https://www.omg.org/spec/DMN/20191111/MODEL/" id="definitions" name="definitions" namespace="http://camunda.org/schema/1.0/dmn">
<decision id="decision" name="Decision">
<decisionTable>
<input id="input">
<!-- javascript для этого входного выражения -->
<inputExpression expressionLanguage="javascript">
<text>age</text>
</inputExpression>
</input>
<output id="output"/>
<rule id="rule1">
<!-- juel для этого входного условия -->
<inputEntry expressionLanguage="juel">
<text><![CDATA[cellInput >= 18 && cellInput <= 30]]></text>
</inputEntry>
<!-- javascript для этого выходного условия -->
<outputEntry expressionLanguage="javascript">
<text>"okay"</text>
</outputEntry>
</rule>
</decisionTable>
</decision>
<decision id="decision2" name="Decision 2">
<!-- groovy для этого литерального выражения -->
<literalExpression expressionLanguage="groovy">
<text>a + b</text>
</literalExpression>
</decision>
</definitions>
Чтобы использовать другую реализацию Java Unified Expression Language или FEEL, замените реализацию по умолчанию в конфигурации DMN-движка. Там же можно изменить выбор скриптовых движков JSR-223, например чтобы настроить скриптовый движок перед использованием.
Документация создана на основе Camunda 7 Docs (Camunda, docs.camunda.org) и распространяется по лицензии Creative Commons Attribution-ShareAlike 3.0 Unported.