Configure Error Handling in EDA

Overview

Certain K-12 Architecture Kit jobs, such as most Apex jobs, run asynchronously in the background so they don't impact critical processes.

K-12 Architecture Kit includes error handling for these types of jobs, but the results aren't stored, by default. If you want to store the results of asynchronous jobs so you can view them at a time that's convenient for you, in EDA Settings, update the Error Handling setting.

Note For an example of the types of jobs you can monitor this way, go to the Scheduled Jobs tab in Setup and look for jobs that are Submitted By K-12 Architecture Kit.

K-12 Architecture Kit doesn't include error handling for code that runs synchronously because it can cause these types of problems:

• Masking errors for other applications: If the error handler catches the exception, the transaction succeeds from a platform perspective. But if the application doesn't know that the transaction failed, it won't retry it or take further action.

• Losing your save points: All of EDA's logic gets routed through the Trigger Handler dispatcher class. The run method is static, however a save point isn't static. This could mean that Trigger Handler runs get lost.

• Using up your DML limits: Every time you set up a save point, you consume a DML statement. Learn about Apex limits in Execution Governors and Limits in the Apex Developer Guide.

We recommend that you avoid generic error handling for synchronous jobs.

Error Handling Configuration Options

Configure asynchronous error handling using these settings from the Errors page in EDA Settings.

Store Errors

Select to store errors on the Error object. To access stored errors, see Configure Error Tracking.

Error Notifications

Select to post notifications to all System Administrators, a single user, or a Chatter Group when errors occur.

Error Handling

Select to allow error handling for asynchronous jobs, making it easier to see when scheduled jobs fail.

Debug Logging

Select to enable Salesforce support to view debug statements for managed packages.

Configure Error Tracking

To access errors stored after enabling the Store Errors setting, add the Error custom object to your Education Data Architecture app.

1. Click , then click Setup.

2. Enter Tabs in the quick find box, then select Tabs.

3. In the Custom Object Tabs section, click New.

4. Select Error as the Object, choose a tab style, and then click Next.

5. Set the tab visibility to Default On for your System Administrator profiles and Default Off for all other profiles. Then click Next.

6. Add the tab to the Education Data Architecture app. Deselect the Include Tab checkbox to clear any existing selections, then select the checkbox just for the Education Data Architecture app. 

7. Save your changes.

   Now the Education Data Architecture app includes an Errors tab that you can use to review errors.