RAISEEXCEPTION
Overview
The RAISEEXCEPTION workflow application raises the cancel exceptions on specified actions, as controlled by the action cancellation workflow exception in the conditions definition panel. This workflow application can thus be called by an action to cancel one or several other actions in a running request. The application is converted as an assembly workflow to simplify configuration and improve performance.
The RAISEEXCEPTION web app in IIS and the file system folder (\wfgen\WfApps\WebServices\RaiseException
) can be disabled and removed. Authentication settings at the application level are not required.
RAISEEXCEPTION is useful when one or more actions need to be cancelled after a certain point in the workflow has been reached, even though those actions have already been activated. For example, if three parallel actions are ongoing, but one of the parallel actions is concluded ahead of the others and your workflow rules have determined that the two other actions are no longer required, you can activate RAISEEXCEPTION to cancel the other two actions and allow the workflow to continue.
Additionally, you can:
Use default parameters to cancel all open actions in a specific request.
Use optional parameters to cancel a list of action instantiations in a list of requests or to cancel on behalf of a specific user.
Use additional parameters to define multiple pairs of action references.
Default parameters
The REQUEST_ID
and ACTIVITY_NAME
parameters must always be used together.
Parameter | Type | Direction | Description |
| Numeric | IN | ID of the request where the action will be cancelled |
| Text | IN | Name of the action that will be cancelled |
📌 Example
In this example, the application will cancel all instances of the PENDING_ACTION
action in request 455
:
Optional parameters
The REQUEST_ID_LIST
and ACTIVITY_NAME_LIST
parameters must always be used together.
Parameter | Type | Direction | Description |
| TEXT | IN | List of request IDs where the action will be cancelled |
| TEXT | IN | List of action names that will be cancelled |
| TEXT | IN | Used to set the username used to cancel the action ✏️ Notes:
|
| TEXT | IN | Used to set the password corresponding to the username used to cancel the action |
| Exception that will be triggered on the action Possible values:
| ||
| Used with the |
Examples
In this example, the application will cancel all the instances of the actions PENDING_ACTION1
and PENDING_ACTION2
in each of requests 445
, 446
, and 447
:
In this example, the application will cancel all the instances of the action named PENDING_ACTION
in request 445
on behalf of John Doe (jdoe
):
Additional parameters
Parameter | Type | Direction | Description |
| Numeric | IN | Indicates the ID of the request where the action will be cancelled for the pair specified by the |
| Text | IN | Indicates the name of the action that will be cancelled for the pair specified by the |
| Text | IN | Ignore By default, |
📌 Example
In this example, the application will cancel all instances of the PENDING_ACTION1
action in request 455
and all instantiations of the PENDING_ACTION2
action in request 456
. If actions 455
and 456
have no instance then no error is raised.
Possible execution errors
The following errors can occur during the execution of the transactions:
Error | Cause | Solution |
WorkflowGen Context is empty | All the | Check the |
Application parameters are not correctly entered | The | Check the |
(WorkflowGen Web Exception)
HTTP Status: ...Response error: ... or The | An error occurred while trying to send the HTTP request to WorkflowGen | Check the HTTP status:
Check your authenticating parameters:
Check for indications in the returned error message. |
Error while trying to connect to WorkflowGen database Error message: ... | An error occurred while trying to connect to the WorkflowGen database | Check your connection string in the configuration file. Check for indications in the returned error message |
Parameters: | The user defined by the | Check Identify the request with parameters names returned in the error message. |
Parameters | One of the activity names defined in the | Check the Check for indications in the returned message. |
Parameters | One of the actions to cancel is not open | Check the Check for indications in the returned message. To ignore this error, set |
Last updated