Katalyst: “No materials found” error in Katalyst when importing from an external materials source

Description

• Users attempt to search or import materials from an external source (e.g., corporate compound repository, reagent database) in Katalyst.
• The search returns “no materials found” or an empty list, even for known IDs or CAS numbers that exist in the external system.
• Other data sources or local materials may still work.

Solution

• Check the Katalyst configuration for the external materials source:
  • Endpoint URL, authentication parameters, and any query filters.
  • Timeouts and error handling settings.
• Test the external service independently:
  • Call the service using a REST client or similar tool with the same query Katalyst would send.
  • Confirm whether it returns results or errors.
• Common issues:
  • Schema or index changes in the external system (e.g., new field names, different “schema_type” values).
  • Authentication or permission changes that prevent Katalyst’s service account from accessing data.
• Adjust the query or configuration:
  • Update the query body to match the external schema, e.g., filter by correct schema_type or fields.
  • Ensure the service account has permission to access the required datasets.