Managing input and output data for DMN data input elements

The dictionary enables you to manage the objects of your business process landscape.

Specifically for DMN, the dictionary implements extended functionality for the management of input data and output objects.

To enable input/output data management with the dictionary, open the explorer and click Setup > Define notations/attributes.

Switch to the Dictionary tab and create a new category (click Add category). The category needs to have the check box Use for data modeling activated (you can also activate this check box when editing an existing category):

Add a new category and activate the check box 'Use for data modeling'.

Now you can create data input/output objects in the dictionary.

Open the dictionary (the last item in the explorer's folder tree):

In the dictionary, select a category that supports data modeling and click New entry:

In the following dialog, you can label and describe the data object:

It is important to define the Type Definition of the data input:

  • A Simple Type can be an enumeration of values, plain text, a number or a Boolean value:
  • Complex Type allows you to reference one or several dictionary items and to add simple data types like plain text, numbers, Booleans or enumerations.

    To reference a dictionary item, fill in a label for the reference, start typing the entry's name into the corresponding field and select a suggestion from the list:

    Reference a dictionary item as part of a 'Complex Type' definition.

    To add a simple data type, fill in a label for the type, click the + icon next to the second column and select a data type from the list:

    Create a local type as part of a 'Complex Type' definition.

  • Not specified allows you to specify the data type in the DMN Editor.

If the dictionary entry is used as a data input object, you can add a domain-specific export name. To do so, specify a technical name. This name is used when exporting a DMN diagram as XML or Drools rules. Read more in section Export a DMN diagram as XML and Exporting DMN diagrams as drools rules.

If the dictionary entry is used as a data definition, you can add a java source reference. To do so, specify a class name. This name is used when exporting a DMN diagram as Drools rules. Read more in section Exporting DMN diagrams as drools rules.

If both names are set in one dictionary entry, only the class name is exported.

Click Create to create the specified data object:

Now, you can reference the newly created data input in decision tables and data input elements:

You can also add input data from a DMN diagram to the dictionary.

Select the element and click the Dictionary item in the lower left corner of the element:

Create a dictionary entry based on the data input element.

Select the correct category (make sure to use a category that supports DMN data modeling) and click Create:

Now, the data input is saved in the dictionary and can be re-used in the editor. When labeling a data input element, automatic suggestions will help modelers with re-using already existent data inputs:

Reference an existing data object.