Data Mappings Interface

An Activity has access to the output data from the trigger to which the flow is attached. It also has access to the output from any of the activities that precede it in the same flow provided that the trigger or Activity has an output. This data is displayed in a tree structure under Available data in the mapper. The input schema for the Activity is displayed in the Activity inputs pane to the right of the Available data pane. You can map data coming from the upstream output to the input fields of the Activity. Also, each Activity has access to the input fields of the flow to which the Activity belongs. You can enter the flow input schema on the Input Settings tab of the Flow Inputs and Outputs tab.

When you click an activity or trigger on the flow details page, the configuration page for that activity or trigger opens. The following image is an example of the configuration page that opens when you click the InvokeRESTService activity.

The left-most pane displays the tabs for the configuration fields for that Activity or trigger. Each Activity or trigger has one or more of the following tabs:

  • Settings

    For triggers, this tab is displayed as Trigger Settings. This tab shows the Activity settings, trigger settings, or handler settings.

    • Activity settings are specific to the Activity.

    • Trigger settings are specific to the particular trigger.

    • Handler settings apply to a specific flow attached to the trigger. Each flow attached to the trigger can have its own handler settings.

  • Input Settings

    On this tab, you can enter the schema for the flow or Activity input.

  • Input

    This tab is displayed for activities and shows the schema that you entered on the Input Settings tab in a tree format. You can manually enter values for any elements in the input schema or map any input element to the output from previous activities or triggers on this tab.

  • Output Settings

    On this tab, you can enter the schema for the flow or Activity output.

  • Output

    This tab displays the schema that you entered on the Output Settings tab in a tree format. The schema displayed on this tab is set to read-only as it is for informational purposes only.

  • Map to Flow Inputs

    The settings on this tab must be configured only if your trigger has an output, for example, in the REST or GraphQL triggers. You manually enter or map the elements from the trigger output (schema set on Output Settings tab) to the flow input elements (schema entered on the Input Settings tab of the Flow Inputs & Outputs tab). This allows the output from the trigger to become the input to the flow.

  • Reply Settings

    This tab is applicable only to triggers that send replies to the caller, such as the REST or GraphQL triggers. You enter the trigger reply schema on this tab.

  • Map from Flow Outputs

    This tab is specific to triggers that need to send a reply to the caller, such as the REST or GraphQL triggers. You manually enter or map the elements from the output of the flow (schema set on Reply Settings tab) to the flow output elements (schema entered on the Output Settings tab of the Flow Inputs & Outputs). This allows the output of the flow to become the reply that the trigger sends back to the request that it receives.

  • Loop

    On this tab, enter the iteration details for activities that you want to iterate.

When mapping, you can use data from the following sources:

  • Literal values - literal values can be strings or numeric values. These values can be either manually typed in or mapped to a value from the output of the trigger or a preceding activity in the same flow. To specify a string, enclose the string in double quotes. To specify a number, type the number in the text box for the field. Constants and literal values can also be used as input to functions and expressions.
  • An input element that is directly mapped to an element of the same type in the Available data.
  • Mapping using functions - the mapper provides commonly used functions that you can use with the data to be mapped. The functions are categorized into groups. Click a function to use its output in your input data. When you use a function, placeholders are displayed for the function arguments. Click a placeholder argument within the function and drag an element from the Available data to replace the placeholder. Functions are grouped into logical categories. For more details, see Using Functions.
  • Expressions - you can enter an expression whose evaluated value is mapped to the input field. For more details, see Using Expressions.

The error and warning icons are displayed on the Activity inputs pane, on the configuration fields in the left-most pane, and the activity tile. In case of errors in mapping (such as empty mandatory fields and incorrect mapping at activity or trigger level), an error icon is displayed. A warning icon is displayed if your changes are not saved or discarded, input and output are not mapped in triggers, or mappings are removed for mandatory fields.