kirstenhh / nc-bpm-app

Nextcloud Business Process Management App / BPMN-viewer/editor based in BPMN.IO
GNU Affero General Public License v3.0
7 stars 1 forks source link

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

:heart_eyes: Features

This integration provides the following features:

:rocket: 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/workspace/server/apps-extra

Then run:

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

Note: double-check that the folder is now named files_bpm, otherwise the app won't install in your Nextcloud properly. Then install the dependencies using:

yarn install && composer install

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

yarn build

:gear: 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.

:nerd_face: 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