Loading

SOQL Field Error in Cache Generation (Invalid Field Reference)

Date de publication: Jun 25, 2026
Description

The Metadata Cache generation fails with a SOQL error referencing an invalid or removed field.

Error example: "No such column 'ContactPointAddress' on entity 'Visit'. If you are attempting to use a custom field, be sure to append the '__c' after the custom field name."

Root Cause

A custom or retired field is referenced in the Object Metadata Cache Configuration SOQL. Custom fields require the __c suffix; retired fields must be removed entirely.

 

Résolution

Resolution Steps:

  1. Navigate to the Object Metadata Cache Configuration:
    • Go to Admin Console > Mobile > Object Metadata Cache Configuration.
  2. Identify the failing record:
    • Look for the record whose SOQL query is causing the error.
    • Open the record and review the SOQL query in the configuration.
    • Note the exact field name referenced in the error message 
  3. Determine the type of field issue:
    • Custom field missing __c suffix: If the field is a custom field, it must end with __c.
    • Retired or removed field: If the field no longer exists on the object, remove the field reference from the SOQL query entirely to prevent future failures.
  4. Edit and save the SOQL query:
    • Update the SOQL query — either append __c to the custom field name or remove the retired field reference.
    • Click Save.
  5. Validate the updated configuration:
    • Use the Validate option on the record to confirm the updated SOQL query runs without errors.
    • If validation passes, proceed to the next step. If it fails, review the SOQL for any additional invalid fields.
  6. Regenerate the Metadata Cache:
    • Trigger a cache regeneration from the Mobile settings.


Numéro d’article de la base de connaissances

005387208

 
Chargement
Salesforce Help | Article