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

How about downloading a newer, supported version?

Preload the forms cache

The forms cache allow legacy forms (6.x) to be displayed more rapidly. It is possible to preload this cache.

This information applies to legacy forms developed with Bonita 6.x, or with the 6.x Application backward-compatibility features of Bonita 7.0. It is not necessary to preload forms developed with the UI Designer.

The first time a form is displayed, it is cached so that when it is displayed again it loads more quickly. This is the default behavior. However, you can speed up the first display of a form by preloading it into the forms cache.

To preload the forms cache, use the formsCache service, which is accessed over HTTP.

formsCache service



Supported methods

| Method property | Description | | ----------- | -------- | | Action | GET | | URI | formsCache | | Parameters | process=processDefinitionID | | Behavior | Retrieve the list of the IDs of the forms contained in the forms definition file (forms.xml) of the specified process definition | | Response | The list of form IDs (for example ["myProcess—​1.0$entry","myProcess—​1.0—​firstActivity$entry"]) | | Error response codes | 400 if the process parameter is missing, 404 if the process is not found |

Method property Description




formsCache/processDefinitionID/formID (for example: formsCache/12875/myProcess--1.0$entry)




Parse the XML fragment corresponding to the specified form and load the form object into the cache



Error response codes

400 if the process ID or the form ID are missing, 404 if the process or the form are not found (200 if the form was found and cached)

Preload the forms cache

First, send a GET request to retrieve the list of forms in a specified process. Then send a PUT request for each form to load it into the cache. The PUT request can sometimes take several seconds to respond, depending on the complexity of the form.

If you are using the Performance or Efficiency edition, you can create a custom page to preload the forms cache. For the Teamwork or Community edition, you need to create an application.

Forms cache configuration

The forms cache is implemented using EhCache. The cache configuration is defined in $BONITA_HOME/client/platform/conf/cache-config.xml. By default, when you restart the server, the cache is emptied, so forms would have to be loaded again. To keep the cached forms after a restart, set the diskPersistent property to true.