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.

Administrator Case list

This page explains what a user with the _Administrator_ profile in Bonita Administrator Application can see and do about cases (the process instances).

Those users can view a list of open or archived cases, as well as cases with failures, access the case details and overview, the pending tasks for this case, the process definition of this case, and write a comment in open cases.

Starting with Bonita 2022.2, bpmn-visualization library of Bonita’s Process Analytics project has been integrated in process and case visualization diagram.

Here is a view of the page: Admin Case list

View the status of cases

To view the open or archived cases, go to BPM>Cases. The case table is displayed, showing the open cases. To switch between Open cases and Archived cases cases, use the tabs.

To open the case details page, click on a case id or the Ellipsis icon, or to open the process details page, click on the process name. You can change the view to see only the information that you need:

  • View the cases of a specified process, by selecting the process name, or name and version, from the dropdown lists.

  • Search keys are also available as additional columns. In this way, you can use search keys for adding business information to your cases. It is also possible to search on search keys values.

  • Filter the cases by state, by choosing "With failures" or "All" from the State dropdown list. The Failed tasks column shows the number of failed tasks. A connector failure at a task is counted as a task failure.
    Connector failures on case start or end are shown by an exclamation point (!).

  • Add or remove a column in the table, by selecting or deselecting it in the Columns menu.

  • Change the column order, by vertically dragging and dropping the column name in the Columns menu.

  • Sort the table in ascending or descending order of one of the columns, by clicking arrow beside the column header.

If the table is already sorted by the column you select, the first click reverses the sort order.
If the table is currently sorted by some other column, clicking the header sorts by this column in ascending order. You can then click on the arrow to reverse the sort order.

These changes to the view are stored in your browser Local Storage: If you navigate away from the page then go back, the view will be as you configured it.
If you reload the page, or close and reopen the same browser, your stored changes will be reapplied.
If you want to go back to the default view settings, clear your browser cache and local storage.

From this table, you can delete a case or several cases. Select the cases you want to delete, and click on Delete. Confirm in the popup that you want to delete the selected cases.

If you are using the Enterprise, Performance or Efficiency edition, you can also open the diagram of a case (case visualization), by clicking on the Picture icon for the case.
On the diagram, colored flags on the steps show the number of step instances in each state.
Put your mouse hover any step to see an explanation of the display.
Zoom in the diagram with either Ctrl+mouse wheel or the zoom buttons. If you are using a Mac with a Magic Mouse, prefer the zoom buttons.
Once zoomed in, you can drag the diagram.
Resize your browser window and click on the Reset button to fit the diagram to your window.

Remember that a failure at a step does not necessarily mean that the case has failed entirely, but it might indicate that some action is needed, perhaps to replay a connector.

You can customize the diagram page, or embed the BPMN diagram in your own page: see How to customize the display of process execution monitoring.

  • If a process was deployed from a .bar file created in Bonita Studio 6.3 or earlier, the diagram display is not available. This is because some details of the .bar structure have changed. To see the diagram for such a process, export the process definition from Bonita Studio 6.3 as a .bos file, import it into Bonita Studio 6.4 or later, generate a new .bar file, and deploy it.

  • In the process and case diagram of Bonita 2022.2, you may notice the highlight is missing. This, and other values are under development and will be delivered soon.

Add a comment to a case

  1. Go to BPM>Cases

  2. Click a Case id or tyhe Ellipsis icon.

  3. Enter a comment in the Comment field.

  4. Click on Add comment