Open topic with navigation

Catching unique exceptions

The Adapter for Web Services uses SOAP to invoke and communicate with Web methods on a Web Service. By default, exceptions are communicated through a <Soap:Fault> embedded in a Soap Message Body.

Web services may use return values to communicate exceptions. For example, a Web method may return "True" if the work was completed successfully, or "False", if not. An [Out] parameter may be used in addition to the boolean return value to include details on what happened.

The Web Services adapter enables you to use regular expressions to define the match condition on a parameter that represents an exception. You can define a regular expression to look for the text "False" on the return parameter, and the adapter can log an exception if the return parameter matches the expression.

Note: The Web Services adapter does not roll back any state set by the web service, even if invoking the Web Service is logged as an exception.

You can define a regular expression on the [Out] parameter if you only want to log an exception based on more specific details, such as a regular expression that looks for a specific type of condition and ignores other details.

To set a regular expression as a match condition to test for:

1. In the Scribe Workbench, click View > Connections. The Connection Manager appears.
2. Select the Adapter for Web Services.
3. Click Edit. The Connections Settings dialog box appears.
4. Click the Connection tab.
5. Click Connect. The Adapter for Web Service Connection Information dialog box appears.

   If you are modifying a connection that is not used in a DTS, click Connection.

6. Verify the Web Services connection is selected and click OK. The Web Service Connection Manager dialog box appears.
7. Select the Web Service Name you want to modify and click Edit. The Edit Web Service dialog box appears.
8. Click the Configuration tab.
9. Do one of the following:
   • Import predefined method properties:
     1. Click Import. The Open dialog box appears.
     2. Navigate to the XML file containing the method properties.
     3. Click Open.
   • Define method properties:
     1. Expand Methods in the tree view.
     2. Select the Web method that you want to modify. The selected method expands to display the parameters. Parameter name prefixes indicate the direction of the parameter: [In], [Out], [In Out], or [Return].
     3. Select an Out parameter.
     4. In Properties, select any properties that you want to assign to the selected parameter.
     5. In Value, select the variable that holds the [Out] value.
     6. In Failure Condition, specify any failure conditions to use with this method.
10. Click Save.

See Also

Properties

Samples

TIBCO Scribe® Insight Help Library