Map

Overview

  • The Map action allows a workflow to apply a specific transformation to each element in a collection, such as a list or array.

  • The action works by applying a function to each item and generating a new collection with the modified values.

  • This action is particularly useful for converting or transforming data structures, formatting outputs, or altering values based on a set of rules.

For example, if a workflow has list of account objects and want to map new values with the account records, then they can prefer using Map action.

  • Let’s explore the screens that follow, after drag-n-drop of Map action on workflow canvas.

Config

image-20240819-144737.png
Config Tab

Config Field

Description

Config Field

Description

Map Source

It enables to choose the source type to where the mapping will be performed on records.

Model / Input / Variable

It enables to choose the exact value of source type to where the filtering will be performed on records.

Note: By default, label of this field will be populated depending upon the Map source chosen earlier.

Key Property

It enables to specify the key property which will be unique value to trace records in collection.

Note: By default, this field will be invisible. It will only be populated if the Map Source is chosen as Model.

Output Properties

It enables to specify output properties of records after filtering data, which means which field values are to be taken under consideration in filtering from the selected key property.

Filters

It enables to perform filtering on map records.

Filters

image-20240819-144953.png
Filters Screen

Filter Field

Description

Filter Field

Description

Field Name

It enables to specify the field name as left operand in filtering.

Operator

It enables to specify the operator to compare in filtering such as

  • Equals: The equal operator is used to compare two values or expressions. It is used to compare numbers, strings, Boolean values, variables, objects, etc. The result is TRUE if the expressions are equal otherwise it’s FALSE.

  • Starts with: It returns TRUE if a string or number starts with the specified character otherwise it returns FALSE.

  • Ends with: It returns TRUE if a string or number ends with the specified character otherwise it returns FALSE

  • Contains: The contains operator returns TRUE if the value on the left contains the value on the right, and otherwise FALSE

  • In: IN operator allows you to easily test if the expression matches any value in the list of values. Determines whether the value of an expression is equal to any of several values in a specified list.

Source Type

In this option, you can select various sources from which you want to display values.

Source Type

Source Type

Description

Source Type

Description

Static

Use this option to provide a fixed static value.

Model

Choose the field from other models whose value you want to include.

Input Variable

Select from the variables created in the layout whose value you want to use.

User

You can also select fields from the current logged-in user in your organization to include in the merge.

Action Details

Input