Chapter 3. Decision Model and Notation (DMN)

Procedure

1. On the traffic-violation project’s home page, click Add Asset.

2. On the Add Asset page, click DMN. The Create new DMN window is opened.

   1. In the Create new DMN window, enter Traffic Violation in the DMN name field.
   2. From the Package list, select org.kie.example.traffic.traffic_violation.
   3. Click Ok. The DMN asset in the DMN designer is opened.
3. In the DMN designer canvas, drag two DMN Input Data input nodes on to the canvas.
4. Double-click each input node and rename one to Driver and the other to Violation.
5. Drag a DMN Decision decision node on to the canvas.
6. Double-click the decision node and rename it to Fine.
7. Click the Violation input node, select the Create DMN Information Requirement icon and click on the Fine decision node to link the two nodes.
8. Drag a DMN Decision decision node on to the canvas.
9. Double-click the decision node and rename it to Should the driver be suspended?.
10. Click the Driver input node, select the Create DMN Information Requirement icon and click on the Should the driver be suspended? decision node to link the two nodes.
11. Click the Fine decision node, select the Create DMN Information Requirement icon, and select the Should the driver be suspended? decision node.
12. Click Save and click Save again to confirm.

Procedure

1. From the Data Types tab, click Add.

2. First, create the tDriver custom data type. Enter tDriver as the Name and select Structure as the Type. Click Save for each data type that you add.

   Figure 3.4. The tDriver custom data type

   

3. Next to the tDriver data type, click the three vertical dots, select Insert nested field, and add the following nested data types. Click Save for each data type that you add.

   • Name (string)
   • Age (number)
   • State (string)
   • City (string)
   • Points (number)

4. Next, create the tViolation data type. From the Data Types tab, click Add.

   Figure 3.5. The tViolation custom data type

   
5. Enter tViolation as the Name and select Structure as the Type. Click Save to save the data type.

6. Next to the tViolation data type, click the three vertical dots, select Insert nested field, and add the following nested data types. Click Save for each data type that you add.

   • Code (string)
   • Date (date)
   • Type (string)
   • Speed Limit (number)
   • Actual Speed (number)

7. For the nested Type data type that you created, click Edit → Constraints → Enumeration and add the following constraints. Click the check icon to save each enumeration constraint that you add.

   • "speed"
   • "parking"
   • "Driving under the influence?"

8. Finally, create the tFine data type. From the Data Types tab, click Add.

   Figure 3.6. The tFine custom data type

   
9. Enter tFine as the Name and select Structure as the Type. Click Save to save the data type.

10. Next to the tFine data type, click the three vertical dots, select Insert nested field, and add the following nested data types. Click Save for each data type that you add.

    • Amount (number)
    • Points (number)
11. Once all the three custom data types are created, click Save to open the Confirm Save dialog box and click Save again.

Procedure

1. Click the Model tab on the DMN designer and click Diagram properties in the top-right corner of the DMN designer to expose the DRD properties.
2. In the DRD, select the Driver input data node and in the Diagram properties panel, set Data type to tDriver.
3. Select the Violation input data node and set the Data type to tViolation.
4. Select the Fine input data node and set the Data type to tFine.

5. Select the Should the driver be suspended? decision node and set the following properties:

   • Data type: string
   • Question: Should the driver be suspended due to points on his driver license?
   • Allowed Answers: "Yes","No"
6. Click Save to open the Confirm Save dialog box and click Save again.

Procedure

1. To calculate fine, in the DMN designer canvas, select the Fine decision node and click the Edit icon to open the DMN boxed expression designer.
2. Click Select expression → Decision Table.
3. For the Violation.Date, Violation.Code, and Violation.Speed Limit parameter fields, right-click and select Delete for each field.
4. Click the Violation.Actual Speed column header and enter the expression Violation.Actual Speed - Violation.Speed Limit in the Name field.
5. Right-click the Fine parameter field and select either Insert left or Insert right.
6. Click the output-2 column sub-header, enter Amount in the Name field, and select number from the Data Type field.
7. Similarly, click the output-1 column sub-header, enter Points in the Name field, and select number from the Data Type field.

8. Next, enter the following values in the first row of the decision table:

   • Violation.Type: "speed"
   • Violation.Actual Speed - Violation.Speed Limit: [10..30]
   • Amount: 500

   • Points: 3

     Right-click the first row and select Insert below to add another row.

9. Enter the following values in the second row of the decision table:

   • Violation.Type: "speed"
   • Violation.Actual Speed - Violation.Speed Limit: >= 30
   • Amount: 1000

   • Points: 7

     Right-click the second row and select Insert below to add another row.

10. Enter the following values in the third row of the decision table:

    • Violation.Type: "parking"
    • Violation.Actual Speed - Violation.Speed Limit: -
    • Amount: 100

    • Points: 1

      Right-click the third row and select Insert below to add another row.

11. Enter the following values in the fourth row of the decision table:

    • Violation.Type: "driving under the influence"
    • Violation.Actual Speed - Violation.Speed Limit: -
    • Amount: 1000
    • Points: 5
12. Click Save to open the Confirm Save dialog box and click Save again.
13. To define the driver suspension rule, return to the DMN designer canvas, select the Should the driver be suspended? decision node, and click the Edit icon to open the DMN boxed expression designer.
14. Click Select expression → Context.
15. Click ContextEntry-1, enter Total Points as the Name, and select number as the Data Type.
16. Click the cell next to Total Points, select Literal Expression from the context menu, and enter Driver.Points + Fine.Points as the expression.
17. In the cell below Driver.Points + Fine.Points, select Literal Expression from the context menu, and enter if Total Points >= 20 then "Yes" else "No".

18. Click Save to open the Confirm Save dialog box and click Save again.

    You have defined how to calculate the fine and the context for deciding when to suspend the driver. You can navigate to the traffic-violation project page and click Build to build the example project and address any errors noted in the Alerts panel.