DMN Import Wizard

The wizard for importing from DMN guides you step-by-step through the process for importing files that correspond to the DMN specification 1.1. to DMN 1.3 and comply with the XML schema definition of this specification.

Purpose

The DMN Import Wizard takes you through the steps necessary for importing DMN data where the data to be imported and target location in the model will be set.

Note

Unlike when creating elements in the diagram editor, existing create defaults are ignored upon import. All imported decision elements are contained in the model's selected structure element upon import.

You can verify the import and then rearrange the assignment to structure elements from the Model Element List using drag-and-drop.

Prerequisites

You can only import model elements defined by the DMN standard.

The files must comply with the XML schema definition.

You require a role with access rights for the model to be imported if you wish to import DMN data.

Call

Select Import/Export>Import>DMN.

Step 1 of 7: Select Files

Prerequisites

You import DMN model elements from DMN XML files that you have exported from Innovator or other tools.

Context

Select the DMN files with the content you want to import as decision elements in the model.

How to proceed

  1. Click on Select....

    The standard dialog for opening files appears.

  2. Select one or more files for import in the Open standard dialog using the [Ctrl] key. Use the search in the standard dialog to import files from different directories.

  3. Confirm your selection with Open.

    The selected files are listed.

  4. Click on Next.

    Continue with step 2 Select Stereotypes.

Step 2 of 7: Select Stereotypes

Context

Multiple create templates for model element types to be imported can exist in the importing model when DMN elements are adopted. You can select which stereotype should be used in the Stereotype Selection section for all element types with more than one stereotype in the model that you have the privilege for their create template for.

The stereotype's name is exported when exporting from Innovator into a DMN file and used when possible upon import, independently from the stereotype selected here. Creating decision elements in the original state is supported here.

How to proceed

  1. To select a specific create template for a listed model element type, open the drop-down list and select the template.

  2. Click on Next.

    Continue with step 3 Select Storage Location in Model.

Step 3 of 7: Select Storage Location in Model

Context

You can store imported decision elements in an existing or new structure element in the model.

How to proceed

  1. To place the imported decision elements in an existing structure element, click on Store into Existing Package.

    You define an owner of the element in your model in the next step. The model elements are placed in the model under this user.

    Continue with step 6 Select Storage Location in Model.

  2. To store the decision elements to be imported in a new structure element, click on Create New Package.

    You create an element in your model in the next step by selecting a create template. The model elements are placed in the model under this element.

    You can then define the owner of the element to be created in the model.

    Continue with step 4 Select Template.

Step 4 of 7: Select Template

Prerequisites

You want to store the imported decision elements in a new structure element of the model.

The structure element must be uniquely named.

Context

In this step, the create templates suitable for the storage of the imported decision elements in the model and for which you have execution rights are offered to you.

How to proceed

  1. Select the create template for the new structure element.

  2. Enter a unique name for the structure element in the Name field.

    If the name already exists in the namespace and is therefore not unique, a corresponding message appears in step 8. You must select another, conflict-free owner or return to this step to assign a unique name.

  3. Click on Next.

    Continue with step 5 Select Owner.

Step 5 of 7: Select Owner

Prerequisites

You want to store the imported decision elements in a new structure element of the model.

Context

The new structure element must be arranged in the model structure by means of assignment to an owner. The structure element is created under the owner. The imported decision elements are stored in this structure element.

The first allowed owner in the model structure is preselected.

How to proceed

  1. If you know part of the name of the desired owner, then enter this name part into the Find by Name field and click on .

    The selection jumps to the first permitted owner in the model structure. Click on again to jump to the next hits.

  2. If you want to directly select the owner in the model structure, click on the corresponding element in the tree.

  3. Click on Next.

Continue with step 7 Ready to Import.

Step 6 of 7: Select Storage Location in Model

Prerequisites

You want to store the imported decision elements in an existing structure element of the model.

Context

The imported decision elements are stored in this selected structure element.

The first allowed owner in the model structure is preselected.

How to proceed

  1. If you know part of the name of the desired owner, then enter this name part into the Find by Name field and click on .

    The selection jumps to the first permitted owner in the model structure. Click on again to jump to the next hits.

  2. If you want to directly select the owner in the model structure, click on the corresponding element in the tree.

  3. Click on Next.

    Continue with step 7 Ready to Import.

Step 7 of 7: Ready to Import

How to proceed

  1. Check your specifications.

  2. Click on Import to import the decision elements with these specifications into the model.

    A progress indicator appears, telling you roughly how much longer the import will take.

    The import end time stamp is shown in the DMN Import - Messages tab in the Info tool window.

Further Information

https://www.omg.org/spec/DMN/