Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Mapping fields for the POST method for existing data objects

Updated on November 23, 2022

Keep sensitive data private by connecting to your system of record using the POST method.

Before you begin: Configure a data object to a system of record using REST and select the GET connection method. For more information, refer to Connecting existing data objects to a system of record using REST.
  1. Click Add sample request.
  2. Optional: To import key value pairs from a file, click Choose File.
    Each key value pair must have a colon between the key and the value and be separated by a new line, for example:

    amount: 285

    currency: usd

    1. Navigate to the file that you want to import and then click Open.
    2. Edit the fields as necessary.
  3. Optional: To add key value pairs that you want to include in the request body, click Add parameter.
  4. Click Map request.
  5. Optional: To add fields from sample request to include in the request body, select the fields that you want to include in the data object and map them to your data view by using the following options:
    • To add the field data object, click Add new. You can change the field name and its type.
    • To add all the fields from REST response to the data object using the field names, click Add all.
    • To remove all the fields from the data object, click Clear all.
  6. Click Initialize call.
    Result: The system displays the connector parameters on the left, and the data page parameters on the right. The top-level JSON element determines the structure of the data page and is a list page if the element is an array, or a single page if the element is an object.
  7. Choose whether to use live data or data from a JSON file to create the data object.
    • To use data from your system of record, select Live response.
    • To use data from a JSON file, click Sample JSONAdd sample response. Follow the prompts to upload a file or paste in sample JSON, and then click Submit.
  8. Click REST response.
  9. Map the data from the response to the fields in your data object.
    1. Optional: To view only the fields that are mapped or to view all fields, toggle the Mapped only option.
    2. Optional: To view details about the response, such as the return code or the raw data, click the Information icon.
    3. For each single-value item, such as a string or Boolean, that you want to use in your application, drag the item from the response column to a corresponding field in the Fields column.
    4. If a corresponding field does not exist, add a new field to the data view by clicking the Add icon.
  10. Map the data from the request to fields in your data object.
    1. Click REST request.
    2. For each connector parameter, select the data page parameter to which you want to map or enter a new parameter.
      Note: You can only add parameters. You cannot delete them for backwards compatibility.
  11. Click Next to advance to the Environment Settings window.
  12. Click Submit to complete the mapping.
  13. Click Save to save the changes to the data view.
What to do next: Prepare your data for production by configuring the environment settings. For more information, see Preparing your data for production.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us