Export and import with versioning

You can export a single BPMN diagram to XML by using the export button from the BPMN Modeler toolbar. This export can be performed for all version types – draft, approved, and read-only draft. Importing a single diagram is possible only when the current version has Draft status.

When exporting a folder, only the latest approved version for each diagram in the folder is included in the export archive. If a diagram has only a draft version, it is not included in the export file.

On importing a folder, a dialog is shown when duplicate content is found in the import file. You can choose to merge the imported content or to overwrite the local content.

On Merge, if a diagram is included in the import file that already exists in the import target folder, it is appended as the newest approved version to that diagram. For example, if there is a version 2 (approved) as the most recent approved version, the imported diagram is added as version 3 (approved). If there is a draft present when this happens: version 3 (draft), the draft stays in its place and becomes a read-only draft. The imported version is then stacked on top as the most recent approved version, in this example, as version 4 (approved). Other content referenced from the imported diagram is merged with the existing content as well.

On Overwrite, if a diagram is included in the import file that already exists in the import target folder, the imported diagram replaces the existing diagram with version 1 and Approved status. Older versions of the same diagram are removed. If a diagram does not exist in the import file, it is removed from the local target folder. Other content referenced from the imported diagram is overwritten as well.