Contents:
Overview
Most backlogs resolve themselves after LeanData processes the records. However, sometimes a backlog occurs when records fail to process due to an Apex error.
This article explains some common errors you may encounter and provides steps to resolve the backlog.
Common Errors
- APEX error due to an invalid field reference in LeanData jobs
- APEX error due to missing field permissions for the LeanData Integration User
Troubleshooting Example
1. Navigate to LeanData > Routing > [Object Name] > Audit Logs and check for backlogs caused by Apex error failures. A yellow banner above the Audit Logs will show the number of CCIOs by object type that have failed to process.
2. From Salesforce Setup, navigate to the Apex Jobs page. Create a view that filters for the Apex Class LeanDataContinuousBatch. For more information on checking Apex Jobs, please see Checking LeanData Apex Jobs.
3. Review these Apex Jobs for failures. Check the Batch Detail column for messages containing failure details.
Example 1
In this example, the error message indicates a problem with the "Example_Field__c" field on the Lead object.
No such column ‘field name’ on entity ‘object name’. If you are attempting to use a custom field, be sure to append the ‘__c’ after the custom field name
The failure message confirms that the Lead field "Example_Field__c" referenced in the Apex Job error has been deleted.
Navigate to the area of LeanData where this deleted field is referenced. You may find it in either the LeanData matching Mapped Account field settings or in a routing graph. Remove the field from its location and save your changes. If you're working in the routing graph, remember to save and deploy a new graph.
After resolving the deleted field reference, open the LeanData App and navigate to Routing > [Object Name] > Audit Logs. Click the Retry Processing button on the yellow banner.
Example 2
First error: LeanData integration user does not have permission to Read fields: {Object name = { Field API name }}
This error indicates that the LeanData Integration User lacks permission to read the specific field mentioned in the error.
Contact your Salesforce administrator to grant the required field permissions for the LeanData integration user.
Once the field permission has been granted, navigate to Routing > [Object Name] > Audit Logs from the LeanData App and click the Retry Processing button on the yellow banner.
For questions or additional assistance please contact LeanData Support.