Introduction to Error Handling

Michal Máša Updated October 02, 2018 19:13

If you are reading this, you are probably familiar with errors that occur during the execution of a scenario. This mostly happens if 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, a default error handling logic is executed as described on the Error processing page.

By adding an error handler route to a module, you can replace the default error handling logic with your own. Integromat offers 5 different directives, any of which can be inserted at the end of your error handler routes. Visit this page to learn about the directives in detail. 

Creating an error handler route

To add an error handler route to a module (let us call it Module X), right click (or touch and hold if you are using a touch screen-device) the module and select Add error handler as shown below:

You will see a list of Directives as well as the apps being used in your scenario. If Module X is the last module in your route, you need to choose one of the directives. Else, you can go on to add one or more modules to your route, in which case, the Ignore directive is applied by default to Module X and in the event of an error, the subsequent modules on that route are processed.  

As you can see below, 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 if the filter "Data Error Takes Place" returns one or more bundles. 

However, if there is no error, the scenario will move to the List all files in a folder module on the regular route. 

Also, to differentiate an error handler route from a regular route, the former is composed of transparent circles as shown above.

The directives are briefly explained below and you may visit the Directives page if you'd like to understand them in detail. 

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

1) The following directives tell Integromat that a scenario execution should continue:

• Resume allows you to specify a substitute output for the module with the error
• Ignore simply ignores the error and there's no output
• Break stores the input to the queue of incomplete executions and there's no output

2) On the other hand, if a scenario execution should be stopped, one of the following directives should be applied depending on how you'd like to handle the error:

• Rollback marks the scenario run as failed and after the specified number of consecutive failed executions, stops the scenario  
• Commit marks the scenario run as successful and stops the scenario immediately

Additional Resources: 

Directives for error handling

Advanced error handling (includes the set up of the Dropbox Scenario referenced above)