Map to List

Iterates through an object key-by-key using a helper flow, creating a list as output, with one item in the list per key in the object. For each key in the input object, the helper flow is called with the key name and value for that key - you can select those using the dropdown in the helper flow inputs after selecting a helper flow from the Choose Flow dialog.

The output of the helper flow should match whatever type is specified for new list. There will be one output list item for each key/value pair in the input object.

Input Fields

  • object (required): the object or list of objects you want to pick values from

  • flow (required): the helper flow to process each key/value pair

  • (dynamically generated):  the inputs defined by the helper flow

  • concurrency: how many keys to process in parallel

Output Fields

  • new list: the new list formed by the key/value pairs from the helper flow.

Example

Suppose you wanted to convert an object into a list of objects, where each key/value pair is converted to an object that has "propertyname" and "propertyvalue" keys - this is a common pattern among cloud APIs.  Suppose the propertyname also needs to be prefixed with "custom:".  You can do that with the following helper flow - it accepts key, value, and a constant prefix (which is the same across all iterations - the parent flow should pass this in), and returns back an object with 2 keys:

That flow, when used with Map to List, will turn this object:

into this list:

Related topics

Functions in Workflows

Elements of Workflows