News from the project

Drill Down into Collapsed Sub-Processes

Published by Martin Stamm on Friday, 25 February 2022.


We are excited to announce bpmn-js@9. The release adds the ability to model and drill down into collapsed sub-processes. That simplifies working with collapsed sub-processes and should give you a convenient way to hide complexity in your BPMN diagrams.

Collapsed Sub-Process Modeling, Improved

Expanding and collapsing sub-processes in place is not enough. To work with them conveniently in more complex BPMN diagrams, you want to inspect and change their contents without touching the parent element. This bpmn-js release allows you to do precisely that: Drill into a collapsed sub-process to examine and change it. Navigate back up with simple breadcrumb navigation.

Model collapsed subprocesses and drill into it to change the content.

Changes Under the Hood

bpmn-js is meant to be embedded into your application. You need to be aware of a few changes when upgrading from an earlier version of bpmn-js. Most notably, make sure to include the new style sheet bpmn-js.css, either from unpkg or from npm.

The canvas API in diagram-js also became a major overhaul and now supports multiple root elements at once. The deep linking example shows you how you can use the new root element APIs.

Check out the full changelog of bpmn-js and diagram-js for all breaking changes that may require your action during the upgrade.

Wrapping up

Did we miss anything? Did you spot a bug, or would you like to suggest an improvement? Reach out to us via our forums, toot us on Mastodon or file an issue you found in the bpmn-js issue tracker.

Get the latest BPMN modeling toolkit pre-packaged or as source code via npm or unpkg.

Are you passionate about JavaScript, modeling, and the web?
Join Camunda and build modeling tools people heart.