Skip to content

Nextcloud Business Process Management App / BPMN-viewer/editor based in BPMN.IO

License

Notifications You must be signed in to change notification settings

Loydl/nc-bpm-app

Repository files navigation

BPMN/DMN Viewer and Editor for Nextcloud

Static analysis PHP Tests Lint Downloads GitHub release

View and edit BPMN 2.0 and DMN 1.3 diagrams in Nextcloud.
This app integrates the BPMN.io editor into Nextcloud.

Screenshot BPMN editor Screenshot DMN editor

😍 Features

This integration provides the following features:

  • Editor Edit BPMN and DMN diagrams on every folder with write permission
  • Viewer View BPMN and DMN diagrams if you have no write permission
  • New diagrams Create new diagrams via the Nextcloud files app

🚀 Install it

The easiest way to install this app is by using the Nextcloud app store. If you like to build from source, please continue reading.

To install it change into your Nextcloud's apps directory:

cd nextcloud/apps

Then run:

git clone https://github.com/Loydl/nc-bpm-app.git files_bpm

Then install the dependencies using:

yarn install && composer install

Last thing you have to do is to build all assets with:

yarn build

⚙️ Configuration

If you like to have previews of your BPM files, please install the BPM preview service on your server (requires root access) and add the corresponding URL to your settings under admin settings > additional settings.

🤓 Release guide

This repo contains some Node scripts to simplify the release process on Linux systems. They require openssl and gpg installed on your system and assume that you have a valid signing key in ~/.nextcloud/certificates/files_bpm.key. Make sure that gpg and git is configured properly to use your default signing key.

  1. bump version in package.json
  2. run node scripts/build-release.js --stable (for nightlies omit --stable)
  3. node scripts/publish-release.js will generate a changelog from your commits, create and sign a release commit, and upload your app to Github and the Nextcloud app store