Loop

The Loop action An instruction within a botflow. instructs the loop to repeat a specific set of actions a certain number of times.

For each Loop action created or deleted, a corresponding End Loop action is also created or deleted.

Using the Loop action, you can:

Some examples of using the Loop action are:

  • Repeat a Get Value action to copy all values in all rows in a list.
  • Repeat a Send Value action to paste all values in all rows in a list to an online form.
  • Repeat a Create List action to create lists needed in a botflow.

Add a Loop action to a botflow

This example provides the steps necessary to add a Loop action to a botflow.

To add a Loop action to a botflow:

  1. On the Actions list, click Loops and select Loop from the Loops list.

    2. The Loop Action Builder window displays.

  1. Set the Loop settings.

    2. Loop: Select the Loop action behavior from the drop-down list:

    • Exact times: Sets the exact number of times to repeat an action in a Botflow.
    • Forever: Repeats an action in a Botflow until instructed to end with an Exit Loop action.
    • List: Provides a listing of available lists in the Botflow. The loop limit is the number of rows in the list.

  1. If needed, adjust the Run Switch setting to create the action without running it.
  1. Optionally, add an action note.
  2. Click OK to add the Loop action to the botflow.
Field or button Description
Loop Options/Settings General

  • Loop: Select the Loop action behavior from the drop-down list:
    • Exact times: Sets the exact number of times to repeat an action in a Botflow.
      • Times: Displays when Exact times is selected to set the exact number of times to repeat an action in a Botflow or uses the Expression Builder to build the action settings using variables or other token values.
    • Forever: Repeats an action in a Botflow until instructed to end with an Exit Loop action.
    • List: Provides a listing of available lists in the Botflow. Create lists using either the Project Pane List or the Create List action.
      • Start: Select Beginning or Exact Row. Then either enter the row number or use the Expression Builder to build the action settings using variables or other token values.
      • Stop: Select End or Exact Row. Then either enter the row number or use the Expression Builder to build the action settings using variables or other token values.
Loop submenu options

To manage a Loop action, with the Loop action active in the botflow, right-click the Loop action and choose from the following Loop options.

Menu Item Description

Restart Loop

Restarts the loop by returning to the first loop iteration.

Previous Loop

Goes to the top of the loop and continue running on the previous loop iteration.

Next Loop

Goes to the top of the loop and continue running on the next loop iteration.

Last Loop

Goes to the top of the loop and continue running on the last loop iteration.

Go to Loop...

Goes to the top of the loop and continue running on a specified loop iteration.
Note

(Optional) Type a Note to document any special instructions or functionality.    
Run Switch

The Run Switch toggle controls how Nintex Bot runs an action when adding or editing an action in a botflow.

  • Run: To run the action automatically when you click OK, switch the toggle to Run.

  • Don't Run: If you do not want to run the action automatically when you click OK, switch the toggle to Don't Run.
OK/Cancel Click OK to save the action or click Cancel to discard the action or any changes.