This content is dedicated to our next version. It is work in progress: its content will evolve until the new version is released. Before that time, it cannot be considered as official.

Forms development

A form is the User Interface attached to a process. It can be a process instantiation form, a human task form, or a case overview form.

There are some extra things to consider when creating a form compared with a page, namely how data is passed between the process instance and the form.

Form sources

Starting with Bonita 7.X, you are recommended to use Bonita UI Designer to create forms for Bonita processes.
Bonita UI Designer forms enable you to take full advantage of the separation between the process definition and the UI definition, by using contracts.

You can also use external forms referenced by URL. If an external URL is being used, the information submitted to the Engine by the form must fulfill the contract. You can store external forms wherever you want as long as they are accessible by URL.

For certain cases, you can specify that there is no form. This is required for a process that is instantiated programmatically (by a call activity or by an API call from an application, for example), or for a process or a task that does not have any contract input.
A human task with no form and no contract represents a manual task completed outside Bonita. The user will indicate in the application that the manual task is complete. A process or a human task with a contract but no form expects the information needed to fulfill the contract to be provided programmatically.

Bonita 7.8 does not support 6.x GWT forms and case overview pages, neither for design nor at runtime. To migrate your processes still using them, follow those instructions

Form types

A context is the set of data provided by the process instance or task instance to the form. There is no context for a process instantiation form.

A contract is the definition of that data that the form returns to the process instance. There is no contract for an overview form.

Testing and debugging

During process development, some temporary forms are generated if necessary when you run a process from Bonita Studio, for process instantiation, for human task execution, and for the case overview. These forms are generated if the "UI Designer" option is chosen but no form is specified in the process definition. The process instantiation and step execution temporary forms are based on the relevant contract and they are a useful tool for testing and debugging your application.

Case overview

The case overview contains three main sections:

  • List of business data: the content of the business variables used by the case

  • List of documents: the content of each document used by the case

  • Timeline: information in chronological order about all the actions that have been performed in the selected case