Testing Tasks Using Run Options

Overview

Task execution may happen so rapidly that it is difficult for a user to determine the exact cause of a problematic step. In such cases, the Task Builder encompasses various Run options (displayed below) to handle this issue. The Run Selected control runs only the selected steps, which is a useful way to ignore execution of steps that are non-problematic. The Run From Here control runs the task from the selected step onward. The Step control suspends task execution on a step by step basis, allowing you to examine what the task is doing during execution of each step. This is ideal for  troubleshooting problematic  purposes because it lets you suspend execution at each step as well as view runtime information populated within the various Debug panel views.

NOTE: When suspended, the task is still running but paused between actions. AutoMate variables or datasets retain their values, and the Task Builder's Output panel displays information about the step that is currently running.

Run Controls

The following table describes the Task Builder's list of available Run controls along with their associated icon and equivalent hot-key.

Icon

Name

Description

Hot-key

Run/Run All

Runs the entire task, from beginning to end, or until an error is encountered. If the task is manually paused or a breakpoint is applied, execution is suspended indefinitely at the point of the pause or at the step that that contains the of the breakpoint or= , execution is suspended at the step that contains a breakpoint or at the step

F5

Run Selected

Runs only the selected (highlighted) steps sequentially, from the lowest to the highest step.

CTRL + F5

Run from Here

Runs the task from the selected (highlighted) step until its completion

SHIFT + CTRL + F5

Step

Runs the task step by step, pausing on each step

F9

Pause

Immediately suspends task execution at the step

 

Stop

Immediately stops the running task.

 

     

 

 

Run Instructions

To run the entire task:

To run one or more selected steps:

  1. Select the step(s) you wish to run. To select more than one step, hold down CTRL during selection.

  2. Select Run Selected or press CTRL+F5. This will run the specified steps in sequence from the lowest to highest numbered step.To run the task from a specific step:

  1. Select the step that should start the execution process.

  2. Select Run From Here or press SHIFT+CTRL+F5. The steps will run sequentially starting from the specified step.

To Step Through a Task:

  1. Click the Step button. The first (or selected) step of the task runs. At this time you can:

  1. Click Step to execute the next line.

  2. Continue clicking Step to execute the next line until you reach the end of the task or until you have determined the issue.

  3. You can also run the rest of the task at regular speed from this point forward by clicking the Run from here button. Click the Stop button at any time to stop a step process.

NOTE: If you import a task that includes an unlicensed action/activity, the Steps panel will display the unlicensed step (in Visual view) as currently unlicensed. Running a task that includes an unlicensed step will always fail at that step. You can bypass the step by disabling it or removing it altogether.

More on "Stepping"

“Stepping” is the process of executing a task one step at a time. When clicking the Run button, task execution may happen so quickly that it’s too complicated to determine what is causing the problem and where that problem takes place. The Step button is ideal for such a situation because clicking this button will execute one step, then wait, providing a chance for the developer to examine what the previous step may (or may not) have done or observe the contents generated in the Debug window in order to better diagnose the task. The Step button can be accessed via the keyboard by hitting the F9 key.

NOTE: Most Task Builder commands and controls contain a corresponding shortcut key (or hot-key). To determine the appropriate shortcut for a control, simply hover the mouse over it.

Control running tasks

You can manually pause or stop a currently running task at any time during its execution.

To suspend a running task:

To stop a running task:

NOTE: The Pause and Stop buttons are usually disabled and are active only during task execution.