Troubleshoot AiResource schema validation errors
When RHDH ingests an AiResource entity, the catalog processor validates the entity against the schema. If a required field is missing or a field value is invalid, ingestion fails and the catalog reports an actionable error that identifies the field to correct.
A valid entity that contains all required fields is accepted and indexed without errors. The following table lists common validation problems and how to resolve them.
| Symptom | Cause | Resolution |
|---|---|---|
|
Ingestion fails with an error that names a missing field, such as |
A required field is missing from the |
Add the missing field, and then register the entity again. |
|
Ingestion fails with an error that identifies |
The |
Set |
|
Ingestion fails with an error that identifies the |
The annotation is missing, or its value does not use the required |
Set |
|
The |
The |
Enable the plugin. See Install the AiResource catalog backend plugin. |
The exact wording of validation messages is determined by the catalog processor. Messages are human-readable and identify the specific field so that you can correct the entity without inspecting source code.