Mapping fields

When you have configured a system of record for a data type, you can map the REST response and request fields to fields in the data view so that you can obtain data from your source.

If you are using the Google Chrome browser and you experience slow performance during mapping, clear the Use hardware acceleration when available browser setting.

  1. If you are in the Data Type wizard, skip this step, otherwise, perform the following steps:
    1. From the App Studio, click Data.
    2. Click the data type that you want to update.
    3. Click Data views > More > Update source or Replace source.
    4. Click Next until you get to the Data mapping screen.
      Result: If you are updating a source, the existing mapping is displayed. If you are replacing a source, no mapping is displayed.
  2. Map data based on whether you are creating a new data type, or updating or replacing a data type.
    • If you are creating a new data type, create a mapping based on the external data model, by doing any of the following operations:
      • Click Add all to create a field with a matching name in the data view for every field in the REST response.
      • Click Add new on any row to add a field for that property. Enter its name and select its data type.
      • Click Clear all to remove all mappings.
    • If you are replacing or updating a data type, update the mapping.
      1. Click REST response.
      2. Optional: To view only the fields that are mapped or to view all fields Toggle the Mapped only option.
      3. Optional: To view call details, click the Information icon.
      4. Click and drag from a REST response field to a data view field to create a mapping.
      5. Optional: To add a new field to the data view, click the Add icon. For more information about adding fields, see Adding fields to your data model.
      6. Click REST request.

        The connector parameters are on the left and the data page parameters are on the right. The top-level JSON element determines the structure of the data page.

      7. For each connector parameter, select the data page parameter to map to or enter a new parameter.
        Note: You can only add parameters. You cannot deleted them for backwards compatibility.
    There are some limitations for mapping fields. See Data mapping limitations.
  3. Click Next.
Result: A JSON data transform is created according to how you mapped the fields. You can update this data transform by switching to Dev Studio.