Handle Task BPMN Error
Reports a business error in the context of a running task by id. The error code must be specified to identify the BPMN error handler. See the documentation for Reporting Bpmn Error in User Tasks.
Method
POST /task/{id}/bpmnError
Parameters
Path Parameters
Name | Description |
---|---|
id | The id of the task a BPMN error is reported for. |
Request Body
A JSON object with the following properties:
Name | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
errorCode | An error code that indicates the predefined error. It is used to identify the BPMN error handler. | ||||||||
errorMessage | An error message that describes the error. | ||||||||
variables | A JSON object containing the variables which will be passed to the execution. Each key corresponds to a variable name and each value to a variable value. A variable value is a JSON object with the following properties:
|
Result
This method returns no content.
Response Codes
Code | Media type | Description |
---|---|---|
204 | Request successful. | |
403 | application/json | If the authenticated user is unauthorized to update the process instance. See the Introduction for the error response format. |
404 | application/json | Returned if the task does not exist or errorCode is not presented in the request. See the Introduction for the error response format. |
Example
Request
POST /task/aTaskId/bpmnError
Request Body:
{
"errorCode": "bpmn-error-543",
"errorMessage": "anErrorMessage",
"variables": {
"aVariable" : {
"value" : "aStringValue",
"type": "String"
},
"anotherVariable" : {
"value" : true,
"type": "Boolean"
}
}
}
Response
Status 204. No content.