Creating and editing DMN diagrams

This chapter explains DMN modeling with Signavio Process Manager. You can find more general instructions on how to edit diagrams in the chapter Basic modeling with the Editor.

Creating and editing DMN diagrams

To create a DMN diagram, proceed as follows:

1. Open the Explorer and select New - Business Decision Diagram (DMN 1.0):

Create a new DMN diagram.

Your browser will open the editor with a blank DMN canvas in a new tab.

A new DMN diagram in the Editor.

A new DMN diagram in the Editor.

  1. Once you have created or opened a DMN diagram, you can simply drag and drop an element from the shape repository on the left onto the canvas:

    Drag and drop elements onto the canvas.
  2. You can also use the interactive context menu of an already existing element to create new DMN elements.

    Make use of the interactive context menu.
  3. Label the element.

Label the decision element.
  1. Add attributes to the element. A decision can typically be described by a question - answer scheme. By default, there are attributes on decision element level for documenting this scheme for each decision:

    Define decision question and answers.

6. To save the diagram, click the Save button in the upper left corner of the Editor.

Save the diagram.

Signavio Process Manager Tutorial (1/3): Building a decision model in DMN

In the following video tutorial you will learn how to create a new decision diagram.

Copying elements and element groups

For faster modeling, it can be helpful to copy elements or interconnected element groups. If you copy an interconnected group of DMN elements in the Editor contained decision tables and attributes are copied as well.

In our example, we determine a customer discount and subsequently calculate the purchase price of products with an additional discount and normally priced products separately to be able to have the values displayed separately on the bill:

These elements are almost identical and can be copied during the modeling process to save time. As both 'Product value' input elements have the same input range, only the label has to be altered here.

These elements are almost identical and can be copied during the modeling process to save time. As both ‘Product value’ input elements have the same input range, only the label has to be altered here.

  1. To copy elements, select them, then click the Copy button.

    Click the 'Copy' button in the toolbar.
  2. Then click the Paste button in the Editor’s toolbar.

    Next, click the 'paste' button. The copied elements will appear and can be rearranged.
  3. Now, rearrange the elements as needed and alter decisions and names, then connect them to other elements if necessary.

Note

You can also copy elements from one diagram to another. For this, we recommend you to open the corresponding diagrams in different browser tabs. This procedure is especially helpful when you split one complex model into multiple, better understandable parts.

Creating complex input data elements

In many cases, it is impractical to model each data input parameter as a separate element.

Instead, you can create complex data input elements.

For example, the Data Input element Order can contain the attributes Purchase value and Customer status.

  1. To configure a data input element as complex, set the value of the attribute Type definition to Complex type:

    Configure a Data Input element as "Complex type".
  2. Now, click the Edit button next to Attribute to open the configuration dialog.

    Open the attribute configuration dialog.
  3. In the configuration dialog, you can add attributes and define their properties. For each attribute, you need to define the name and the type. Depending on the type, you can define further properties.

    Define attribute properties.
  4. Click Save to confirm the changes.

    After configuring the complex input data element, the attributes are available in the Decision Table editor, for example as Order.Purchase value:

    Reference an attribute of a complex data input element in a decision table.

Creating sub decisions

In many situations, a decision depends on one or multiple sub decisions. In such a case, you can daisy-chain decision elements or transform Data Input elements into Decisions as depicted below:

../../_images/dmn_transformtodecision.png

In case you transform a data input, a new data input is automatically created and attached to the sub decision:

../../_images/dmn_addinput.png

In our example, when opening the Decision Table, its output is already defined. All you need to do is create possible additional inputs and map them to output values.

Signavio Process Manager Tutorial (2/3): Building a decision table

In the following video tutorial you will learn how to build a decision table.

Multi Instance Decisions

Multi instance decisions (an extension of the DMN standard) are (sub)decisions, which are executed several times (once per entry/object of a list) and serve as data input for a higher level decision. Multi instance decisions are similar to a for-loop in a computer program.

In the example below, each position of the purchase agreement is validated to determine the validity of the entire agreement.

Sample: decision for each position.

In this sample the decision is made for each position.

To create a multi instance decision, proceed as follows:

  1. Select DMN 1.0 (Complete) from the shape repository.

    Select the complete element set.
  2. Click Multi Instance Decision and drag the element onto the canvas.

    Adding a multi instance decision.
  3. Reference a list of data inputs, or a data input object that contains such a list.

    Reference a data input.
  4. Define the internal decision logic of the multi instance decision. The referenced objects are no lists.

    Creating an internal decision logic.
  5. Open the configuration dialog of the Iteration attribute to configure the multi instance decision.

    . Open the dialog **Iteration**.
  6. Specify the input list and aggregation function.

    Definieren der Eingabeliste und Aggregationsfunktion.

    In our example, all positions have to be valid.

  7. Finally, the multi instance decision can be referenced by a higher level decision.

    Reference the multi instance decision.

Linking BPMN diagrams to DMN diagrams

You can easily link DMN diagrams to tasks in BPMN diagrams.

  1. Once you have created the Task in the BPMN diagram, change the Task type to Business Rule.

    Change the task type to 'Business Rule'.
  2. Now, select the attribute Decision reference:

    Select the 'Decision reference' attribute.
  3. Alternatively, you can click the arrow in the upper left corner of the Task. The dialog Establish link opens.

    Click the table icon.

4. You can either create a new DMN diagram or link an already existing one.

Link a DMN diagram to a BPMN task.

Signavio Process Manager Tutorial (3/3): Connecting a decision model to a process

In the following video tutorial you will learn how to connect a decision model to a process.