Break error handler

The Break error handler removes the erroring bundle from the scenario flow. Make stores the error message, mappings and the remaining scenario flow as an incomplete execution. Depending on the Break error handler settings, Make finishes the incomplete scenario runs automatically or stores them until you resolve them yourself.

Make processes the rest of the bundles in the scenario flow.

To use the Break error handler in your scenario, you have to enable incomplete executions in scenario settings.

For example: This demo scenario contains five modules. The scenario is useful for tests and showing the effect of an error handler:

1. JSON - Parse JSON provides test data in the form of an array of three record IDs.

2. Iterator splits the array into individual bundles.

3. Data store - Update a record: Updates the data in the data store.

4. Data store - Update a record: This module updates the data again. This time the module works differently. In the module mapping, there is a mapping that intentionally creates an error:

   

   The mapping inserts a null value into the required Key field, which always creates the BundleValidationError.

5. Slack - Send a message: Sends a message to a private testing channel.

This is how the example scenario looks:

When we would run the example scenario, we would get the BundleValidationError:

If we added the Break error handler to the Update a record module, the Break error handler would remove the bundle from the scenario flow. The bundle that caused the error doesn't continue through the rest of the scenario. Instead, Make creates an incomplete execution to store the error type, mappings and the remaining scenario flow.

Make would then process the remaining bundles in the scenario flow.

For more information about error handling strategies check the overview of error handling.

Store the scenario when an error happens

With the Break error handler, you can store the remaining scenario flow in the scenario incomplete executions when an error happens. Make also stores the error message, scenario mappings and data.

You can finish the scenario run in the incomplete executions tab manually or Make can finish the run automatically.

For example, the following scenario outputs an error in the Data Store app module:

To store the scenario as an incomplete execution, follow the steps:

1. Right-click the module that is causing the error. In the menu, select Add error handler.

2. Select the Break error handler.

3. Optional: In the error handler settings, select if you want to automatically finish the incomplete executions. For automatic completions, you can set the number of attempts and the time delay between them.

4. Confirm the Break handler settings with the OK button.

5. Enable storing of incomplete executions in scenario settings.

6. Save your scenario.

You added the Break error handler to your scenario. When an error occurs in the Data store module, Make creates an incomplete execution. The scenario incomplete execution contains the error message, scenario mappings and data.

If you use the automatic scenario completion, Make attempts to finish the scenario automatically.