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

How about downloading a newer, supported version?

Bonita Processes administration

Users with the Administrator profile can: install, enable and edit processes as well as categories, forms, entities, parameters, connectors

Logged on as an Administrator, you have the rights to manage a process as follows.

Install a new process

  1. Go to the BPM tab

  2. Click Processes

  3. Click *Install new process*

  4. Click to browse to the .bar file to import

  5. Click Install

The .bar file is ready to be resolved and enabled

if you try to install the same process twice, a message is displayed: "Process [yourProcessName] in version [yourProcessVersion] already exists."

You can only install a .bar file that was exported from a Bonita Studio of the same minor (7.x) version as your Bonita Portal and Bonita Engine. If you have a .bar file that was exported from an earlier version of Bonita Studio (7.x-1), it will not work with Bonita Engine.

Export the process definition as a .bos file from your old Bonita Studio, import in into the new Studio, then export it as a .bar. This is necessary for a .bar that has not been deployed.

A process that was developed in an older version of Bonita Studio and is already deployed is migrated automatically when you migrate your platform. However, for future maintenance of the process definition, you are recommended to update all your process bar files to the latest version each time you update your platform.

Watch the "Install a process" video

Resolve a process

Resolving a process means completing the configuration in the Portal and making sure that all dependencies are met. A process has to be resolved before it can be enabled.

To resolve a process, you must complete the configuration of the actor mappings, parameters, forms, and connectors defined for the process. You can also configure other information such as Categories and Scripts, but this is not mandatory for resolving a process.

  • Actor mapping; Every actor in a process must be mapped to at least one user, group, role or membership.

  • Parameters: Every parameter defined in a process must have a value.

  • Connector definitions: Every connector definition in a process must have a corresponding Class name.

  • Business Data Model: Every business data object defined in a process must have a corresponding model.

  • Forms: Every form defined in a process must be mapped to a page or a URL.

To resolve a process:

  1. Go to BPM tab.

  2. Click Processes,

  3. Click on a Process. The Configuration section of the right panel shows whether there are items to be resolved.

  4. Click on More.

  5. A summary of configuration problems is displayed below the process name in a well and warning icons are displayed in the left navigation list.

  6. Modify your configuration for each element displayed.

Enable a process

  1. Go to the BPM menu tab

  2. Click Processes

  3. Click *Resolved filter*

  4. Select the process

  5. Click *More* button

  6. Click Enable

  7. The activation state changes to "enabled"

  8. The process disappears from the disabled filter and is now displayed in the enabled filter

You can also select the processes you want to enable by checking the box in the Resolved list, then click ENABLE button in the bulk actions section

Disable a process

Disabling a process blocks the creation of new cases. This does not impact existing cases.

  1. Go to the BPM tab

  2. Click Processes

  3. Click *Enabled filter*

  4. Select the process

  5. Click Disable

  6. The activation state changes to "disabled"

  7. The process disappears from enabled filter and is located in the disabled filter

You can also disable a process in the more details view, by clicking Enabled toggle button.

Delete a process

A process must be disabled before it can be deleted.

Beware! Data loss risk! Deleting a process will automatically delete all its cases (on-going and archived alike). Thus, the operation may take a long time, and fail if the transaction timeout is not large enough. This feature should only be used on non-production environments. Please proceed at your own risk.

  1. Go to BPM menu tab

  2. Click Processes

  3. Select the process to delete by checking the tickbox next to the process

  4. Click Delete

You can also delete the process in the more details view of a disabled process by clicking DELETE, then click DELETE in the modal window

Create a category for a process

  1. Go to BPM tab

  2. Select a process in the list

  3. Click More

  4. In General, click the pencil next to Categories label

  5. In the opened modal, type a new category name then press Enter key

  6. Click Save

After you created a category and added to the process, you can add other processes to the category.

Add a category to a process

  1. Go to BPM tab

  2. Select a process in the list

  3. Click More

  4. In General, click the pencil next to Categories label

  5. In the opened modal, type a new category name then press Enter key, or use arrow keys to browse among exisiting categories

  6. Click Save

Make start a process available for more users

You need to map more organization entities to the actor labelled initiator in the process definition. To do so:

  1. Go to the BPM tab.

  2. Click Processes.

  3. Select a process in the list.

  4. Click More.

  5. Click Actors in the left navigation.

  6. In the Actors section, click the *+* button in the user, group, role or membership column of the actor line.

  7. In the opened popup, click on the dropdown list to select one or several actors. The list displays the first five elements, then a number is displayed representing the other selected entities.

  8. Click APPLY.

Notice that only the first 200 actors are displayed in the dropdown.

Remove an entity from an actor

  1. Go to the BPM tab.

  2. Click Processes.

  3. Select a process in the list.

  4. Click More.

  5. Click Actors in the left navigation.

  6. In the Actors section, click the pencil button in the user, group, role or membership column of the actor line.

  7. In the opened popup, there is a list of the actors already mapped.

  8. Click the X button next to the actor, or click Remove all.

  9. A list appears filled with the actors you can to remove. You can undo a removal by clicking X button next to the actor or by clicking *Enable all*

  10. Click APPLY.

Modify a parameter in the Administrator profile

In versions 7.0.x, this feature is only available for Bonita Enterprise and Performance editions. Starting from version 7.1.0, this feature is available for Bonita Enterprise, Performance and Efficiency editions.
  1. Go to the BPM tab

  2. Click Processes

  3. Select a process

  4. Click MORE

  5. Click Parameters in the left navigation

  6. In the Value column, click on the value you want to edit

  7. A field appears

  8. Click the Tick button to validate your change or X to dismiss your change.

Edit a connector implementation

In versions 7.0.x, this feature is only available for Bonita Enterprise and Performance editions. Starting from version 7.1.0, this feature is available for Bonita Enterprise, Performance and Efficiency editions.
  1. Go to the BPM tab

  2. Click Processes

  3. Click More button

  4. Click Connectors

  5. In the connector definitions table, in the actions column, click on the Pencil

  6. Browse to a .zip file containing the new connector implementation

  7. Click Save to import the new implementation.

Fix forms

For Bonita Enterprise, Performance and Efficiency editions only.
  1. Go to the BPM tab.

  2. Click Processes.

  3. Click More button.

  4. Click Forms in the left navigation.

  5. The tables are displayed which list available forms. Click on a red link.

  6. A field input appears.

  7. Starting to type some text, and any matching names of installed forms will be proposed. If there is no match for the name you enter, it will be considered as a URL.

  8. Click the Tick button to validate your change or X to dismiss your change.

You can also upload a form in order to create a new mapping.

Upload a new form

For Bonita Enterprise, Performance and Efficiency editions only.
  1. Go to the BPM tab.

  2. Click Processes.

  3. Click More button.

  4. Click Forms in the left navigation.

  5. Click Form list tab.

  6. A list of form is displayed. These forms are only visible to the current process.

  7. Click the plus button at the bottom of the list.

  8. A file selector popup is displayed.

  9. Browse to a .zip containing a form.

  10. Click NEXT, then if your form requires some authorization, it will be displayed.

  11. Click CONFIRM.

Edit an existing form

For Bonita Enterprise, Performance and Efficiency editions only.
  1. Go to the BPM tab.

  2. Click Processes.

  3. Click More button.

  4. Click Forms in the left navigation.

  5. Click Form list tab.

  6. A list of forms is displayed. These forms are only visible to the current process.

  7. Click the pencil button of a form line.

  8. A file selector popup is displayed.

  9. Browse to a .zip containing a form

  10. Click NEXT, then if your form requires some authorization, it will be displayed.

  11. Click CONFIRM.

Edit a script content

For Bonita Enterprise, Performance and Efficiency editions only.
  1. Go to the BPM tab

  2. Click Processes

  3. Click More button

  4. Click Scripts in the left navigation

  5. A script content tree is displayed.

  6. You can search for a script by typing text in the dedicated field

  7. Click the pencil button next to a script name

  8. A popup window is displayed

  9. Edit your script content

  10. Click SAVE