Connect JMS form – Completing the Response tab

If the JMS connector uses the Point-to-Point scenario, use the Response tab to specify the data read at runtime from the incoming response message. Define how Pega Platform maps the data from fields in the message header or parameter values in the message body to the clipboard.

If the JMS connector uses the Publish-Subscribe scenario, no responses are expected. Leave this tab blank.

Field Description
Message Data  
Data Type Select the external Java data type of the response parameter: String, Boolean, Byte, Bytes, Character, or JavaObject.
Message Key Enter the external name of a response parameter.
Description Optional. Enter a brief text description for this parameter.
Map To Select how the system creates response parameter values. The choice you make for this field depends on what you select for Data Type:
  • Clipboard — The system maps the data value to the property specified by the Map To Key.
  • XML ParseRule — The system applies a Parse XML rule to obtain the value.

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 Identify a destination for the Map To operation:
  • If you selected Clipboard, enter the property name 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 Parse XML 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.
  • Note: To maintain backward compatibility for connector rules created in releases before PRPC Version 5.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 Parse XML 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 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.