Выражения в 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 сразу поддерживает два языка выражений:

Если в 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.

Устаревшее поведение

Как вернуть устаревшее поведение, при котором для входных выражений, выходных условий и литеральных выражений использовался JUEL, описано здесь.

Язык по умолчанию можно сменить прямо в 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.