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

How about downloading a newer, supported version?

Administrator Process list in Bonita Portal

This page explains what a user with the Administrator or Process Manager profile in Bonita Portal can see and do about processes.

Those users can: install, enable and edit processes, categories, forms, entities mapped to actors and process manager, parameters, and connectors.

Here is a view of the Process list page:

Process list in Administrator Application

Install a new process

This feature is only available for the Administrator profile.

  1. Go to BPM > Processes

  2. Click on the Install button on the top left of the page

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

  4. Click on Install

The .bar file is ready to be resolved and/or enabled.

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.

Resolve a process

Resolving a process means completing the configuration in Bonita 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.

  • Actors: 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.

  • Connectors: Every connector definition in a process must have a corresponding implementation (Class name).

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

  • Also, every business variable used in the process should have a corresponding model.

To resolve a process for actors, parameters, connectors, and forms:

  1. Go to BPM>Processes (Administrators) or Processes (Process Managers),

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

  3. Click on More button.

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

  5. Modify your configuration for each element displayed.

To resolve a process for business variables:

  1. Logout

  2. Login with the technical user credentials

  3. Pause the BPM services

  4. Update the BDM

  5. Come back to BPM/Processes and check the status.

Enable a process

  1. Go to BPM>Processes (Administrators) or Processes (Process Managers)

  2. Click on the Resolved filter

  3. Select the process

  4. Click on the More button

  5. Click on the Enable button

  6. The activation state changes to "enabled"

  7. 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 on the ENABLE button in the bulk actions section, at the top of the list.

Disable a process

Disabling a process blocks the creation of new cases. This does not impact existing cases, where tasks can still be executed.

  1. Go to BPM>Processes (Administrators) or Processes (Process Managers)

  2. Click on the Enabled filter

  3. Select the process

  4. Click on the Disable button

  5. The activation state changes to "disabled"

  6. 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 on the Disable 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. Proceed at your own risk.

  1. Go to BPM>Processes (Administrators) or Processes (Process Managers),

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

  3. Click on the Delete button

  4. After making sure that the deletion is safe, click on the Delete button in the confirmation modal window

You can also delete the process in the More details view of a disabled process by clicking on the Delete button, then click on the Delete button to confirm in the modal window.

Create a category for a process

  1. Go to BPM>Processes (Administrators) or Processes (Process Managers),

  2. Select a process in the list

  3. Click on the More button

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

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

  6. Click on the Save button.

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

Add a category to a process

  1. Go to BPM>Processes (Administrators) or Processes (Process Managers)

  2. Select a process in the list

  3. Click on the More button

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

  5. In the opened modal window, start typing the category name, and then select among the suggestions by using the arrow keys or mouse.

  6. Press the Enter key

  7. Click on the Save button

Start a case for another user

This feature is available with the Enterprise, Performance, and Efficiency editions.
To start a case for another user:

  1. Go to BPM>Processes (Administrators) or Processes (Process Managers)

  2. Select the process and click on the Start for button.

  3. In the popup, specify the user for whom you are starting the case. Only valid users for the case are displayed.

  4. Click on Start.

The case is started as though the specified user had started it. For example, if a you start a case for user A and a subsequent task is to be done by the manager of the user, it is assigned to user A’s manager, not to your manager.

All of what follows belong to the Live update feature and are only available in for the Enterprise, Performance, and Efficiency editions.

Edit the actor mapping

You need to map organization entities to an actor. To do so:

  1. Go to BPM>Processes (Administrators) or Processes (Process Managers)

  2. Select a process in the list.

  3. Click on the More button.

  4. Click on Actors in the left menu.

To add entities:

  1. Click the + button in the user, group, role or membership column of the actor line.

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

To remove entities:

  1. In the opened modal window, there is a list of the entities already mapped with the actor. Click on the X button next to an entity, or click on Remove all. A list appears filled with the entities you are about to remove. You can undo a removal by clicking on the X button next to the entity or by clicking Enable all

  2. Click on the Apply button.

Only the first 200 actors are displayed in the dropdown.

Define one or more Process managers

There are two stages to define a Process Manager:

  1. Map organization entities to access the Process Manager Portal to view information related to the processes they will be Process Managers of. Only Administrators can do so.

    1. Go to Organization/Profiles

    2. Choose the Process manager profile. This will display the users, groups, roles, and memberships who already have this profile.

    3. Click on More…​.

    4. Click on Add a user.

    5. Select a user by checking the box next to the user name.

    6. Click on Add. The Process manager profile is now assigned to the user. You can also assign a profile to a group, role, or membership.

  2. Map the process to one or several entities that have the Process Manager profile.

    1. Go to BPM>Processes (Administrators) or Processes (Process Managers)

    2. Select the process

    3. Click on More…​. The Process managers currently assigned to the process are shown in the Process manager mapping table.

    4. To add a user, click the Plus sign or Pencil button in the User column. A popup shows a list of the users who are currently process managers for this process.

    5. Click Select users. A list of users is displayed.

    6. Select the user you want to be a Process manager for the process, and click on Apply. The selected user is added as a Process manager for the process. You can also assign a process to a group, role, or memberships.

Modify a parameter

  1. Go to BPM> Processes

  2. Select a process

  3. Click on the More button

  4. Click on Parameters in the left menu

  5. In the Value column, click on the value you want to edit. A field appears.

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

Edit a connector implementation

  1. Go to BPM>Processes

  2. Click on the More button

  3. Click on Connectors in the left menu

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

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

  6. Click on Save to import the new implementation.

Upload a new form

  1. Go to BPM>Processes

  2. Click on the More button

  3. Click on Forms in the left menu

  4. Click on the Form list tab. A list of form is displayed. These forms are only visible to the current process.

  5. Click the plus button at the bottom of the list. A file selector popup is displayed.

  6. Browse to a .zip containing a form.

  7. Click on Next, then if your form requires some authorization, it will be displayed.

  8. Click on Confirm.

Edit an existing form

  1. Go to BPM>Processes

  2. Click on the More button

  3. Click on Forms in the left menu

  4. Click on the Form list tab. A list of forms is displayed. These forms are only visible to the current process.

  5. Click the Pencil button of a form line. A file selector popup is displayed.

  6. Browse to a .zip containing a form

  7. Click Next, then if your form requires some authorization, it will be displayed.

  8. Click on Confirm.

Change the instantiation or tasks forms or the overview page

  1. Go to BPM>Processes

  2. Click on the More button

  3. Click on Forms in the left menu.

  4. The tables are displayed which list available forms. Click on a red link. A field input appears.

  5. 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.

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

You can also upload a new form in order to create a new form mapping (see the above section Upload a new form).

Edit a script content

  1. Go to BPM>Processes

  2. Click on the More button

  3. Click on Scripts in the left menu. A script content tree is displayed.

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

  5. Click on the Pencil button next to a script name. A popup window is displayed

  6. Edit your script content

  7. Click on Save