Task Error Handlers Node

This node, under Server Configuration in the Workflow Administration Console, allows you to have more control over common errors by letting you specify custom handling for the errors.

Example: If Workflow tasks fail because the connection to the Laserfiche Server was lost, error handlers in this node specify how frequently the Workflow Server will retry the tasks.

Show me this node. 

To open this node

1. In the Workflow Administration Console's Console Pane, expand the Server Configuration node.
2. Select Task Error Handlers. The node will list of all the error handlers on the Workflow Server.

Tip: You can refresh this list to reflect recent changes by clicking the Refresh link below Task Error Handlers in the Actions Pane. Alternatively, right-click the Task Error Handlers node and select Refresh.

To add an error handler

1. Select the Task Error Handlers node or any existing error handler in the center Details Pane.
2. Click Add in the Actions Pane, or right-click and select Add.
3. The Configure Task Error Handler dialog box will open so that you can specify when and how the error handler will operate.
4. In the Criteria section, select what error(s) the handler will run on. Specify if the error must have a specific error code, type, or message for the handler to run. If you clear all options in this section or select options but do not specify any values, the error handler will run on all errors.



5. In the Error Handling section,



• Select Retry task on error if you want a task to retry if the error is encountered. Specify how long the task will wait before retrying. Clear this option if you do not want a task to retry after encountering the error.
• Select Critical Error if you want a workflow to terminate when the error is encountered. If you clear this option, the workflow will not automatically terminate. It will either report a warning or terminate based on the severity of the error.
• Select both Retry task on error and Critical Error if you want the workflow to terminate when the maximum number of retries is exceeded.
• Clear Retry task on error and Critical Error if you do not want a task to retry when the error is encountered and you want the error to resolve as a warning, if possible.
6. In the Description section, type a description of the error handler.



7. Click OK.

To modify an error handler

1. In the center Details Pane, select the error handler you want to modify.
2. Click Properties in the Actions Pane, or right-click the error handler and select Properties.
3. The Configure Task Error Handler dialog box will open. See the To add an error handler section above for instructions about how to configure this dialog box.
4. After you make the desired changes, click OK.

To delete an error handler

1. In the center Details Pane, select an error handler.
2. Click Delete under the error's code in the Actions Pane, or right-click the error handler and select Delete.

To enable or disable task error handling

1. In the Workflow Administration Console's Console Pane, expand the Server Configuration node.
2. Select Advanced Server Options.
3. Click Properties in the Actions Pane, or right-click and select Properties.
4. Select the Tasks tab of the Advanced Server Options dialog box.



5. Select or clear Enable task error handling.

To export the contents of this node in a .csv, .xml, or .txt file

1. Select the node in the Console Pane.
2. Select View from the main menu.
3. Click Export Contents.
4. In the Export data dialog box, name the exported file.
5. Select CSV File, XML File, or Tab Delimited Text File from the drop-down menu.
6. Click Save.