LinkedIn
Copied!

Table of Contents

Configuring SOAP fault messages

As a best practice, use the optional Faults tab to map any SOAP faults returned by the Web service. By configuring fault messages, you can include an error-handling steps in the connector activity and have the activity respond appropriately if the connector receives a SOAP fault instead of the response message that it expects.

For information about SOAP faults, including a list of SOAP fault codes, see the SOAP specifications at the World Wide Web Consortium (W3C).

To capture exceptions triggered by the Connect-SOAP method, configure the error handling fields on the Service tab. For more information, see Configuring the connection for a Connect SOAP rule.
  1. In the navigation pane of Dev Studio, click Records.

  2. Expand the Integration-Connectors category, and then click Connect SOAP.

  3. In the list of Connect SOAP instances, select the instance for which you want to configure fault messages.

  4. Click the Faults tab.

  5. In the SOAP envelope content section, in the Target property field, select or enter the name of a single-value text property to store the entire contents of the SOAP envelope that contains the fault message.

    To create a new property, enter its name and click the Open icon to open the New property form. For more information, see Properties.
  6. In the Fault message fields section, configure the fault properties to store the values returned in the response.

    1. In the Fault code property field, select or enter the name of a single-value text property to store the value of the fault code returned in the response.

    2. In the Reason property field, select or enter the name of a single-value text property to store the value of the fault reason string returned in the response.

      The fault reason string holds an explanation of the fault code.
    3. In the Detail property field, select or enter the name of a single-value text property to store the value of the fault detail string returned in the response.

      The fault detail string holds application-specific information about the fault.
  7. Click Save.

Change which version of Axis or SOAP is used, to associate a compensating action with the connector, to specify the data transforms that define the schema, and to enable Web Service Security for the connector. For more information, see Configuring advanced details for a SOAP Connector.

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.