ÃÛ¶¹ÊÓƵ

Error handling in ÃÛ¶¹ÊÓƵ Workfront Fusion

When errors occur during the execution of a scenario, it’s usually because a service is unavailable due to a failure, a service responds with unexpected data, or the validation of input data fails.

If a module throws an error during the scenario execution and there is no error handling route attached to the module, the default error handling logic executes, as described in Error processing in ÃÛ¶¹ÊÓƵ Workfront Fusion.

By adding an error handler route to a module, you can replace the default error handling logic with your own. ÃÛ¶¹ÊÓƵ Workfront Fusion offers five different directives that can be inserted at the end of your error handler routes.

For more information, see Directives for error handling in ÃÛ¶¹ÊÓƵ Workfront Fusion.

Access requirements

You must have the following access to use the functionality in this article:

ÃÛ¶¹ÊÓƵ Workfront plan*
Pro or higher
ÃÛ¶¹ÊÓƵ Workfront license*
Plan, Work
ÃÛ¶¹ÊÓƵ Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration

Product

Current product requirement: If you have the Select or Prime ÃÛ¶¹ÊÓƵ Workfront Plan, your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article.

To find out what plan, license type, or access you have, contact your Workfront administrator.

For information on ÃÛ¶¹ÊÓƵ Workfront Fusion licenses, see ÃÛ¶¹ÊÓƵ Workfront Fusion licenses.

Error handler route

To add an error handler route to a module:

  1. Right click the module and select Add error handler:

    The module shows a list of Directives as well as the apps being used in your scenario.

  2. If the module that you added an error handler to is the last module in your route, select one of the directives.

    Or

    Add one or more modules to the error handler route.

    If you add more modules to the route, the Ignore directive is applied by default, and, in the event of an error, the subsequent modules on that route are processed.

INFO
In this example, if an error occurs while executing the Create a folder module, the Ignore directive will be applied automatically and the scenario will move to the next module on the error handler route.
However, if there is no error, the scenario will move to the List all files in a folder module on the regular route.

Note that an error handler route is composed of transparent circles, while a regular route is composed of solid circles.

Error handling directives

The directives are briefly explained below. For more information, see Directives for error handling in ÃÛ¶¹ÊÓƵ Workfront Fusion.

There are a total of five directives which can be grouped into the following categories based on whether a scenario execution should continue or not.

The following directives ensure that a scenario execution continues:

  • Resume: Allows you to specify a substitute output for the module with the error. The scenario execution status is marked as success
  • Ignore: ignores the error. The scenario execution status is marked as success
  • Break: Stores the input to the queue of incomplete executions. The scenario execution status is marked as warning. For more information, see View and resolve incomplete executions in ÃÛ¶¹ÊÓƵ Workfront Fusion.

If a scenario execution should stop when an error occurs, use one of the following directives:

  • Rollback: Stops the scenario execution immediately and marks its status as error
  • Commit: Stops the scenario execution immediately and marks its status as success

For more information on error handling, see:

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43