Map Task

Map task is a system task that helps organize complex workflows by breaking them into more manageable pieces.

In addition, if part of a process is executed multiple times (with multiple steps), you can create a Map task to encapsulate that part of the repeated process.

A main workflow can have multiple Map tasks. A Map task can also have other Map tasks.

There are several tabs available where you can configure a Map task:

The configuration of the General, Input Parameters, and Routing tabs is similar to that of a user task. We discuss only the Configuration tab here.

Configuration tab

From the Configuration tab, set up the following fields:

Field

Required

Description

Map items JSONPath expression

Yes

JSONPath expression selects an array within a JSON input parameters provided to a Map task.

Max concurrent tasks

No

An integer that provides an upper bound on how many tasks may run in parallel. Default is no limit.

Max concurrent tasks with expression

JSONPath expression to lookup reference data for max concurrent tasks.

JSONPath expression of task input parameters must be inside a placeholder ${ }. See JSONPath for more information about JSONPath.

JSONata expression can also be used instead of JSONPath, prefix the expression with jsonata, e.g. ${jsonata: }. See JSONata for more information about JSONata.

To escape the expression, prefix it with an extra $ character, e.g. $${ }.