Skip to content
AngularJS Module for Bonita BPM platform. This module allows you to quickly build business application by providing user management api, authentication api, business process api, ...
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


WARNING: this project is no longer maintained.

Table of Content


AngularJS module for Bonita BPM platform. This module acts as a Bonita REST API client. It allows to quickly build business application by providing user management API, authentication API, business process API, ...


  • this module is not an official extension of Bonita BPM
  • this module is compatible with Bonita BPM 6.0 and onward but some resources may be missing in early Bonita versions



The project binaries are available here


In order to use ngBonita, you will need the following JS dependencies:

  • Angular core 1.3.0 or upper
  • Angular resource module

Build instructions

If you wish to build the project from the sources, follow these instructions:

  1. Make sure you have installed grunt. See this guide for more instructions.
  2. Open a command line at the project root directory
  3. Run "npm install"
  4. Run "grunt build"

Release instructions

A new release should always start with a fresh build :


That will guarantee that the dist folder is up-to-date.

This project use grunt-release for its release process. To release a new version, you simply have to use one of these grunt-release process, depending on the version you want to set :

grunt release
grunt release:minor
grunt release:major

If you're afraid to try it directly, you can see what it will do with a dry run, using one of these :

grunt release --no-write
grunt release:minor --no-write
grunt release:major --no-write


Basic example with authentication

The following example will log in Bonita with user "walter.bates" and will list the process definitions that he has the right to start using the browser's console:

var app = angular.module('appMainModule', ['ngBonita']);

app.config(function (bonitaConfigProvider) {
	// Optional call to override Bonita URL setup

// Application controller
app.controller('AppController', function($scope, $log, bonitaAuthentication, ProcessDefinition){
	// Logs into Bonita as 'walter.bates'
	bonitaAuthentication.login('walter.bates','bpm').then(function() {
		// Lists all process definitions that can be started by current user
		ProcessDefinition.getStartableByCurrentUser().$promise.then(function (processDefinitions) {
			$log.log('Listing '+ processDefinitions.items.length +' process definition(s):');
			for (var i=0; i<processDefinitions.items.length; i++)
				$log.log('  - '+ processDefinitions.items[i].name +' '+ processDefinitions.items[i].version);
			// Logs out of Bonita

Business Data example

The following example will retrieve BDM objects of type using a find query.
Note that the authentication part is ommited in this sample and be sure to add the BusinessData dependency in your controller.

BusinessData.getDataQuery({businessDataType:'', q:'find'}).$promise.then(function (data) {
	$log.log('Listing '+ data.items.length +' Supplier BDM(s):');

Resource documentation

As of latest version, the following resources are available:

  • ArchivedCaseDocument
  • ArchivedHumanTask
  • ArchivedProcessInstance
  • BonitaSession
  • CaseDocument
  • HumanTask
  • ProcessDefinition
  • ProcessInstance
  • User

Starting form ngBonita 1.6 a new BusinessData resource is avalailable to query BDMs.
Each call to this resource requires a mandatory parameter businessDataType with the fully qualified Java class of the BDM object.

You can’t perform that action at this time.