LinkedIn
Copied!

Table of Contents

Configuring the response for a SOAP connector

Use the Response tab to configure the data mapping for the reply from the external Web service.

The data types of the outgoing parameters can be any of the primitive data types that are specified in the W3C XML Schema standard. If you used the Create SOAP Integration wizard to generate the connector rules, and the WSDL file you identified defines its own complex types, the data type for a parameter is XML Literal. XML Literal indicates that the outgoing parameter contains text that is formatted as XML.

  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 the response.

  4. Click the Response tab.

  5. Optional:

    In the SOAP envelope content section, in the Target property field, specify the name of a Single Value text property to hold the entire contents of the SOAP response.

    Use this field when you need to store the original SOAP message with the work item, for example, for an auditing or history purpose.
  6. In the Response headers section, map the data needed from the incoming SOAP envelope header.

    Use this section to map values for SOAP headers in the response.

    The SOAP envelope in the response must contain a namespace. For more information, see the Pega Community article, How to map a SOAP header in the request message of a SOAP connector

    1. In the Name field, enter the external name of the SOAP response header.

    2. In the Description field, enter a text description for the response header.

    3. In the Map to field, choose one of the following options:

      • If the Applies To class of the XML parse rule to process this data is the same as that of the connector rule, select XML Parse Rule.
      • If the Applies To class of the XML parse rule is different from that of the connector rule, click in the field and enter Clipboard.
    4. In the Map to key field, enter the Namespace and Element names (second and third key parts) of the appropriate Parse XML rule, separated by a period.

      The system uses the Applies To key part of this SOAP connector rule as the first key part of the Parse XML rule.
      • If you map to XML Parse Rule, enter the Namespace and Element names (second and third key parts) of the rule separated by a space. The first key part (the Applies To class) is assumed to be that of the connector rule.
      • If you map to the Clipboard, select the property to hold the incoming XML.
    5. To ensure that messages that contain a must understand flag that are set to true do not cause an error, select Disable must understand.

  7. In the Response parameters section, specify how to map the data from the body of the reply message to Pega Platform properties.

    1. In the Data type field, select the data type of the parameter value.

      For details about data types, see Data mapping for SOAP and dotNet connectors.
      • If the SOAP operation style is document-literal or RPC literal, select the XML Literal data type.
      • If the SOAP operation style is RPC encoded, select any other primitive data type.
    2. In the Name field, enter the external name of the parameter.

    3. In the Description field, enter a text description for this parameter.

    4. In the Map to field, specify the destination or type of destination for the value in Pega Platform.

      The choices that appear in the selection list depend on the data type specified in the Data type field.
      • Clipboard – The destination is a property on the clipboard.
      • XML Parse Rule – The incoming data is a stream of XML to be parsed by a Parse XML rule.

      If you see more choices, each identifies a custom function rule in a MapTo library. Review the function rule to determine what it does.

    5. In the Map to key field, specify the key to locating the property or rule in the destination specified in the Map to field:

      • If you map to the Clipboard, enter the name of the property to which to map the data. Click the Open icon to review the property.
      • If you map to XML Parse Rule, enter the Namespace name (second key part) and the Element Name name (third key part) of the appropriate Parse XML rule. Separate the Namespace from the Element Name with a space by using the syntax "NamespaceName ElementName". The system uses the Applies to class of this connector rule as the first key part of the parse rule.
  8. Click Save.

Configure SOAP fault messages on the Faults tab. For more information, see Configuring SOAP fault messages.

Have a question? Get answers now.

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