Using the Mapping Editor
  • 03 Aug 2022
  • 2 Minutes to read
  • Dark
    Light

Using the Mapping Editor

  • Dark
    Light

Article Summary

Overview

The Mapping Editor offers the ability to visually map and define input and output values. The Mapping Editor can be accessed by clicking Edit Input Mapping on the Properties panel or by selecting the Select From Flow mapping type in the Flow step's INPUT or OUTPUT values. 


Edit Input Mappings

The Edit Input Mappings button is displayed at the top of the Properties panel. The number in the parenthesis counts how many inputs the step has. All inputs on a step need to have a mapping type, but they do not all need to be defined with a value. Some inputs require definition, and if they are not, the system will throw an exception.

The Input Mapping window presents a visual list of available data on the left and expected step inputs on the right. The Input Mapping window enables a click and drags feature that creates a blue line to indicate that data on the left is connected to an input on the right.

List Options

Some available data on the left will be a list that can be expanded and have four property options that can be mapped. 

Common Input List OptionsDescription
All [Property]Passes all of the available items of the property as a list. 
CountPasses all of the available items as a number (Int32) value indicating the total amount of items
FirstPasses the first single item of the property
LastPasses the last single item of the property


Filtering and Searching in the Mapping Editor

Within the Mapping Editor, users also have the ability to filter or search for specified pieces of data. These features can be found on the right-hand side of the FLOW DATA column and the STEP INPUTS or STEP OUTPUTS columns, depending on the type of data utilized.

Filtering

  1. From the Mapping Editor, select the abacus icon (Filter) on the desired column.
  2.  Select one of the following options: Show Mapped Only, Show Unmapped Only, Show All
  3. The column will update to display the newly filtered column values.

Search

  1. From the Mapping Editor, select the Search icon in the desired column. 
  2. In the resulting Search Bar, provide the desired search term/characters. The search bar will search for and filter any result that contains any of the input characters in the order in which they are provided.
    Compound Data Structures results are sorted alphabetically by the primary data type name, then by each individual property.
  3. View the newly filtered column contents and verify that they meet the search criteria. 

Select From Flow

On the Properties panel, clicking Ignore or Unknown on a step's input or output field and changing it to Select From Flow will open the Pick Data window. This view takes a more compact approach and indicates that the piece of data must be chosen for the corresponding field only. 

Instead of using an arrow to expose datatype properties, the Pick Data window will show the available properties after selecting the data type.


For further information on Flows, visit the Decisions Forum.

Was this article helpful?