Try OpenEdge Now
skip to main content
Managed Adapters Guide
Web Service Managed Adapter : Fault handling : Fault handling in Adapter Configurator
 

Fault handling in Adapter Configurator

The Web Service Configurator reads the fault descriptions from WSDL and uses the same in configuring the adapter.
The WSDL Detail section (see Reviewinginformation on WSDL details) in the Web Service configurator displays the fault handling information in each of the following tabs:
*Information tab: Displays fault information such as Operation Info, Input Parameters, Return Parameters, and Faults.
*Types and Mapping tab: Click the Java Input and Soap Message Output or Java Input and Output option in this tab to display all the fault types to map to the Java Exception classes. If required, you can change the name of the Exception java class.
For Common Resource projects, you can click Generate classes to generate the classes for this project. If the selected operation has any fault handling defined for it, the corresponding exception classes can be generated. Each of the generated exception class extends the "java.lang.Exception" class.
When generating the classes, you can select if you want helper classes for serialization and deserialization process to be generated.or not. It is not mandatory to generate the helper classes.
*Test tab: This tab now displays the SOAP Fault tab in addition to the SOAP Response tab. The SOAP Response tab is activated if the result of the web service is successful, else the SOAP Fault tab is activated. The SOAP Fault tab displays content only if there is an exception.
The Input section renders the content based on the inputs required for the SOAP service.
*For primitive type input, this section displays a grid with the Java type, parameter name, and editable value as its columns.
*For complex type input, this section displays the SOAP XML in an editable text area, where you can set the values of particular XML elements as input.
The output of the Web service execution is displayed either in the SOAP Response tab or SOAP Fault tab. The content rendered in these tabs follows the same behaviour as in the Input section. As fault types and exception classes are of complex types, the SOAP Fault tab displays the SOAP fault XML in a read-only text area.
You can select the Map Fault Fields checkbox in the SOAP Fault tab to map an XPath expression in the SOAP fault XML to a user-defined parameter. This checkbox is enabled only if you have clicked either the Soap Message as Input and Output or Java Input and Soap Message Output options in the Types and Mapping tab.