6.3.2. Including PMML models within a DMN file in Business Central

Procedure

1. In your DMN project, add the following dependencies to the project pom.xml file to enable PMML evaluation:

   <!-- Required for the PMML compiler -->
   <dependency>
     <groupId>org.drools</groupId>
     <artifactId>kie-pmml</artifactId>
     <version>${rhdm.version}</version>
     <scope>provided</scope>
   </dependency>
   
   <!-- Alternative dependencies for JPMML Evaluator, override `kie-pmml` dependency -->
   <dependency>
     <groupId>org.kie</groupId>
     <artifactId>kie-dmn-jpmml</artifactId>
     <version>${rhdm.version}</version>
     <scope>provided</scope>
   </dependency>
   <dependency>
     <groupId>org.jpmml</groupId>
     <artifactId>pmml-evaluator</artifactId>
     <version>1.5.1</version>
     <scope>provided</scope>
   </dependency>
   <dependency>
     <groupId>org.jpmml</groupId>
     <artifactId>pmml-evaluator-extension</artifactId>
     <version>1.5.1</version>
     <scope>provided</scope>
   </dependency>

   To access the project pom.xml file in Business Central, you can select any existing asset in the project and then in the Project Explorer menu on the left side of the screen, click the Customize View gear icon and select Repository View pom.xml.

   If you want to use the full PMML specification implementation with the Java Evaluator API for PMML (JPMML), use the alternative set of JPMML dependencies in your DMN project. If the JPMML dependencies and the standard kie-pmml dependency are both present, the kie-pmml dependency is disabled. For information about JPMML licensing terms, see Openscoring.io.

   重要

   The legacy kie-pmml dependency is deprecated with Red Hat Decision Manager 7.10.0 and will be replaced by kie-pmml-trusty dependency in a future Red Hat Decision Manager release.

   注記

   Instead of specifying a Red Hat Decision Manager <version> for individual dependencies, consider adding the Red Hat Business Automation bill of materials (BOM) dependency to your project pom.xml file. The Red Hat Business Automation BOM applies to both Red Hat Decision Manager and Red Hat Process Automation Manager. When you add the BOM files, the correct versions of transitive dependencies from the provided Maven repositories are included in the project.

   Example BOM dependency:

   <dependency>
     <groupId>com.redhat.ba</groupId>
     <artifactId>ba-platform-bom</artifactId>
     <version>7.10.0.redhat-00004</version>
     <scope>import</scope>
     <type>pom</type>
   </dependency>

   For more information about the Red Hat Business Automation BOM, see What is the mapping between RHDM product and maven library version?.

2. If you added the JPMML dependencies in your DMN project to use the JPMML Evaluator, download the following JAR files and add them to the ~/kie-server.war/WEB-INF/lib and ~/business-central.war/WEB-INF/lib directories in your Red Hat Decision Manager distribution:

   • kie-dmn-jpmml JAR file in the Red Hat Decision Manager 7.10.0 Maven Repository distribution (rhdm-7.10.0-maven-repository/maven-repository/org/kie/kie-dmn-jpmml/7.48.0.Final-redhat-00004/kie-dmn-jpmml-7.48.0.Final-redhat-00004.jar) from the Red Hat Customer Portal
   • JPMML Evaluator 1.5.1 JAR file from the online Maven repository
   • JPMML Evaluator Extensions 1.5.1 JAR file from the online Maven repository

   These artifacts are required to enable JPMML evaluation in KIE Server and Business Central.

   重要

   Red Hat supports integration with the Java Evaluator API for PMML (JPMML) for PMML execution in Red Hat Decision Manager. However, Red Hat does not support the JPMML libraries directly. If you include JPMML libraries in your Red Hat Decision Manager distribution, see the Openscoring.io licensing terms for JPMML.

3. In Business Central, go to Menu Design Projects, click the project name, and select the DMN file you want to modify.
4. In the DMN designer, click the Included Models tab.

5. Click Include Model, select a PMML model from your project in the Models list, enter a unique name for the included model, and click Include:

   図6.43 Including a PMML model

   

   The PMML model is added to this DMN file:

   図6.44 DMN file with included PMML model

   

6. In the Model tab of the DMN designer, select or create the decision node or business knowledge model node in which you want to invoke the PMML model and click the Edit icon to open the DMN boxed expression designer:

   図6.45 Opening a new decision node boxed expression

   

   図6.46 Opening a new business knowledge model boxed expression

   
7. Set the expression type to Function (default for business knowledge model nodes), click the top-left function cell, and select PMML.

8. In the document and model rows in the table, double-click the undefined cells to specify the included PMML document and the relevant PMML model within that document:

   図6.47 Adding a PMML model in a DMN business knowledge model

   

   図6.48 Example PMML definition in a DMN business knowledge model

   

   If you update the source file for an included PMML model, you must remove and re-include the PMML model in the DMN file to apply the source changes.

   To edit the included model name or to remove the included model from the DMN file, use the Included Models tab in the DMN designer.