Commit error handler

The Commit error handler stops the scenario run and commits changes in your database apps. If your scenario is not using apps that support transactions, like MySQL or Data store, the Commit error handler just stops the scenario.

The bundle that caused the error doesn't go through the rest of the scenario flow. Make doesn't process the rest of the bundles.

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.

   Having two data store modules doing the same thing, but one of them failing, will make a good example for the Commit and Rollback error handlers.

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 Commit error handler to the Update a record module, the Commit error handler would stop processing the bundle in the scenario and save changes to your data in database apps. Make wouldn't process the remaining bundles.

Let's check the data in the data store as well.

Before running the scenario, the data store contained the following data:

The mappings for the Update a record modules. The first module updates the ID column to the number 4 and the Name column to the text Test 4.

The second module updates the ID column to the number 5 and the Name column to the text Test 5.

After running the scenario, Make would update the data in the data store:

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

Stop the scenario when an error happens

With the Commit error handler, you can stop the scenario when an error happens. Make saves changes in the database apps in your scenario and doesn't process the rest of the bundles in the scenario flow.

Note

Modules that support transactions are labeled with the "ACID" label.

Before you use the Rollback or Commit error handlers, take a look at the auto commit scenario setting first.

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

To stop the scenario and save changes, follow the steps:

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

2. Select the Commit error handler.

3. Save your scenario.

You added the Commit error handler to your scenario. When an error occurs in the Data store module, the scenario stops and Make saves changes in modules that support transactions.