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.

Task list in Bonita Administrator Application

This page explains what a user with the Administrator profile can see and do about tasks (and more generally, flow nodes) in Bonita Administrator Application.
A flow node is an element of a process. It defines an action to be performed (automatic or human). A task is a flownode done by a person.

Those users can view the list of flow nodes in error, pending tasks, done tasks, assign and unassign a task, do a task for someone else, skip a failed flow node, replay a failed flow node, and write a comment about the case.

Here is a view of the task list: Task list Administrator Application

View tasks and flow nodes

Tasks and flow nodes are showns in three tabs: Failed flow nodes, Pending tasks, and Done tasks. In the "Failed flow nodes", as tasks and other automatic elements can fail, we chose to show them all.
When they do not fail, they are usually executing fast and there is no need to show them as there is no action to perform for them.
Also, usually, the follow up of the execution of a case is mostly about human tasks.
To view all flow nodes in a process or case, the "Process details" and "Case details" give access to a graphical view of the BPMN diagram to follow up on the status.
In the "Pending tasks", for each human task, the priority and due date are shown in the list.

Assign a task

A pending or failed task can be assigned and reassigned to another user if necessary.

  1. Go to BPM>Tasks

  2. Click on the Pending tasks tab

  3. In the row of the task, click on the View task details icon

  4. Click on the Assign button

  5. In the popup, start typing the name of the user to assign the task to.

  6. Select the right suggestion

  7. Click on Assign

Unassign a task

  1. Go to BPM>Tasks

  2. Click on the Pending tasks tab

  3. In the row of the task, click on the View task details icon

  4. Click on Unassign

  5. In the confirmation modal window, click on Unassign

Do a task for another user

With the Access, Enterprise, Performance, and Efficiency editions, an Administrator can do a task for another user.
This is useful for unblocking a case if the assigned user cannot perform the task.

  1. Go to BPM>Tasks

  2. Click on the Pending tasks tab

  3. In the row of the task, click on the View task details icon

  4. If the task is not assigned, first assign it to the person who should do the task.

  5. Click on Do for

  6. In the confirmation modal window, click on Do the task

The task is done and traced in the BPM database as though you have done the task "on behalf" of the selected user.

Skip a failed flow node

If a failed flow node does not impact subsequent flow nodes in a process, it can be skipped.
This means that the flow node does not have to be done successfully for the following steps to become available.

  1. Go to BPM>Tasks

  2. In the row of the failed flow node, click on the View task details icon

  3. In "Connectors", one or several connectors show a red "Click here for more details" icon. You can click on the icon to view the stack trace of the issue

  4. Click on the Skip button

  5. In the confirmation modal window, click on "Skip"

The task is moved from "Failed" to "Done", while the connector stays in the "Failed" state.

Error details

This feature is available with the Access, Enterprise, Efficiency or Performance editions.

When a flownode is failed, an additional "Error details" panel displays the information about the exception that caused the failure. When available, the scope and context of the error is attached to the failure to help locating the issue in the process definition. A failure history is also displayed in case of successive failures on replay.

Replay a failed flow node

This feature is available with the Access, Enterprise or the Performance editions.

  1. Go to BPM>Tasks

  2. In the row of the failed flow node, click on the View task details icon

  3. In "Connectors", one or several connectors show a red "Click here for more details" icon. You can click on the icon to view the stack trace of the issue

  4. In order for the result of the replay to be different than a new failure, fix any parameter causing the failure

  5. Come back to the task details, and click on Replay

  6. In the popup window, check the connectors you want to replay, and the ones that can be skipped

  7. Click on Replay

  8. Click on Close

  9. Refresh the flow node details page to view its new state