ActiveVOS Designer User’s Guide

Previous | Next

Adding a Fault Handler for a Scope

You can add multiple catch handlers and one catch all handler for each scope in your process.

For explanations of these handlers, see Defining Catch and CatchAll Fault Handlers and Catching Undeclared and SOAP Faults.

To add a catch handler to a scope:

1. Select a scope container on the Process Activities tab of the Process Editor canvas.
2. Drag an Error catch event into the scope or near the border of a collapsed scope, as the illustration shows.



3. In the Properties view, select the following optional values:
1. Select the Catch All Faults checkbox and leave the other properties blank.
2. Fault Name. See Selecting a Fault Name for details. For a discussion on whether or not to add a fault name, see Fault Handling Processing Rules and Rules for Catching Faults in a Catch Activity.
3. Fault Variable. Type in name for the variable described by the variable definition. For a discussion on whether or not to add a fault variable, see Fault Handling Processing Rules and Rules for Catching Faults in a Catch Activity. If you have selected a Fault Name, the fault variables drop-down list displays only compatible variables.
4. Variable Definition. Select the Dialog (...) Button at the end of the row to open the Variable Definition dialog. See Adding a Fault Variable Definition for details. For a discussion on whether or not to add a fault variable, see Fault Handling Processing Rules and Rules for Catching Faults in a Catch Activity.
4. Drag an activity into the catch handler, such as a reply. For a boundary event, you must link the handler to an activity to execute. The activity must be an activity that has not yet executed.

Note: If you are using a boundary event, you cannot use certain activities. See Catch and Catch All Boundary Events and Compensate, Compensate Scope and Rethrow.

5. Fill in the properties for the activity to handle the fault.

To add the catch all handler for a scope:

1. Select a scope on the Process Activities tab of the Process Editor canvas.
2. Drag an Error catch event into the scope or near its border.
3. In the Properties view, select the Catch All Faults checkbox.
4. Drag an activity into the catch all handler, such as an assign or compensate.

Note: If you are using a boundary event, you cannot use certain activities. See Catch and Catch All Boundary Events and Compensate, Compensate Scope and Rethrow.

5. Fill in the properties for the activity to handle the fault.

The following illustration shows an example of Catch All fault handler added for a scope.

Tip: If you collapse the fault handler, you can add a background color from the Properties view. Right-mouse-click the handler and select Collapse Container.

Copyright (c) 2004-2011 Active Endpoints, Inc.