BPM Error Handling Best Practice

Creating Business Processes using a BPM (in my case Bonitasoft BPM) we had the problem to handle failures in the right way. In the first time we tried to catch all errors and handled them with a End/Terminate-Entity. Looking backward it was a odd way to process the exception states.

The focus should be by maintenance and at most by the customers using the system. Customers don't want to reinitialize a process every time an error occurred. The want to maintainer to fixe it and let the process flow. Maintainer don't want to have much work with processes running.
I should show two very common scenarios happen in the real life:
  1. All processes are based on tasks using operations working over the network. Maybe sending mails using a database etc. A lost of network connection (maybe only a segment) will cause a lot of tasks to fail and trigger the error handling.
  2. User is creating a process instance inserting data that's simply wrong. But the data can only be validated later in the flow. For example a wrong customer or contract id.
The first case shows a technical problem. It should be fixed by the administrators and then the processes should be restarted and do the work. It's a technical failure.

The second case shows a professional problem. We have the wrong information from the user. A task will fail and could not be done, even if it will be retried. In this case a task error handler trail must be followed. And important: There could occur different incidents.

To implement this concept we changed the definition of automatic tasks with connectors. A connector should throw an exception if something technical went wrong. This exception should the task force to change status to 'failed'. In this case we can retry the task if the technical problem is solved.

Next we check the return values of the connector. If something professional went wrong the returned data should contain such a information, like "returncode=-5" or empty values "customerId=". Small post processor scripts can check the data and fire errors handlers to  jump into another part of the process.

The following example shows the behavior. I used a manual task to insert the 'returned data'
Bonita_BPM
and validate it with post processors
Bonita_BPM_Error_post
The processors are very simple, e.g 'checkStatusNo':
if (status.equals("no"))
  throw new Exception("status is no");
The 'checkStatusError' script will change the status of the task to 'failed'. It's the situation of a technical failure.

In this way processes are more robust, customers are more happy and visual representation is more clear. It's a win-win situation ;-)

Download the sample process.

Comments

Popular posts from this blog

Sonatype Nexus fails with random "peer not authenticated" errors behind ingress

Creating a flux sync configuration referring a config map for substitution

[mhus lib] Reorg in generation 7 nearly finished