Mapping data for a PATCH response for a Connect REST rule

Use the Response tab on the Methods tab of the Connect REST form to map the data from the PATCH response.

  1. In the Headers section, complete the following fields to map data for HTTP header fields:
    1. In the Name field, enter the external name of the header field.
    2. In the Description field, enter a short description of the header field.
    3. In the Map to field, specify the destination or the type of destination for the value in Pega Platform:
      • Select Clipboard to map to the page name or property on the clipboard that is specified by the Map to key field.
    4. In the Map to key field, specify the key for locating the property or the rule in the destination that is specified in the Map to field:
      • If you map to Clipboard, enter the property name to which the data is mapped at run time.
  2. In the Message data section, complete the following fields to map the response data from the message:
    1. In the Description field, enter a short description for the incoming string. The data type of the message data is String.
    2. In the Map to field, specify the destination or the type of destination for the value in Pega Platform:
      • Select Clipboard to map to the page name or property on the clipboard that is specified by the Map to key field.
      • Select Parse XMLRule to specify that the incoming data is a stream of XML that must be parsed by using the actions that are defined in a parse XML rule (an instance of the Rule-Parse-XML rule type).
      • Select JSON to specify that the incoming data is a JSON-formatted stream that must be mapped to a Page or a Page List property on the clipboard.
    1. Optional: When you select JSON in the Map from field, the Use fast processing check box is displayed. For complex JSON structures, if the clipboard structure exactly matches the JSON structure, selecting Use fast processing improves processing speed. For this option to work properly, 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.
      Note: Page groups, value groups, and Java objects are not supported.
    2. In the Map to key field, specify the key for locating the property or the rule in the destination that is specified in the Map to field:
      • If you map to Clipboard, enter the property name to which the data is to be mapped.
      • If you map to XML Parse Rule, enter the Namespace name (second key part) and the Element (third key part) of the appropriate Parse XML rule. Separate the Namespace from the Element name with a space using the syntax "NamespaceName ElementName". The system uses the Applies to class of this connector rule as the first key part of the parse rule.
      • If you map to JSON, enter the property name to which the data will be mapped. The property should be Page or Page List mode.