This article describes how to iterate over items, create a new list in Workflows, and use the List-Map card.

• Okta Workflows

If there is a list of users and need a new list where each user is listed as lastname.firstname. Perhaps this name format is needed to create an account in another system. 

1. To start, this is the main flow: 

• The first card, the Okta – List Group Members, gets all members (users) from the specified group.
• The List – Map card calls a helper flow to process the user list. The entire record (User) is passed to the helper flow. It returns a list (new list) that can be used in the rest of the flow.
  • This is different from the For Each action that also processes a list but does not return a list back).
• In this example, the Flow Control—Assign card displays the returned list. It indicates whether a list is available for use in the rest of the flow.

2. This is the helper flow: 

• In the first Helper Flow card, the input is the current record (User).
• The Get Multiple card retrieves the First Name and the Last Name of the current user. Other fields can also be retrieved.
• The Text Concatenate card concatenates the First Name, a period (.), and the Last Name.
• The Flow Control – Return card receives a new name in the lastname.firstnameformat and adds it to the new list. Once all the items are processed, the List – Map card (main flow) returns a new list. This new list is now available in the main flow.

3. This screenshot shows one run of the helper flow that returns one name in the lastname.firstname format: 

4. This screenshot shows the main flow execution: 

5. The new list (from Assign card):

If familiar with the List – For Each card, it processes the list item but does not return a value back to the main flow. The List – Map card processes a list of items and returns a new list to the main flow.

Related References

• Okta Workflows How-To: Iterate Over Items and Create a New List (Using the List – Map Card)