This documentation is about a version that is out of support, here is the latest documentation version.

How about downloading a newer, supported version?

How to implement Adaptive Case Management with Bonita

This page explains how to enable adaptive case management capacity in Bonita.

For Enterprise, Performance, Efficiency, and Teamwork editions only.

Enable ACM Engine Plug-in

The ACM engine plug-in registers an event handler at startup. This handler will be in charge of updating the acm variables of all the active tasks of a case each time a task is completed in this same case. An acm variable is a transient local variable prefixed with the $ sign. In the credit card dispute resolution example there is only one acm variable named $activityState.

By default the event handler is not registered. To enable the event handler you must start the engine with the following argument:
It can be achieved:

  • in Bonita Studio, in the Server settings preferences ( Edit > Preferences > Server settings > Tomcat JVM additional arguments )

  • in a Bundle, using the setup tool, reach for the file (in platform_conf/current/tenants/<TENAND_ID>/tenant_engine folder in server has already been started or platform_conf/initial/tenant_template_engine before the first start of the server) and add this line com.bonitasoft.engine.plugin.acm.REGISTER_ACM_HANDLER=true.


  • Potential performance hit depending on user’s implementations.

  • The Portal Task list and Monitoring become irrelevant with processes using ACM.