Skip to content
Suggest a correction

Configuration and validation classes (L2)

Reference7 min read

Find the internal Record Health Check classes that load Check Sets and Checks, identify invalid configuration, and define the allowed values and limits the package uses. These are package implementation classes; code in your org uses the global API in Run Record Health Check from Apex.

Use the Apex class reference to place these configuration and validation classes in the full package structure.

Role: Load Check Sets and Checks and convert configuration problems into health-check results.

Type: Service class · public with sharing

Queries Check Set and Check Custom Metadata, builds Lightning definition responses (including limiting a run to FRAMEWORK_MAX_CHECKS), reports Check Set availability for a Salesforce object, resolves a Check’s parent Check Set, loads Checks for evaluation, and maps the first RecordHealthCheckValidator finding into an UNABLE_TO_EVALUATE / INVALID_CONFIG result.

Key members:

MemberPurpose
ConfigException (nested)Exception carrying reasonCode
RC_*Shared Reason Code constants, such as RC_CONFIG_INACTIVE, RC_OBJECT_MISMATCH, and RC_NO_ACTIVE_CHECKS
findCheckSetQualifiedApiName(...)Resolve an exact Check Qualified API Name to its parent Check Set Qualified API Name
getCheckSetAvailabilityForObject(...)Active/inactive Check Sets for an object
getCheckSetShellConfig(...)Return the card heading and button settings before Check definitions load
getDefinitionResponse(...)Build the Lightning definition response through RecordHealthCheckDefinitionLoader
validateCheckForEvaluation(...)Map the first validator finding to a result
loadCheck(...)Load a Check for evaluation

Notable behavior:

  • getDefinitionResponse rejects a blank CardTitle__c with INVALID_CONFIG. It does not substitute Label or Developer Name for the card title an administrator must provide. When a Check Set has more than 25 active Checks, it returns FRAMEWORK_MAX_CHECKS_EXCEEDED before the Lightning card receives a partial definition list.
  • loadCheck selects the complete evaluation contract plus presentation fields such as Category, including optional fields that are blank, so downstream consumers do not encounter an unqueried-field exception.
  • Identity lookups bind exact Qualified API Names. They do not select the first matching Developer Name, so shared names in different namespaces cannot resolve to the wrong configuration.

Role: Resolve a Check prerequisite to its namespace-safe qualified identity.

Type: Shared helper · public with sharing

The Lightning definition loader uses this helper after loading the active Checks in a Check Set. When managed and subscriber metadata reuse a Developer Name, it prefers the prerequisite from the dependent Check’s namespace. It returns the only unambiguous match as a compatibility fallback and returns null when the prerequisite is absent or cannot be resolved safely.

Key members:

MemberPurpose
resolve(dependent, checks)Return the prerequisite Check’s qualified API name without collapsing namespace identities

Role: Apply the same Check-field rules to every Evaluation Type.

Type: Shared validator · public with sharing

Returns ordered Finding values using the FindingCode enum. When a Check runs, RecordHealthCheckConfigService uses the first finding to return one clear configuration result. The metadata audit collects every finding so package maintainers can correct all configuration problems together. Both paths therefore use the same validity rules.

Notable behavior:

  • MaxQueryRows__c, EmptyValueHandling__c, and NoRowsResult__c are checked separately from the Query and Compare two queries field groups. This prevents the metadata audit from reporting the same field problem twice. Mutually exclusive choices use one decision chain so the audit returns at most one finding for a field.

Role: Keep Apex Check validation precedence and authoring issue mapping consistent.

Type: Shared helper · public with sharing

Returns Apex-specific RecordHealthCheckValidator.Finding values in class-name, parameter, resolve, constructor, and interface order. It also maps those findings to metadata-audit fields, messages, and stable Reason Codes. Separating this concern keeps both shared validator classes below their review-size ceiling without creating a second decision tree.

Role: Audit every Check Set and Check, active or inactive, before activation or release.

Type: Service class · public with sharing

Validates every Check Set and Check in the org, including inactive ones, and returns ValidationIssue rows (ERROR / WARNING) with component name, field, message, and Reason Code. An empty list means the audit passed. The Validate Record Health Check Configuration Flow action calls it, so administrators can audit configuration before activating it or moving it between orgs.

The class is public, not global. That means other package classes can call it, but Apex created in an org that installs Record Health Check cannot call it through the rhc namespace.

Key members:

MemberPurpose
validate()Validate every Check Set and Check in the org, including inactive ones
validateRecords(...) (private)Validate Check Set and Check records supplied by validate() or package tests

Notable behavior:

  • validateRecords reports a Check Set with more Checks than RecordHealthCheckConstants.FRAMEWORK_MAX_CHECKS (25) as ERROR/FRAMEWORK_MAX_CHECKS_EXCEEDED. It counts inactive Checks too, although its message says active, so 25 active Checks plus an inactive draft fail validation while every run succeeds. Salesforce can save the additional Checks, but every whole-set runtime rejects the configuration before evaluation begins.
  • When an automatic card hides Run and Rerun through either Run Button Display or Card Heading Display, users cannot publish lifecycle events from the card. The audit returns WARNING/USER_RUN_PUBLICATION_UNREACHABLE when Check Set publication is enabled and WARNING/USER_RESULT_PUBLICATION_UNREACHABLE for each Check whose publication is enabled. Apex and Flow can still publish, so these findings are warnings rather than errors. RecordHealthCheckMetadataSetValidator produces these Check Set-level findings.

Role: Provide validation helpers used by more than one package class.

Type: Shared helper · public with sharing

Finds the first merge-token issue, checks Salesforce object API names, validates and creates Apex Check classes with isValidApexPlugin and takeValidatedPlugin, and confirms that Apex parameters contain a JSON object. Both the health-check run and the metadata audit use these helpers.

Notable behavior:

  • isValidApexPlugin creates an instance of the class while validating it, then saves that instance in validatedPluginInstances by class name; takeValidatedPlugin retrieves and removes it so RecordHealthCheckApexEvaluator can reuse the already-built plugin instead of calling newInstance() a second time. isJsonObject treats a blank string as valid (returns true) because ApexParametersJson__c is optional. Only a non-blank value that fails to parse as a JSON object is rejected.

Role: Store the package’s allowed values and numeric limits in one place.

Type: Constants holder · public with sharing

Owns FRAMEWORK_MAX_CHECKS (25), FRAMEWORK_MAX_ROWS (2,000), and Set accessors that return a copy for display modes, trigger/reveal modes, Evaluation Types, operators, null/empty behaviors, severities, applicability modes, and related allowed-value lists. The health-check run and metadata audit both read from here so their allowed values stay aligned.

Notable behavior:

  • The package needs one approved list of values. Every public static Set<String> accessor here returns a new Set<String>(...) copy, not the internal set itself. A caller therefore cannot overwrite the package’s official values by changing the returned Set. The class also owns the Apex-to-Lightning-card value translation (toLwcTriggerMode, toLwcEvaluatorType, etc.) that maps metadata API values (for example FORMULA) to the card’s presentation terms (for example Formula). Severity is not translated: CRITICAL, WARNING, and INFO reach the card as Setup stores them, and the card chooses its own words for them.

Role: Identify Reason Codes that contain access details and should appear only in diagnostics.

Type: Constants holder · public with no sharing keyword because it does not query records

Declares commonly referenced codes, such as applicability and access codes. The isDiagnosticsOnly method identifies codes that should be available for troubleshooting but hidden from users who are not allowed to see the underlying access details. The full outcome list is in Reference: Reason Codes.

Key members:

MemberPurpose
isDiagnosticsOnly(reasonCode)Whether a reason code should be treated as diagnostics-only

Notable behavior:

  • DIAGNOSTICS_ONLY contains exactly FIELD_NOT_ACCESSIBLE and RECORD_NOT_ACCESSIBLE. These Reason Codes can reveal field-access or record-sharing details. isDiagnosticsOnly(reasonCode) returns true for either code.

Role: Tell the Lightning card whether the current object has active or inactive Check Sets.

Type: Data holder · public with no sharing keyword because it does not query records

Used when the Lightning card has no Check Set selected.

Key members:

MemberPurpose
hasActiveWhether the object has any active Check Sets
hasInactiveWhether the object has any inactive Check Sets

Notable behavior:

  • The constructor with no parameters sets both @AuraEnabled Boolean fields to false. A caller that returns early before filling them in (for example RecordHealthCheckController on a null recordId) therefore still returns a valid response to the Lightning card.