Pega 25.1.x: Resolving "Index Unavailable for Class" for Data Classes Using SRS

General
1

We encountered a scenario where a data class with Custom Search Properties was successfully indexed, but Report Definitions configured with “Use search data (if available)” continued to retrieve data from the database. A guardrail warning,“Index for class is unavailable”, was also displayed.

The root cause was missing SRS configuration prerequisites for data classes. The resolution involved updating the class definition to use RuleForm (Type: Harness, Name: RuleForm), enabling the DSS Pega-SearchEngine/indexer/srs/allowIncrementalIndexingDataClassWithoutAppletHarness=true, synchronizing the search data model, and performing a full reindex. Additionally, all properties used in the Report Definition must be present in the Custom Search Property rule; otherwise, Pega falls back to database retrieval. After these changes, the index became available and Report Definitions successfully retrieved data from SRS

Useful debugging loggers:

  • com.pega.platform.indexer.internal.publication.model.LoggingTroubleshooter
  • com.pega.platform.indexer.internal.publication.model.conflict.ConflictReporter
  • com.pega.platform.search.infrastructure.internal.srs.SRSConnectorImpl

Tracing the Report Definition and reviewing the DB Query event type is an effective way to confirm the functionality.

1 Like