Connect REST form - POST Request

Use the Request tab on the Methods tab of the Connect REST form to map data for the POST request message.

Headers

Use the fields in this section to map data for HTTP header fields. The data type of a header field is String.

Field Description
Name Enter the external name of the header field.
Description Enter a short description of the header field.
Map from Specify the source or the type of source of the value:
  • Clipboard — map to the page name or property on the clipboard specified by the Map from key field.
  • Constant — The data is a fixed value that does not change.
Map from key Specify the key to locating the property or the rule in the destination specified in the Map from field:
  • If the Map from value is Clipboard, enter the property name from which the data is mapped at run time.
  • If the Map from value is Constant, enter the value of the constant and enclose it in quotation marks.

Query string parameters

Use the fields in this section to specify name and value pairs to append as a query string to the resource URL of the target system.

Field Description
Name Enter the name to use for the parameter. The data type of a query string parameter is String.
Description Enter a short description of the parameter.
Map from Specify the source or the type of source of the value in Pega Platform. For descriptions of the Map from options, see the definition of the Map from field in the Headers section.
Map from key Specify the key to locating the property or rule in the source specified in the Map from field. For descriptions of the Map from key options, see the definition of the Map from key field in the Headers section.

Message data

Use the fields in this section to map the response data from the message.

Field Description
Description Enter a short description of the string in the response. The data type of the message data is String.
Map from Specify the source or the type of source of the value:
  • Clipboard — The source is a property or a page on the clipboard.
  • Constant — The source is a fixed value.
  • JSON — The source is a stream of JSON data formatted from a Page or Page List property.
  • XML Stream — The source is a stream of XML data formatted by an XML Stream rule.
  • HTML Stream — The source is a stream of HTML data formatted by an HTML rule.
Use fast processing This field is displayed when JSON is selected in the Map from field. For complex JSON structures, if the clipboard structure exactly matches the JSON structure, selecting this field improves processing speed. For this option to work correctly, use the following guidelines when configuring your data model:
  • The JSON property names and the clipboard property names must match.
  • The JSON tree structure and the clipboard tree structure must be similar.
  • The scalar arrays in JSON must be mapped to the clipboard as page lists.
  • Multi-dimensional arrays must be mapped into page lists of page lists with the same embedded property names.

Page groups, value groups, and Java objects are not supported.

Map from key Specify the key to locating the property or rule in the source specified in the Map from field:
  • If the Map from value is Clipboard, enter the reference to the property from which the data is mapped at run time.
  • If the Map from value is Constant, enter a literal text string. To include blank spaces in your text string, enclose the string in double quotation marks.
  • If the Map from value is JSON, enter the reference to the property from which JSON data is generated and mapped at run time. Only properties of mode Page or Page List must be specified.
  • If the Map from value is XML Stream, enter either the Stream name (second key) of the appropriate XML Stream rule or a page name and stream name by using the syntax PageName.StreamName. (The page must be on the clipboard when the connector rule runs for rule resolution to find the rule.) If you specify only the stream name, the system uses the class that applies to this connector rule as the first key part of the XML Stream rule.
  • If the Map from value is HTML Stream, enter either the Stream name (second key) of the appropriate HTML rule or a page name and stream name by using the syntax PageName.StreamName. (The page must be on the clipboard when the service rule runs for rule resolution to find the rule.) If you specify only the stream name , the system uses the class that applies to this connector rule as the first key part of the HTML rule.
Map as This field is displayed when Clipboard is selected in the Map from field. If the content is mapped from a Java object property that contains a byte array, select Binary otherwise, select Text.
Call is read-only Specifies whether the call updates an external system. When selected, the call reads from or routes to an external system, but does not update it. When cleared, the call updates an external system.