Tetra SharePoint Online Connector v1.1.x Release Notes
The following are release notes for the Tetra SharePoint Online Connector v1.1.x. The Tetra SharePoint Online Connector is a standalone, containerized application that uploads files from SharePoint Online site folders to the Tetra Data Platform (TDP).
v1.1.0
Release date: 20 March 2026
TetraScience has released Tetra SharePoint Online Connector version 1.1.0. This release adds support for non-default document libraries and includes bug fixes for file uploads that have special characters in their filenames.
Here are the details for what's new in Tetra SharePoint Online Connector v1.1.0.
Prerequisites
- SharePoint Online Sites and corresponding document libraries
- Tetra Data Platform (TDP) version 3.6.0 or later
- A Microsoft enterprise application with credentials that the Connector can use along with authorization permissions to access files and their metadata in SharePoint Online sites
New Functionality
New Functionality includes features not previously available in the Tetra SharePoint Online Connector.
- Non-Default Document Library Support: The Connector now supports polling files from non-default document libraries by specifying the optional
driveIdfield in the source path configuration. IfdriveIdis not specified, the Connector polls the default document library, preserving backward compatibility. For more information about how to find thedriveId, see the ConnectorREADMEin the TDP. - Automatic Polling Context Migration: When upgrading from v1.0.0, the Connector automatically migrates existing polling context (delta sync state) to the v1.1.0 internal key format, ensuring incremental sync continues from where it left off, rather than re-syncing all files.
- SharePoint Subsite Configuration: Customers can now configure the
siteIdfor SharePoint subsites using the comma-separatedsiteCollectionId,webIdformat. Subsite support has not been extensively tested across all SharePoint configurations. If you encounter issues, contact TetraScience support. For more information, see Configure the Connector for SharePoint Subsites in the Tetra SharePoint Online 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
The following bugs are now fixed:
- The Connector now handles filenames with special and unicode characters that previously caused the following error when setting Amazon S3 metadata headers during file upload:
TypeError ERR_INVALID_CHAR: Invalid character in header content
Limitations
The following are known limitations of Tetra SharePoint Online Connector v1.1.0:
- The Connector retrieves the latest file version at the time of polling. This means that multiple edits made in SharePoint between polls may be represented as a single version in the TDP.
- If files in SharePoint Online are renamed or moved, then the file version is uploaded as a distinct file at a new file path in the TDP.
- The Connector does not support polling the root directory of a document library.
- If multiple
sourcePathsin the Connector configuration have overlapping paths, files found in multiplesourcePathsmay be uploaded with thesourceTypeand labels of an arbitrary source path. - The Connector supports polling non-default document libraries by specifying the
driveIdin the source path configuration. IfdriveIdis not specified, the Connector polls the default document library. - The Connector uploads checksums from Sharepoint's Graph API to the TDP, but does not verify the SharePoint
quickXorHashhash. Customers seeking additional data integrity verification may verify the hash by using a code snippet like the one found in Code Snippets: QuickXorHash Algorithm in the Microsoft documentation. - Syncing a large SharePoint document library may risk exceeding Microsoft Graph API limits. If the Connector reaches a daily limit, polling may be paused for up to a day because of SharePoint throttling. The Connector will broadcast throttling as a change in health status and a descriptive error. Because of this throttling risk, customers should carefully plan their Connector deployments and manage their enterprise application access credentials. For more information about SharePoint throttling, see Avoid getting throttled or blocked in SharePoint Online in the Microsoft documentation.
- The Connector will try to upload a file version from SharePoint three times before marking the upload as failed. Once a file version is marked as failed, the Connector will not attempt to re-upload it. If an upload error occurs, users can resolve the issue and perform actions like delete and restore the file, change file contents, update SharePoint document library metadata, move the file to a new directory, or rename the file to increase the file version and permit a re-upload of the file to the TDP.
Deprecated Features
There are no new 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 this release.
Upgrade Considerations
Upgrading from v1.0.0 to v1.1.0
Customers can upgrade directly to Tetra SharePoint Online Connector v1.1.0 from v1.0.0 with no configuration changes needed. The Connector automatically migrates existing polling context when it first runs.
Important: The automatic migration for the default document library only occurs when driveId is not specified in your source path configuration. This is because v1.0.0 only supported the default document library (no driveId). If you want to explicitly specify a driveId for the default document library after upgrading, run the Connector once without the driveId first to trigger the migration. Adding a driveId immediately will cause a full re-sync (no duplicates in the TDP, but increased API calls and longer sync times for large folders).
Updated about 7 hours ago
