Tetra Charles River Apollo Connector v1.1.x Release Notes

The following are the Tetra Charles River Apollo Connector release notes for versions 1.1.x. The Connector is a standalone, containerized application that uses the Pluggable Connector Framework to automatically retrieve documents from the Charles River Laboratories Apollo API and upload them to the Tetra Data Platform (TDP).

v1.1.0

Release date: 2 March 2026

TetraScience has released Tetra Charles River Apollo Connector version 1.1.0. This release introduces document filtering capabilities, allowing users to control which documents are ingested based on field values, such as document type, GxP status, study site, and more.

Prerequisites

Tetra Charles River Apollo Connector v1.1.0 requires the following:

  • TDP version 3.6.0 or later
  • A Charles River Apollo API account with the following credentials:
    • Client ID
    • Client Secret
    • Subscription Key (Ocp-Apim-Subscription-Key)
    • OAuth Token URL
    • OAuth Scope
    • Base API URL
  • IP allowlisting configured in the Charles River Apollo API firewall for your TDP environment's IP addresses
  • Charles River Apollo Study Opt-In Manager pipeline v1.0.0 or higher deployed and configured in your TDP environment
  • An AES-256 encryption key for encrypting study IDs and sponsor emails (required by the Charles River Apollo Study Opt-In Manager pipeline, not the Connector itself)

New Functionality

New functionality includes features not previously available:

  • Document Filtering: A new, optional documentFilters configuration parameter provides users the ability to control which documents are ingested based on field values. Users can filter documents by the following fields:
    • Document-level fields: documentType, status, contentType, primaryStudyContact, crlStudyId, name
    • Study-level fields: gxpFlag (boolean), crlSite, studyName, studyStatus
    • Filter logic: supports AND logic within filter objects, OR logic between filter objects, and OR logic for array values within a key
    • Default behavior: When documentFilters is set to [] or not configured, all documents from opted-in studies are ingested
    For more information, see Document Filtering in the Tetra Charles River Apollo Connector User Guide (v1.1.x).

Enhancements

Enhancements are modifications to existing functionality that improve performance or usability, but don't alter the function or intended use of the system.

  • There are no enhancements in this release.

Bug Fixes

There are no bug fixes in this release.

Limitations

The following are known limitations of the Tetra Charles River Apollo Connector v1.1.0:

  • IP Allowlisting Required: The Charles River Apollo API requires IP allowlisting. Tetra Data Platform (TDP) IP addresses must be allowlisted in the Charles River Apollo API firewall configuration before the Connector can be used.
  • Manual Study Opt-In: Opting into studies is a manual process that requires uploading a CSV file with study IDs and sponsor email addresses to the Charles River Apollo Study Opt-In Manager pipeline.
  • Opted-In Studies Only: The Connector only downloads documents from studies that have been opted into via the Charles River Apollo API. Documents from studies that have not been opted into will not be retrieved.
  • Conservative Filter Behavior: For study-level filters (gxpFlag, crlSite, studyName, studyStatus), if the study is not found in the connector's study cache at the time of filtering, the document is excluded (not ingested). The study cache is refreshed each polling cycle, so a temporarily missing study will be retried on the next poll.

Deprecated Features

There are no deprecated features in this release.

For more information about TDP deprecations, see Tetra Product Deprecation Notices.

Known and Possible Issues

There are no known issues in Tetra Charles River Apollo Connector v1.1.0.

Upgrade Considerations

This version is compatible as a direct upgrade from Tetra Charles River Apollo Connector v1.0.x. To upgrade the Connector, follow the instructions in Tetra Charles River Apollo Connector User Guide (v1.1.x).

Other Release Notes

To view other Tetra Connector release notes, see Tetra Connector Release Notes.