gianjl / camunda-angular

Camunda - Angular Tasklist App

The original source of this project can be found here: https://camunda.com/blog/2018/02/custom-tasklist-examples/.

In this version, customizations have been made and features have been added. This project shows how one can use Angular with the standard Camunda REST API. It is an example implementation of how one could build a Tasklist for Camunda using Front End technology only.

The Task Forms are defined within this application and not on the Server-Side to make it very easy to use.

This project was generated with Angular CLI version 1.6.7.

Example

Within this project you can find some example task forms that were defined for an example process. The example processes can be found in the folder examples/myprocess. The forms can be found in src/components/forms/.

How to use

This project can be seen as an example implementation or as a starting point for your custom Tasklist. It offers also examples for the Camunda API usage.

How to run the example process

1. Prerequisite: Install NPM or Yarn
2. run npm install or run yarn install
3. run npm run start or yarn start
4. Start the Camunda Engine (standard distribution with REST-API at localhost:8080/engine-rest)
5. Open Browser (e.g. Chrome) on localhost:4200
6. Deploy the example BPMN Process given in examples/myprocess using the example Tasklist
7. Start Instance & fill in forms
8. Click on Tasklist and complete tasks

How to customize this example

This application can start all BPMN process that are deployed on the process engine via the rest API. You have to make sure that your UserTasks within the BPMN files are configured correctly, so that the forms are displayed in the Tasklist. Within the src/components/forms folder you have to create a new folder for every new BPMN Process and name it with the PROCESS_DEFINITION_KEY of your process. Then you need to place js forms (similar to the once in the myprocess folder) in this new folder. The name of each file has to be used as the FORM_KEY for your UserTask.

---

Limitations

1. So far this application only supports very basic variables like String & Integer & Boolean. The application will check automatically if variables for defined fields already exist within the process instance in camunda.
2. So far now Tests were written...