Scopes in Data Mappings

The Upstream Output area in the mapper displays the output data from preceding activities, trigger, and/or flow inputs. This area groups the output elements based on a scope. A scope represents a boundary in the Upstream Output within which an input element can be mapped. For example, when mapping an input element to an element from the output of a trigger, the scope of the input element is represented in Upstream Output as $trigger. The following scopes are currently supported by the mapper.

Scope Name Used to... Available in...
$trigger Map flow input to trigger output Trigger (Map to Flow Inputs tab) to map flow inputs to trigger outputs
$flow Map flow output to trigger reply
  • Trigger (Map to Flow Outputs tab) to map flow output to trigger reply
  • Activities (Input tab) to map activity input to flow input
  • Return activity (Map Output tab) to map flow output to flow input
$activity.[activity-name] Map input elements of the activity to elements from the output of previous activities

$activity represents the scope of an activity. [activity-name] indicates the activity whose scope you are defining. Each preceding activity has its own scope in the mapper.

$iteration Keep track of the current iteration and is available only when iterator is enabled for an activity in the Loop tab of the activity Input tab of an activity that has Loop enabled. Displays only when the Loop for the activity is enabled. Two elements are displayed under $iteration:
  • key - This element represents the iteration index, hence it is always of type number. For example, if the Loop expression is set to an array, the key element will represent the array index of the current iteration
  • value - the value can be of any type depending on what is being iterated. For example, if you are iterating through an array of strings, the value is of type string
$property [property-name] Map to app properties that are defined in the app As long as there are app properties defined in the app, this scope is available for mapping from any activity that allows mapping
$loop Map elements within an array $loop is prefixed to the element name when mapping an element that is within an array. The scope of $loop is the current array that you are iterating through.
Related concepts