Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


The Mapping Root property is a JSONPath that limits the scope of a mapping to the parts of the document that match the given path. For example, a Mapping Root like $.my_array[*] enables the Mapper to iterate over the objects in the array and transform each object based on the mapping. The other parts of the document that do not match the Mapping Root are passed through untouched in the output. By default, the root is set to $, which is the root of the document. 

To move any variables inside $original to root level, you must map the variables to root variables. For example, you must map $original.salary to $salary and $original.balance to $balance.

Because array mappings must be done separately, add additional Mapper Snaps for each array mapping. Chain additional Mapper Snaps together such that the top levels of the hierarchy are mapped before descending down to the lower levels. The reason for this ordering is that the Mapper UI pares down the Input and Target schema views to only show the fields that are in the objects of the array.