Errors Properties

Description

As part of AutoMate's "tri-level" error handling options, errors may be handled on a per task basis. This is ideal if the user wants AutoMate to perform separate error handling procedures for each managed task. A task level error occurs when a certain step (action) within a task fails and AutoMate generates an error. This causes the task to notify the Task Service of the failure which allows the task’s error level handing events to occur.

Practical Usage

Provides options to specify what the task should do when an error occurs, such as running another task that corrects the error.

Parameters

Property

Description

E-mail

 

If enabled, an e-mail will be sent upon error. The body of the e-mail will contain details about the error that occurred, including task name, step number, the date/time of when the error occurred, and textual information about the error (if applicable). The default mail server settings configured in System -> Options -> E-Mail tab is used to send the message.

E-mail Settings

Clicking the E-Mail Settings button allows for the following options:

  • To - The e-mail recipient in which to send the message to. This must be a valid e-mail address (for example, GreenTea@networkautomation.com).

  • From -  The "from" email address. Some mail servers require that this be a valid e-mail address (for example, sparky@networkautomation.com), while others allow any text (for example, "AutoMate on Workstation2").

  • Attach Task File - If enabled, the corresponding task (.AML) file will be attached along with the e-mail. This option is enabled by default.

Log File

If enabled, the error that occurs can be sent to a task-specific log file specified by the user. This log file is separate from the AutoMate system Log file.

Log Settings

Clicking this button allows for the following options:

  • Location - The path and file name of the log file.

  • Increment filename - If enabled, this option allows a number to be added to the filename in case the task logs more than one error. For example, when the error initially occurs, information is written to c:\temp\Error.txt. Upon second occurrence, it will write to c:\temp\Error001.txt, the third, it will write to c:\temp\Error002.txt, and so on.

  • Add date and time to filename - If enabled, the date and time when the error occurred will be included in the filename. You can change the date format in the provided text box.

NOTE: If modifying the date format, make sure to omit any special characters that cannot be included in a file name (i.e. <>|?\/).

Run a task

If enabled, another managed task can be executed upon error (identical to the Global Error Handling option Run Task on Error). For example, a default error handling task can be configured to run if an error occurs in the task.

Run Task Settings

Clicking this button allows for the following option:

Task to Run - Specifies the managed task to run. Simply click the down arrow and select the task from the drop-down list that appears.

Windows Event Log

If enabled, error details will be written to Windows Event Log upon error.

See Also

General Properties

Logon Properties

Logging Properties

Priority Properties

Security Properties

Task Isolation Properties

Triggers Properties