Task Builder Debugger Preferences

The Task Builder includes settings that affect its behavior while running and debugging tasks. In some cases you may want to change these settings to help you debug a task.

To modify Task Builder debugger options:

  1. On the Task Builder Tools menu, click Editor Options.

  2. Click the Debugger tab, as shown below.

  3. Select the desired options as follows.

  4. Click the OK button to save changes.


Save task on run

Saves any changes made to a task before the task starts running. If the task has not been saved yet, AutoMate will prompt the user for a filename before running.

Minimize on run

Minimizes the Task Builder to the system tray before starting the task. When the task ends, the Task Builder restores itself and highlights the current step, or displays "Finished" as the step status in the status bar.

NOTE: The default behavior of the Task Builder window is to stay on the desktop (does not minimize or hide itself) while a task is running. Therefore, when testing tasks that include interactive actions (i.e. Send Keystrokes, Move Mouse to Object actions) or actions that interact with other windows (i.e. Maximize Window, Minimize Window actions), the Task Builder window may interfere with the actions being performed by a task. For example, this may result a Send Keystrokes step failing to send keystrokes to the proper window or application. Enabling the Minimize on run option will remedy such an issue.

Restore on pause and/or breakpoint

When the task is manually paused or pauses at a breakpoint, the Task Builder restores itself and highlights the current step.

Clear output window on run

Clears the contents of the Debug Output Window before the task starts executing. If this is not selected, new debugging output is appended to information accumulated from the previous task run.

Real-time variable insight

The Task Builder maintains a list of AutoMate variables in the current task which can be viewed in the Variables tab of the Debug Window. At runtime, the view also shows the current value of these variables. When this option is selected, the variable view is updated after each step is executed to show the current variable value. When this option is not selected, the variable view is updated only when the task is paused (by clicking the Pause button or when a breakpoint is encountered), while stepping through the task, and when the task ends. Note that selecting this option could cause tasks to execute somewhat slower while debugging (it does not affect execution speed when not debugging, however).

Inspect entire dataset

AutoMate Datasets contain a number of properties that are not usually displayed in the AutoMate Variable Window. These properties are used, for example, to view the date/time the dataset was created, the total number of rows in the dataset, etc. Select this option to display these extended dataset properties in the Variables view when the task is run.

Show initial variable value

Causes the Variables tab to include a column for initial value in addition to the Current Value column. If this is not selected, only the current value is shown.

Play sound on error

Selects whether to play a sound when the task stops as a result of an error. Regardless of this setting, when a step fails, it is always colored using the Error color set in the Color Options (usually red). Also, task execution stops, and the error is written to the Output view. The selections are:

See Also

Debugging Tasks Overview

About the Debug Window