Back Forward Connect MSMQ form
Completing the Response tab

About Connect MSMQ rules

Complete the optional Response tab to specify the data read at runtime from the incoming response message. Define how Process Commander maps the data from fields in the message header or parameter values in the message body to the clipboard.

A response message must not exceed 1 megabyte.

Response Headers

Field

Description

Field

Read Only: Only two message fields are supported by the Connect-MSMQ method:

  • Label — Message label.
  • ID — Message ID.
Description

Read Only: The description of the Field value.

Map To

SmartPromptSelect Clipboard to indicate that the system maps the data value from the scalar property specified in the Map To Key field to the clipboard.

Map To Key

SmartPromptEnter the property name to which the data is mapped.

Response Message Data

Field

Description

Description

Enter a text description of this data mapping.

Map To

SmartPromptSelect how the system processes response values, which are strings. The choice you make for this field depends on your needs:

  • Clipboard — The system maps the data value to the property specified by the Map To Key value.
  • XML ParseRule — Indicates that the incoming data value from the sending application is an XML document to be parsed using the data mappings specified in a Parse XML rule.
  • HTML PostData — Indicates that the incoming data value from the sending application is a stream of data posted from an HTML form that contains property key/value pairs.

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

SmartPromptIdentify a destination for the Map To operation:

  • If you selected Clipboard, enter the property to which data is mapped.
  • If the Map To value is 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 from the Element Name 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.

    OldTo maintain backward compatibility for connector rules created in releases before V5.2, you can specify a data mapping with only a Namespace value. In that case, the system at runtime determines the Element Name key from the root element of the incoming XML document. However, this mapping works only if the Parser Type of the XML parse rule is set to DOM and validation is not enabled. As a best practice, specify both the Namespace Name and the Element Name of the rule.
  • If the Map To value is HTML PostData, leave this field blank. The name/value pairs in the string will be mapped to the parameter page of the service activity rather than the primary page.
  • If the Map To value is 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.

zzz About Connect MSMQ rules