How to import a Camunda or Signavio BPMN file into Confluence

By Jake Marsh · Updated

To import a BPMN file into Confluence, edit the page, type /bpmn, choose BPMN diagram (Lanemark), click Import a file and pick the .bpmn or .xml file. Lanemark opens it as an editable BPMN 2.0 diagram, lays it out left to right if the file has no layout, and keeps vendor extensions such as camunda: attributes so a later download can go back to the tool it came from. Save the first version and publish the page.

Which files work

Lanemark reads BPMN 2.0 XML from standards-based tools, including:

ToolHow to get the file
Camunda Modeler (desktop)The .bpmn file you save
Camunda 8 web modelerDownload the diagram as BPMN
SAP SignavioExport as BPMN 2.0 XML
Bizagi, ADONIS, Visual ParadigmExport as BPMN 2.0 XML
Flowable, ActivitiThe process definition .bpmn20.xml or .bpmn file

The menu names in each tool vary by version; look for a BPMN 2.0 or XML export.

Files over 3 MB, draw.io files, DMN decision tables and XML with entity declarations are refused with a reason.

Steps

  1. Export the process from your BPMN tool as BPMN 2.0 XML.
  2. Edit the Confluence page where the process should live, type /bpmn and choose BPMN diagram (Lanemark). The editor opens full screen.
  3. Click Import a file and choose the file.
  4. Look over the diagram. Pools, lanes, events, gateways and subprocesses come in as they were. If the file only had the process logic and no diagram positions, Lanemark lays it out left to right.
  5. Click Check to see whether anything needs fixing, such as a flow that stops without an end event.
  6. Add links if you want them: a Jira work item key or a Confluence page link on any step, in the right panel.
  7. Name the process, write a note such as "Imported from Camunda", and choose Save version 1. Publish the page.

Going back the other way

Open Download above the diagram for BPMN 2.0 XML (.bpmn), SVG or PNG, or Copy XML. Vendor extensions from the original file are written back, and the links you added travel as lanemark:jira and lanemark:page attributes, which other BPMN tools ignore or keep. So a common setup is:

  1. Engineers keep the executable model in Camunda.
  2. A copy lives on the Confluence page next to the written procedure, linked to the Jira work that changes it.
  3. When the model changes, choose Edit, click Import BPMN file with the new file, and save it as a new version; then compare it with the last one in History, which colors added, changed and moved steps.

After importing

  • Version notes: each save asks what changed, so the History list reads like a changelog.
  • Model check: the same check runs on every version and shows in the History list.
  • The space's process list: add Process landscape (Lanemark) to any page to list every Lanemark diagram in the space with its version, last change, Jira progress and check findings.

Lanemark starts with Atlassian's 30-day free trial; prices are on the Lanemark page.

What it costs

Lanemark is From $11 a month for up to 10 users. Every plan and the install link are on the Lanemark page.

Lanemark: BPMN Process Modeler for Confluence

Model BPMN 2.0 processes on Confluence pages, link each step to Jira, and see exactly what changed between versions. From $11 a month for up to 10 users.


Questions

Does importing change my BPMN file?

No. The import reads it. Downloading gives BPMN 2.0 XML with the original vendor extensions kept, plus any Lanemark links you added.

Can I import a draw.io or Visio diagram?

No. Lanemark reads BPMN 2.0 XML only; draw.io files are refused with a reason.

Can I import a new version of a diagram that's already on the page?

Yes. Choose Edit above the diagram and click Import BPMN file in the editor's toolbar. Saving makes it a new version, and you can compare it with the one before.

Will Camunda still run the file after I download it from Confluence?

The download is BPMN 2.0 XML with the camunda: attributes from your import kept. Check it in Camunda Modeler before deploying, as you would any change.


More Lanemark guides


More Confluence guides