Task

A task contains the instructions for Nintex Bot. A botflow Automated steps that you can design for each bot that will run. can contain many related and unrelated tasks. When a new botflow is created, a task named New Task is created.

Jump to: 

Start Task

A Start Task is a task that designates the Starting Point of your botflow.

To create a Start Task:

  1. Click Add Item () on the Botflow Pane.
  2. Click Task.
  3. Type the task Name so that you can easily identify it. The name must be unique and cannot match the name of any other task in the botflow.  
  4. (Optional) Add Notes to the task to document special instructions or functionality.
  5. Click OK to save the task.
  6. Navigate to the Task on the Botflow Pane.
  7. Right-click on the Task.

  8. Select Start Here to designate the task as a Starting Point for your botflow.

Error Task

An Error Task Can be added to a botflow to provide global error handling. automatically runs an action's Error settings.

To create an Error Task:

  1. Click Add Item () on the Botflow Pane.
  2. Click Task.
  3. Type the task Name so that you can easily identify it. The name must be unique and cannot match the name of any other task in the botflow.  
  4. (Optional) Add Notes to the task to document special instructions or functionality.
  5. Click OK to save the task.
  6. Navigate to the Task on the Botflow Pane.
  7. Right-click on the Task.

  8. Select Run On Error to automatically run an action's Error settings.

After Task

An after task Task used to run actions once at the end of a botflow. is a task used to run actions once at the end of a botflow. When the After Task that contains these actions has completed, the botflow is finished and will also complete. You can create an After Task and it will run automatically when a botflow runs.

In Nintex Bot, the run setting (Run Once, Repeat, Records, and Forever) will determine automatically when to run a Before Task, the botflow run, and lastly, an After Task. When the Start Task runs, it will run all subsequent tasks that are called by the Start Task. The standard behavior of botflows running in Nintex Bot is as follows: 

  • If the run setting is set to Run Once, the Before Task will run first, then the bot will run the Start Task one time from the first action to the last action in the Start Task, and lastly, it will run the After Task.

  • If the run setting is set to Repeat, the Before Task will run first, then the bot will run the Start Task from the first action to the last action in the Start Task for all subsequent runs until the last run is completed, and, lastly, it will run the After Task.

  • If the run setting is set to Records, the Before Task will run first, then the bot will run the Start Task from the first action to the last action for each record. On the last record, after all actions in the Start Task have completed, the After Task will run.

  • If run setting is set to Forever, the Before Task will run first, then the bot will run the Start Task from the first action to the last action, repeating continuously until the user manually stops the bot. With this run setting, the After Task never runs.

If you want to modify the standard behavior of botflows running in Nintex Bot, you can create the following actions that will change the botflow behavior at run time:

Typical uses for an After Task are:

  • Closing applications.

  • Closing data using the Close Data action.

  • Resetting variables and records.

Note: You cannot use an After Task with a botflow that is scheduled to run from Nintex RPA Central and includes a Dataset. The dataset will be split over multiple bots and Nintex RPA LE cannot calculate if the After Task was run on each bot. If you attempt to use an After Task in this scenario, you will receive a message that states, "This botflow contains a dataset schema and an After task. If you run the botflow from Nintex RPA Central, the After tasks will not be executed."

Create an After Task

  1. Click Add Item () on the Botflow Pane.
  2. Click Task.
  3. Type the task Name so that you can easily identify it. The name must be unique and cannot match the name of any other task in the botflow.  
  4. (Optional) Add Notes to the task to document special instructions or functionality.
  5. Click OK to save the task.
  6. Navigate to the Task on the Botflow Pane.
  7. Right-click on the Task.

  8. Select Run After to run actions once at the end of a botflow.

    An arrow appears and points to the left of the task. The task will turn on at the start of the last botflow run and will execute on completion of the botflow. It will run before the pointer arrow returns to the top of the botflow on the last botflow run. The botflow will then complete and the end message will be displayed.

    Example: If there are runs 1 through 6 in a botflow, you can create an After Task to execute after run 6. If the After Task is set up to run multiple times, it will still only execute after run 6. Alternatively, you can set it up to execute once on the completion of each botflow run. You can also set it up to run records and it will only execute after the last record has run.

Before Task

A before task Task used to run actions once at the beginning of a botflow. is a task used to run actions once at the beginning of a botflow. You can create a Before Task and it will run automatically when a botflow runs.

In Nintex Bot, the run setting (Run Once, Repeat, Records, and Forever) will determine automatically when to run a Before Task, the botflow run, and lastly, an After Task. When the Start Task runs, it will run all subsequent tasks that are called by the Start Task. The standard behavior of botflows running in Nintex Bot is as follows: 

  • If the run setting is set to Run Once, the Before Task will run first, then the bot will run the Start Task one time from the first action to the last action in the Start Task, and lastly, it will run the After Task.

  • If the run setting is set to Repeat, the Before Task will run first, then the bot will run the Start Task from the first action to the last action in the Start Task for all subsequent runs until the last run is completed, and, lastly, it will run the After Task.

  • If the run setting is set to Records, the Before Task will run first, then the bot will run the Start Task from the first action to the last action for each record. On the last record, after all actions in the Start Task have completed, the After Task will run.

  • If run setting is set to Forever, the Before Task will run first, then the bot will run the Start Task from the first action to the last action, repeating continuously until the user manually stops the bot. With this run setting, the After Task never runs.

If you want to modify the standard behavior of botflows running in Nintex Bot, you can create the following actions that will change the botflow behavior at run time:

Typical uses for a Before Task are:

  • Logging into applications.

  • Setting up applications with which Nintex RPA LE will be interacting.

  • Opening data using the Open Data action.

Note: You cannot use a Before Task with a botflow that is scheduled to run from Nintex RPA Central and includes a Dataset. The dataset will be split over multiple bots and Nintex RPA LE cannot calculate if the Before Task was run on each bot. If you attempt to use a Before Task in this scenario, you will receive a message that states, "This botflow contains a dataset schema and a Before task. If you run the botflow from Nintex RPA Central, the Before tasks will not be executed."

Create a Before Task

  1. Click Add Item () on the Botflow Pane.
  2. Click Task.
  3. Type the task Name so that you can easily identify it. The name must be unique and cannot match the name of any other task in the botflow.  
  4. (Optional) Add Notes to the task to document special instructions or functionality.
  5. Click OK to save the task.
  6. Navigate to the Task on the Botflow Pane.
  7. Right-click on the Task.

  8. Select Run Before to run actions once at the beginning of a botflow.

    An arrow appears and points to the left of the task. The task will turn on at the next execution of the Start Task at the top of the botflow and will turn off after the Before Task is executed. It will run before the pointer arrow moves down the botflow on the first botflow run. The botflow will then complete and the end message will be displayed.

    Example: If there are runs 1 through 6 in a botflow, you can create a Before Task to execute before run 1. If the Before Task is set up to run multiple times, it will still only execute before run 1. Alternatively, you can set it up to execute once at the beginning of each botflow run. You can also set it up to run records and it will only execute before the first record is run.

Manage tasks

  1. Navigate to the Task on the Botflow Pane.
  2. Right-click on the Task.

    3. The Context Menu displays.

  3. Add, edit, delete, duplicate, rename (default task only), and convert tasks.

    Note: If you select to convert an action, the converted action is saved as a new task and named using the following naming convention: [TaskName] - BrowserName. Before executing converted actions, be sure to test them!