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:
| Tool | How to get the file |
|---|---|
| Camunda Modeler (desktop) | The .bpmn file you save |
| Camunda 8 web modeler | Download the diagram as BPMN |
| SAP Signavio | Export as BPMN 2.0 XML |
| Bizagi, ADONIS, Visual Paradigm | Export as BPMN 2.0 XML |
| Flowable, Activiti | The 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
- Export the process from your BPMN tool as BPMN 2.0 XML.
- Edit the Confluence page where the process should live, type
/bpmnand choose BPMN diagram (Lanemark). The editor opens full screen. - Click Import a file and choose the file.
- 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.
- Click Check to see whether anything needs fixing, such as a flow that stops without an end event.
- Add links if you want them: a Jira work item key or a Confluence page link on any step, in the right panel.
- 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:
- Engineers keep the executable model in Camunda.
- A copy lives on the Confluence page next to the written procedure, linked to the Jira work that changes it.
- 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.