Task Builder Debugger Preferences

The Task Builder includes settings that affect its behavior while running a task. In some cases you may want to change these settings to help you better debug a task. For instance, you can opt to minimize the Task Builder window during execution to better examine an interactive task, play a custom sound upon error, clear the Output debug window after each run and more.

Parameters

Property

Description

Save task on run

If enabled, 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. This parameter is disabled by default.

Minimize on run

If enabled, the Task Builder minimizes 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. This parameter is disabled by default.

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:

  • Never: Do not play a sound when an error occurs.

  • Use default sound: Use the default system error sound, as specified in Window's Control Panel.

  • Use this sound: Specify a valid path and filename of a .wav file to use.

See Also

Task Builder Color Preferences

Task Builder Debug Toolbar Preferences

Task Builder Font Preferences

Task Builder Formatting Preferences

Task Builder General Preferences