Skip to main content

Import a BPMN File

Jetmir Abdija avatar
Written by Jetmir Abdija
Updated over a week ago

BlueDolphin allows you to import BPMN 2.0-compatible standard XML format files into the Processes. A file name must be unique and not already used for that tenant.

BPMN 2.0 compatible.png

NOTE: To check if your BPMN file can be imported into BlueDolphin, try loading it at https://demo.bpmn.io/. If it loads successfully, you can import it into BlueDolphin without issues.

  1. To start the process, go to the Diagrams tab.

  2. Click the Import BPMN file button located in the bottom-right corner.

  3. Select the desired file using the file picker.

Import BPMN file.jpeg

After a successful import, the following message is displayed:

Import succeeded.png

Click the Go to diagram option from the notification to open the diagram directly from the message box.

The diagram name from an imported file takes the name from the file.

If a diagram with the same name as the one you are trying to import already exists in the tenant, the import will not be successful. An error message appears as,

BPMN_diagram_name_exists_error.png

You have to rename the diagram first and then import the BPMN file.

Import of description elements across all BPMN elements

BlueDolphin now fully supports importing the <documentation> element from any BPMN element.

When you import a BPMN diagram (XML) from an external tool:

  • All <documentation> content is preserved and placed in the Description field of the corresponding element in BlueDolphin.

  • Multiple <documentation> tags are merged cleanly with line breaks.

For example,

<bpmn:task id="Task_1" name="Review Request">
    <bpmn:documentation>Initial Customer Need / Goal description</bpmn:documentation>
</bpmn:task>
description from documentation tag.jpeg

This ensures you retain all critical process context when migrating from other tools, with no manual rework required.

BlueDolphin currently does not support <documentation> and <collaboration> elements.

Did this answer your question?