Max Katz

Okta Workflows how-to guides are questions and answers from weekly community office hours, MacAdmins Workflows Slack channel, and other places. Read all other how-to guides. 

On to the question. 

How to convert an object to a list (or how to use the Object – Map to List card)?

Object – Map to List card takes an object and converts it to a list using a helper flow.

For example, if you have this object:

{
   "drink": "wine",
   "main course": "chicken",
   "appetizer ": "salad",
   "desert": "ice cream"
}

You can convert it to a list where each property from the object becomes a key/value pair:

[
   {
      "key": "drink",
      "value": "wine"
   },
   {
      "key": "main course",
      "value": "chicken"
   },
   {
      "key": "appetizer",
      "value": "salad"
   },
   {
      "key": "desert",
      "value": "ice cream"
   }
]

This is the main flow:

And the is the helper flow:

Result running the flow:

[
   {
      "key": "drink",
      "value": "wine"
   },
   {
      "key": "main course",
      "value": "chicken"
   },
   {
      "key": "appetizer ",
      "value": "salad"
   },
   {
      "key": "desert",
      "value": "ice cream"
   }
]

You can also pass additional information to the helper flow, for example, if you need to pass in a prefix (dinner) to get the following result:

[
   {
      "key": "dinner:drink",
      "value": "wine"
   },
   ...
]

The updated main flow with a constant prefix passed to the helper flow:

In the update helper flow, the prefix is concatenated with the key to create a new key value:

Result running the updated flow:

[
   {
      "key": "dinner:drink",
      "value": "wine"
   },
   {
      "key": "dinner:main course",
      "value": "chicken"
   },
   {
      "key": "dinner:appetizer ",
      "value": "salad"
   },
   {
      "key": "dinner:desert",
      "value": "ice cream"
   }
]

In this how-to you learned how to use the Object – Map to List card.

---

More resources to help you learn:

 📺 Short how-to Workflows videos to help you become a better automation builder.

 🍿 A collection of helpful Workflows tips.