BPMN Layout Generators

⚠️ THIS IS AN EXPERIMENTAL PROJECT ⚠️

Tools for generating the graphical layout of the BPMN process (BPMNDI Graphical Model) in BPMN files. They can be used with diagrams containing only the BPMN Semantic part or to replace the existing BPMNDI part.

Implementations

Note

The implementations are based or partially based on https://www.researchgate.net/publication/221542866_A_Simple_Algorithm_for_Automatic_Layout_of_BPMN_Processes

Available implementations:

• java
• R This is only a wrapper of the java library

Existing alternatives

Java

• https://github.com/camunda-consulting/code/tree/382f1521a4e9cd6bb92c2f9eacbe64a0e3835242/snippets/bpmndi-generator (latest available commit on 2020-04-08)
• https://github.com/camunda-consulting/migrate-to-camunda-tools/: tools to migrate from several vendors to Camunda, adaptation of the bpmndi-generator
• Camunda fluent builder API: https://docs.camunda.org/manual/7.9/user-guide/model-api/bpmn-model-api/fluent-builder-api/#generation-of-diagram-interchange

Javascript

• https://github.com/bpmn-io/bpmn-auto-layout/

🚀 Release how-to

Important

Follow the paragraphs in the order in which they are documented.

Preparation

Decide on the value of the new version to be released

Note

The versioning follows semver (be aware of the rules for 0.x.y versions).

Go to the page of the last release to know what the latest version was.

Check for changes since the release of the last version:

Check the commit list to determine the type of version to release (major, minor or patch) based on changes and the value of the previous version (follow semver rules):

The version you've just determined should follow the form x.y.z, so keep this in mind for future tasks.

Prepare the release notes

The GitHub release will include an auto-generated release notes which is based on the labels of the merged Pull Requests.

Ensure that all merged PR included in the release are labelled. You can find the unlabeled PR to easily labeled them.

Perform the release

When all updates have been completed, you are ready to publish a new release.

Go to the release workflow in GitHub Actions and run it by choosing the version to release.

This workflow:

• Creates a Git tag
• Triggers the creation of the release branch of the R package
• Triggers the creation of a draft GitHub release

Publish the release notes

The release workflow has initiated a new draft GitHub release, which needs to be updated and published :

• For more details about GitHub release, follow the GitHub help:
• The release notes has been automatically generated. Review and adjust it if necessary.
• Publish the GitHub release

License

bpmn-layout-generators is released under the Apache 2.0 license.
Copyright © 2020-present, Bonitasoft S.A.