Table of Contents

Mapping fields for the GET method for existing data objects


Only available versions of this content are shown in the dropdown

Select the data that your application needs for processing by mapping fields from the REST response to the data view.

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 Initialize call to request data from the REST service and display the response.

    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.
  2. On the Data mapping page, 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 JSON Add sample response . Follow the prompts to upload a file or paste in a sample JSON, and then click Submit.
  3. Map the data from the response to the fields in your data object.

    1. Click REST response.

      There are some limitations for mapping fields.
      For more information, see Data mapping limitations.
    2. Optional:

      To view only the fields that are mapped or to view all fields, toggle the Mapped only option.

    3. Optional:

      To view details about the response, such as the return code or the raw data, click the Information icon.

    4. 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.

    5. If a corresponding field does not exist, add a new field to the data view by clicking the Add icon.

  4. Map the data from the request to the 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.

    You can only add parameters. You cannot delete them for backwards compatibility.
  5. Click Next to advance to the environment Settings window.

  6. Click Submit to complete the mapping.

  7. Click Save to save the changes to the data view.

Prepare your data for production by configuring the environment settings. For more information, see Preparing your data for production.
Did you find this content helpful?

Have a question? Get answers now.

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