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
documentFiltersconfiguration 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
ANDlogic within filter objects,ORlogic between filter objects, andORlogic for array values within a key - Default behavior: When
documentFiltersis set to[]or not configured, all documents from opted-in studies are ingested
- Document-level fields:
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.
Updated about 2 hours ago
