Back Forward Connect dotNet form
Completing the Response tab

 About Connect dotNet rules

Configure the data mapping for the reply from the external Web service on the Response tab. Use the Response Headers section to map the data needed (if any) from the incoming SOAP envelope header. Use the Response Parameters section to specify how to map the data from the reply to properties.

The data types of the incoming parameters can be any of the primitive data types specified in the W3C XML Schema standard. If you used the Connector and Metadata accelerator to generate the connector rules and the WSDL file you identified defines its own complex types, the data type for a response parameter is set to XML Page. This indicates that the incoming response parameter is an XML object.

SOAP Envelope Content

Field

Description
Target Property

(Optional) Specify the name of a single-value text property to hold the entire contents of the SOAP response. You use this field when you need to store the original SOAP message with the work object, perhaps for an auditing or history purpose.

Response Headers

Use this section to map values for SOAP headers in the response. The data type of a SOAP header is an element (an instance of the W3C DOM object org.w3c.dom.Element) and the contents must be processed by an XML parse rule.

The SOAP envelope in the response must contain a namespace. See also Pega Developer network article PDNPRKB-24061 How to map a SOAP Header in the request message of a SOAP connector.

Field

Description
Name

zzzEnter the external name of the SOAP response header.
Description

Enter a text description.
Map To

XML ParseRule is the only option. Information from a SOAP response header must be mapped to an XML parse rule.
Map To Key

Enter the Namespace and Element names (second and third key parts) to the appropriate XML parse 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 XML parse rule.

Response Parameters

Field

Description
Data Type

zzz SmartPromptSelect the XML schema data type of the parameter value. Select any primitive data type in the W3C XML Schema standard. See How to complete mapping details for SOAP and dotNet connectors for details about data types.

The XML Page data type indicates that the parameter is an XML object with a schema described by the model rule specified on the Advanced tab that this connector rule was generated by the Connector and Metadata accelerator. You cannot use the XML Page data type for a connector rule that you created without using the Connector and Metadata accelerator.

Select the XML Literal data type if the parameter is an XML object and you want to map the actual (literal) XML to an XML parse rule or a single-value text property. In this case, also specify Axis2 on the Advanced tab. For more information, see More about SOAP Connectors.
Name

Enter the external name of the parameter.
Description

Enter a text description.
Map To

SmartPromptSpecify the destination or type of destination for the value. The choices that appear in the selection list are dependent on the data type specified in the Data Type field:

  • Clipboard — The destination is a property on the clipboard.
  • XML ParseRule — The incoming data is a stream of XML to be parsed using the actions defined in a Parse XML rule.
  • Delimited ParseRule — The incoming data is in a delimited format to be processed by a Parse Delimited rule.
  • Structured ParseRule — The incoming data is in a flat file that has a fixed format with fields of fixed length. to be processed by a Parse Structured rule).

If more choices appear, they each identify a custom function rule in a MapTo library. Review the function rule to determine what it does.
Map To Key

SmartPromptSpecify the key to locating the property or rule in the destination specified in Map To field:

Map To

Instructions
Clipboard

Enter the name of the property name to map the data to.
XML Parse Rule

Enter the Namespace name (second key part) and the Element Name name — third key part — of the appropriate XML parse rule. Separate the Namespace value from the Element Name value with a space. That is, use the syntax "NamespaceName ElementName" and not "NamespaceName.ElementName." The system uses the Applies to class of this connector rule as the first key part of the parse rule.

Optionally, if the Parser Type of the rule is set to DOM, you can enter the Namespace Name only. In that case, the system determines the Element Name key at runtime from the root element of the incoming XML document.

However, if validation is enabled in the parse rule, you must provide both key parts of the rule to have the incoming XML be validated. Additionally, if the Parser Type of the rule is set to SAX, provide both key parts to the rule.
Delimited ParseRule

Enter the Namespace and Record type names (second and third key parts) of the appropriate delimited parse rule. The system uses the Applies To class of this connector rule as the first key part of the parse rule.
Structured ParseRule

Enter the Activity Name (second key part) of the appropriate structured parse rule. The system uses the Applies To class of this connector rule as the first key part of the parse rule.
a Rule-Utility-Function from a MapTo library

Either select a property to hold the results of the function or leave this field blank, as appropriate for the function.

Binary Attachments

Field

Description
Extract attachments
from response

Select to specify that the connector is to extract SOAP attachments from the SOAP response message. For more information, see PRKB-25026 How to configure a SOAP or dotNET connector to send or receive SOAP with attachments.

zzz About Connect dotNet rules