How to Use For Each Loop in NINTEX Workflow

Introduction

In this article you will see how to use a "For Each" loop in a NINTEX workflow. I will add multiple users to the specified group by calling the web service "_vti_bin/usergroup.asmx". I have created a custom list named "User Collection" that has the following columns:

1. Group Name: A single line of text: It stores the group name to which the users will be added.
2. Users: Person or group; multiple users can be added to this column that will be added to the specified group.

Workflow Design



A Regular Expression action is used to get the user collection from the list item and stores it in the Collection workflow variable. A "For Each" action is used to loop through all the users from the collection variable and store it in a person or group workflow variable. Call the web service action used to add the users to the specified group.

Add users to group workflow

Use the following procedure to add users to a group workflow:

1. Navigate to the User Collection list.
2. Click on the "List" tab and then click on "Workflow Settings".
3. Click on "Create a Workflow in Nintex Workflow".
   
   
   
   
4. Click on "Cancel".
   
   
   
   
5. Drag and drop the "Regular Expression" action from the "Operations" section.
   
   
   
   
6. Click on the "Configure from Regular Expression" drop down list.
7. Click on the "Variables" button in the ribbon interface.
   
   
   
   
8. Click on the "New" button.
9. Enter the Name as "userCollection" and variable type as "Collection".
10. Click on "Save".
    
    
    
    
11. The workflow variable is created successfully.
12. Click on "Close".
13. Get all the users from the list item and separate the values by a semicolon. Store all the users in the collection variable that we have created.
    
    
    
    
14. Click on "Save".
15. Drag and drop the "For Each" action from the "Logic and flow" section.
    
    
    
    
16. Click on "Configure" from the "For Each" drop down list.
17. Click on the "Variables" button in the ribbon interface.
18. Click on the "New" button.
19. Enter the Name as "user" and the variable type as Person or Group.
20. Click on "Save".
21. The Workflow variable is created successfully.
22. Click on "Close".
23. Drag and drop the "Call web service" action from the Integration section inside the "For Each" action.
24. Click on "Configure" from the drop down list in the "Call web service" action.
25. Click on the "Insert Reference" button for the URL column and then click on the "Common" tab. Select "Web URL" and then click on "Ok".
    
    
    
    
26. Append "/_vti_bin/usergroup.asmx" in the URL column.
27. Enter the User Name and Password to call the web service and then click on the "Reference" button.
28. Click on "Ok".
    
    
    
    
29. All the web service methods will be populated. Select the "AddUserToGroup" web method that will be used to add the users to the specified SharePoint group.
    
    
    
    
30. The Web Service Input section will be populated for passing the input values to the web method.
    
    
    
    
31. Click on the "Insert Reference" button for the groupName column and then click on "Item Properties" tab. Select the Group Name and then click on "Ok".
    
32. Click on the "Insert Reference" button for the userName column and then click on the "Workflow Variables" tab. Select the user and then click on "Ok".
    
    
    
    
33. Click on "Save".