Mapping Source Fields

Mapping Source Fields

New in Release 1.1: Nested JSON will be automatically parsed out at Intake. This will allow you to map each value separately. See an example of this new feature.
  1. Create a Source, or select the Source that you would like to begin mapping.
  2. Select the Mapping tab. To begin mapping fields, select the "Create Source Field" button and begin creating the fields that will be brought in through this Source. (Simplify the mapping process by sending some test PODs through using that Source's API key. This will net you a list of all the fields. Then skip to step 4.)
  3. On the Create Source Field dialog box, select the Data Type for this field:
    1. Field: A data type that is unique for each POD that feeds through this Source. (By Default, Source Fields will be Data type Field.)
      1.  Example: Name, Address, phone number, etc.
    2. Constant: Fields that have constant values for all PODs feeding through this Source.
      1. Example: If you would like all PODs feeding through this Source to have a "Page" field with the value "Contact Us Page".
    3. Expression: Fields that you would like to enhance or manipulate before the data is mapped to the Relay Field.
      1. Example: If you would like all values in the First Name field to have a capitalized first letter, you would use the field source code and the "capitalize" nunjucks code.
  4. Next, type in the corresponding value for that Source field. If the data type is an expression, type in the corresponding nunjucks code here.
  5. All new fields will default to the "Unmapped Fields" list, as they have yet to be mapped to a Relay field. 

  6. If you wish to change the Source Field data type, click on the Source Field. The Edit Source Field dialog box will pop up. 
  7. Next, click the "Add Relay Field" area to the right of a Source field. An "Add Relay Field" sidebar will appear to the right. Select the Relay Field that corresponds to the Source field and drag the field into the corresponding "Add Relay Field" area. (For more information on Relays, select Understanding Relays.)

  8. Repeat for all fields in the "Unmapped Fields" list. When a Source fields is mapped, it will move from the "Unmapped Fields" list to the "Mapped Fields" list. Once you have finished Mapping, make sure to save.
Read our documentation on how to manipulate data feeding through the Source and combining Source fields.

Unmapping Source Fields

  1. To remove a mapped field, click the three-dots icon on either the corresponding Source field or Relay field. Select "Unmap." This will move the field to the "Unmapped Fields" list.
  2. To delete a Source field, click the three-dots icon on the corresponding Source field, and select "Delete." Deleting a Source field will completely remove that field from the Source.
  3. Once you have finished Mapping, make sure to save.
Source fields in the "Unmapped Fields" group are not mapped to a Relay field. If unmapped, any data in that corresponding Source field will not be sent be routed to the Destination.

How did we do?