Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Configuring SOAP fault messages

Updated on April 6, 2022

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).

Note: 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.
What to do next: 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.
  • Previous topic Configuring the response for a SOAP connector
  • Next topic Configuring advanced details for a SOAP Connector

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us