jkuester:autoform-bpmn

v0.1.5Published 6 years ago

This package has not had recent updates. Please investigate it's current state before committing to using it in your project.

About

This packages wraps the bpmn-js modeler and bpmn-jsproperties-panel into an "out-of-the-box extension" for aldeed:autoform. "Out-of-the-box extension" means, that it saves the modeled bpmn xml as xml-string into the specified field without any initial configuration required. The modeler allows you to set the camunda moddle options, so that your autoform lets you create camunda compatible bpmn process definitions.

Changelog

0.1.5

  • use NavigatedViewer instead of Modeler when form is disabled
  • use blobs for downloading exported diagram
  • trigger diagram export not on commandstack.changed but on button click

0.1.4

  • removed save button and update data model on commandstack.changed event
  • added file import
  • added svg export
  • extracted utils and added tests
  • added install.sh script

0.1.3

  • moved button bar out of canvas
  • added code coverage to tests

Demo

There is a minimal DEMO project that shows this extension in use. You can clone it and just run it as a Meteor app.

Requirements

This package requires Meteor 1.6 or higher and is currently built against with AutoForm 6.2.0

Install

Note: Before you install you should read one the AutoForm installation guide.

As this packages comes with fixed dependencies (very important for a stable release) you just need to add it as a meteor package:

meteor add jkuester:autoform-bpmn

Define a field as autoform type `in Schema.

1import SimpleSchema from 'simpl-schema';
2
3const bpmnSchema = new SimpleSchema({
4    data: {
5        autoform: {
6            type:'bpmn',
7        }
8    }
9})

That's it. When you load your form you should be able to start modeling immediately.

Updating the model

Currently your model is updated on click of event of the save button. So keep in mind when modeling to click save from time to time. Clicking the modeler's save button will only update the bpmn xml value to the field and not trigger any AutoForm submit!

In the future there will be an autosave on commandStack.change which is basically any registered change.

Dependencies

Currently it uses the following versions:

1'bpmn-js':                  '0.27.6',
2'bpmn-js-properties-panel': '0.22.1',
3'camunda-bpmn-moddle':      '2.0.0',
4'diagram-js':               '0.28.2',

Why using fixed Npm dependencies?

Wiring up the modeler, properties-panel with all the relevant .less files is a real hassle and not trivial at all. To comfort you as user this is all now wrapped up and you don't need to install the bpmn-js related packages besides.

License

MIT License