Introduction
Automate provides three levels in which it can automatically detect and handle errors. They include the System (or Global) Level, Task Level and Step Level. Furthermore, Automate includes different options for each level to handle errors when they occur. How Automate reacts to an error and what can be done when one occurs depends on how its 'Error Handling' parameters are set in the managed task's properties.
Flow of Error Handling
Each step has its own set of errors that can occur based on the purposes of the action itself. Additionally, every available action in Automate contains two special tabs called 'Error Causes' and 'On Error.' If an error occurs, the step checks the 'Error Causes' tab to verify whether or not the error should be handled (by default all errors of a step are handled). If the error is to be handled, the step examines the settings of the 'On Error' tab and executes each option chosen. Finally, the step checks whether the 'Flow Control' tab is set to "Stop Task" or "Continue Task" upon error. More details regarding the 'Error Causes' and 'On Error' tabs are listed below.
Tri-Level Error Detection and Handling
System Level
Automate can handle errors globally for all tasks that run on a system. If this option is enabled, Automate will act upon ALL managed tasks that fail with an error. The settings for Global Error Handling can be configured in the Task Administrator by going to 'System' -> 'Options' -> 'Task Errors' tab. The available options are:
Task Level Error Detection and Handling
As part of Automate's "tri-level" error handling, errors may be handled on a per task basis. This is ideal if the user wants Automate to perform specific error handling procedures for a managed task. A task level error occurs when a step 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. Task Level Error handling can be configured in each task's Managed Task Properties window under the 'Errors' tab. The available options are:
Step Level Error Detection and Handling
Errors may be handled on a per step basis as well. Normally, any failure of a step within a task causes a step error. What causes a step to fail is, however, dependent on the step and it's parameters. These parameters can be adjusted under the 'Error Causes' tab of any Automate step. If a step fails, the user can select from a number of actions to be carried out. These actions are located in the 'On Error' tab of any specific step.
Error Causes Tab
Every available action in Automate includes an 'Error Causes' tab. The 'Error Causes' properties allows the task developer to determine what conditions Automate should consider an error for each step. During task execution, if one of these conditions is met, the specified actions in the 'On Error' tab (also available in every available action) are carried out. The following options are included under the 'Error Causes' tab:
The following should cause this step to fail...
- Any Error: Any problem encountered during step execution will cause the instructions specified in the On Error tab to be carried out.
- Only Certain Errors: Only the errors selected from the list of possible errors will cause the instructions specified in the On Error tab to be carried out. Any other errors are ignored.
If this step takes more than this many milliseconds to complete:
When checked, this option acts as a timeout value for the step. For example, if a SQL Query step is being executed and this value is set to 5000 milliseconds and the query took longer than 5 seconds, the step would error and the instructions in the 'On Error' tab would be carried out.
On Error Tab
The 'On Error' tab allows the task developer to determine what Automate should do if a particular step encounters a problem as defined in the 'Error Causes' tab. The following options are:
If the step fails, the following actions should be carried out...
Retry the step X times then: This allows the task developer to specify that the step should be retried a specified number of times before actually considering it a true step failure. When enabled, the step will attempt to retry execution by number of times specified. If after these retries the step still fails, the remainder of the actions below will be carried out.
Flow Control
Stop Task: The task should stop if an error occurs (as defined in Error Causes) during execution of this step.
Continue Task: The task should continue if an error occurs (as defined in Error Causes) during execution of this step. This option if useful if one if the following conditions are true:
Applies To: Automate 5, Automate 6
Still have questions? We can help. Submit a case to Technical Support.