Connect JMS form – Completing the Request tab

Use the Request tab to specify the contents of the outgoing request message. At runtime, Pega Platform maps the data from the clipboard (or other sources) to fields of the message header, message body, and parameter values.

Message Headers

Field Description
Field Optional. Select a message header field ( JMSCorrelationID or JMSType ).
Description Enter a text description.
Map From Select how the system creates the selected request header value:
  • Clipboard — The system maps the data value from the property specified by the Map From Key.
  • Constant — The system sends a fixed value.

If more choices appear, they identify a custom function rule in a MapFrom library. Review the function rule to determine what it does.

Map From Key If the Map From value is Clipboard, enter a property reference that is the source of the data.

If the Map From value is Constant, enter a literal constant. To include blank spaces in your text string surround the constant with double quotes.

Message Properties

Complete this section to define how Pega Platform is to assemble property values and literal values to form the request message.

Field Description
Data Type Select the external Java data type of the parameter value: String, Integer, Byte, Float, Double, Int, Long, Short, or Boolean.
Name Enter a property reference that is the source of the value.
Description Optional. Enter a short text description of this row of the array.
Map From Select how the system creates request parameter values. The choice you make for this field depends on what you selected for Data Type:
  • Clipboard — The system maps the data value to the scalar property specified by the Map From Key.
  • Constant — The system sends a fixed value.
  • XML Stream — The system composes a stream of XML text, formatted by an XML Stream rule.
  • HTML Stream — The system composes a stream of HTML text, formatted by an HTML rule.

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

Map From Key Enter additional details that complete the Map From mapping:
Clipboard
Enter a property reference that is the source of the data.
Constant
Enter a literal text string. To include blank spaces in your text string, surround the string with double quotes.
XML Stream
Enter a Stream Name key part of the XML Stream rule that is generate the data. The system uses the Primary Page Class of the service as the Applies To key part.
HTML Stream
Enter the Stream Name key part of the HTML rule that is to generate the data stream. The system uses the Primary Page Class of the service as the Applies To key part.
a Rule-Utility-Function from a MapFrom library
Either select the property that holds the value to be processed by the function or leave this field blank, as appropriate for the function.

Message Data

Complete this section to identify the sources and mappings for the JMS request parameters. Working in the same way as the Message Properties section, this section provides two additional data types: Bytes and JavaObject.