Move List Row

The Move List Row action An instruction within a botflow. moves a list row up or down in a list in a botflow Automated steps that you can design for each bot that will run..

Using the Move List Row action, you can move a list row to adjust:

The list row after the import of new data.
A list row that may be out of order.

Some examples of using the Move List row action with lists are:

A list created in the Nintex Bot Botflow pane.
A list modified using the Set List Value action.

Add a Move List Row action to a botflow

This example provides the steps necessary to add a Move List Row action to a botflow.

To add a Move List Row action to a botflow:

On the Actions List, click Lists and then click Move List Row from the Values list.

The Action Builder window for Move List Row displays.

Set the Move List Row settings:

List: Enter a list name in the List field.
Row: Enter a list row name in the Row field.
Move: Select how to move the list row from the drop-down list.

If needed, adjust the Run Error Task settings to fine tune how the action runs.
If needed, adjust the Run Switch setting to create the action without running it.

Optionally, add an action note.
Click OK to add the Move List Row action to the botflow.

Move List Row Action Builder field and button descriptions

Field or button	Description
Move List Row Options/Settings	General List: Enter a list name in the List field, select a list using the drop-down, or use the Expression Builder to build the action settings using variables or other token values. Row: Enter a list row name in the Row field or use the Expression Builder to build the action settings using variables or other token values. Move: Select how to move the list row from the drop-down list. Up: Enter a number to move the selected row up in the list in the Up field or use the Expression Builder to build the action settings using variables or other token values. Down: Enter a number to move the selected row down in the list in the Down field or use the Expression Builder to build the action settings using variables or other token values. First row: Moves the selected row to the first row position in the list. Last row: Moves the selected row to the last row position in the list. Exact position: Enter a number to move the selected row to an exact position in the list in the Exact Position field or use the Expression Builder to build the action settings using variables or other token values.
Run error task	Click Run error task. Open the On Error drop-down list and select the required setting: Run error task: A botflow containing an error task automatically runs the error task in the event of an error. If the botflow does not contain an error task, the botflow stops in the event of an error. Stop on error: The botflow stops in the event of an error. Ignore errors: The action is skipped in the event of an error and the botflow attempts to execute the next action. Click X to close the drop-down and save the setting.
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.