Link Detection and Remediation Technical Specifications
On This Page
Overview
This page is the technical reference for DryvIQ’s Link Detection and Remediation feature. It defines what is and is not supported, including supported file types, link formats, platforms, and known limitations.
Feature Reference Documentation
This page does not explain how to use the Link Detection and Remediation feature in the DryvIQ Platform. For usage instructions, refer to Link Detection and Remediation.
Scope and Processing Constraints
Link Detection and Remediation operate within a defined set of global constraints. These rules apply regardless of platform or file type and explain why some files or links may not be processed.
Only the latest version of each file is processed: Link detection and remediation operate only on the current (latest) version of each file when the job runs.
Previous file versions are not scanned.
Links that exist only in older versions will not be detected or remediated.
Files must be readable for content inspection: To detect and update links, DryvIQ must be able to open and read the file contents. If DryvIQ cannot read the file (due to source system limitations, connector limitations, access restrictions, file corruption, etc.), it cannot perform link detection and link remediation on that file.
Detection and remediation apply only to files within the job scope: A file must be included in the current migration job for its links to be detected. A link can only be remediated if the target item is also part of the same job or another completed migration job. If a link points to content outside the scope of all migration jobs, DryvIQ cannot determine its destination location or remediate it. These links are reported with an appropriate remediation status and can be exported from the Links report to support manual remediation once the linked content is migrated or otherwise made available in the destination.
Job filters affect what is scanned: Job-level filters apply to link detection. If a file is excluded by filters, it is not scanned for links. Any links inside excluded files will not appear in link reports and cannot be remediated.
External and out-of-scope links cannot be remediated: Links pointing to external websites, systems not included in the migration, or content not part of any job may be detected, but they cannot be remediated because there is no destination item to map them to.
Supported File Types
Link Detection and Remediation supports the following file types:
Microsoft Files: DOCX, PPTX, and XLSX (available in Microsoft Office 2007 and newer)
Google Files: Google Docs, Google Sheets, and Google Slides. Link detection occurs after export to Microsoft Office format during transfer; only links preserved by Google's export process are detected.
Supported Link Types
Links are stored differently depending on how they are added to a document. Link Detection and Remediation operate only on specific, supported link types. The table below defines which link types are supported for detection, remediation, or neither. Support is based on how the link is stored in the file, not on the destination system. For example, a hyperlink pointing to SharePoint, Box, a file share, or a website is treated the same way when stored as a standard hyperlink. Links to external websites and other non-migrated destinations are detected but are not remediated, as they do not represent migrated content.
Link Type | Detected | Remediated | Notes |
|---|---|---|---|
Standard Hyperlinks | Yes | Yes | Typical clickable links inserted using an application's Insert Link or equivalent feature. Hyperlinks can be HTTP/HTTPS/FTP/FTPS URLs or links to files. |
Plain text URLs | No | No | URLs that appear as text but are not stored as structured hyperlinks. These are not stored as document relationships and are not detected. |
Formula-based links (for example, in spreadsheets) | Yes | Yes | Applies only to formula-based links that are stored as OPC relationships (for example, external workbook references such as
Links embedded directly in formula text (such as Excel |
Embedded object links (pictures, OLE objects, media, etc.) | No | No | Links embedded as objects are not supported. These are stored as object or binary relationships, not as standard external link relationships. |
External data connections (for example, pivot external data sources) | No | No | These are not treated as document links and are not processed by link detection or remediation. |
Hyperlinks vs. Embedded Objects
DryvIQ supports the remediation of embedded links, meaning standard clickable hyperlinks (URLs) included in document text.
DryvIQ does not remediate embedded objects, such as inserted images, attachments, or OLE content, because these are stored as binary content rather than URL-based links.
Connector Support
Link detection and link remediation behave differently across connectors. Link detection operates directly on file content and is supported across all connectors for supported file and link types. In contrast, link remediation requires DryvIQ to interpret and resolve link URLs using connector-specific capabilities.
Link Detection
Link detection is connector-agnostic. DryvIQ scans supported file types (such as .docx, .xlsx, and .pptx) and extracts embedded links directly from the file content, regardless of the source or destination connector.
Link Remediation
Link remediation is connector-dependent and supported only with connectors that can interpret and resolve link URLs. If a connector does not support this capability, links will be detected but not remediated.
Connectors With Link Remediation Support
DryvIQ supports both link detection and link remediation for the following connectors:
Box/Box Service Account
Dropbox for Business/Dropbox Teams Folders
Egnyte
File System (NFS/SMB)
Google Drive/Shared Drive/Workspace
Microsoft Office 365/OneDrive/Teams (Standard and GCC High)
Nasuni
Connectors Without Link Remediation Support
For connectors that do not support URL resolution, DryvIQ supports only link detection. Links will be identified and reported but cannot be automatically remediated. If a connector is not listed as supporting link remediation, it should be considered detection-only. This includes, but is not limited to:
Amazon S3
Autodesk
Citrix Sharefile
Documentum
Docusign
Google Cloud Storage
Hitachi
Opentext
Procore
SFTP
Syncplicity
URL Resolution
Link remediation depends on the ability to resolve a link to a destination item. If a connector cannot interpret the link format, links will be reported with a remediation status such as Unsupported and must be updated manually.
Supported Platform URL Formats
Link remediation is supported for the following platforms and link types.
Box
If the link in your document points to a Box file or folder, including links created using Box’s Office Online integration, DryvIQ can remediate it. Otherwise, DryvIQ can’t update it.
Box Link Type | Box Link Formats |
|---|---|
Direct file link | https://<tenant>.app.box.com/file/<platform id> |
Direct folder link | https://<tenant>.app.box.com/folder/<platform id> |
Shared link to a file | https://<tenant>.app.box.com/s/<SharedFileID>> |
Shared link to a folder | https://<tenant>.app.box.com/s/<SharedFolderID>> |
Direct file download link | https://<tenant>.box.com/shared/static/<ID> |
Box’s Office Online integration link | https://<tenant>.app.box.com/integrations/officeonline/openOfficeOnline?fileId=<platform Id>&sharedAccessCode=> |
Dropbox
DryvIQ can remediate a link to a Dropbox file using a direct preview link. DryvIQ will also remediate a shared link only when Dropbox is the source connection. It treats the shared link as a native-item link and does not create a new shared link on the destination.
Dropbox Link Type | Dropbox Link Formats |
|---|---|
Direct link to file | https://dropbox.com/home/<path>?preview=<filename> |
Direct link to folder | https://dropbox.com/home/<path>/<foldername>/ |
Shared link to a file |
Older Dropbox Shared Links
Dropbox has older shared link formats, but DryvIQ does not guarantee remediation for these formats. Even for the supported shared link format, certain scenarios (such as changing the ownership of items pointed to by a shared link) may affect DryvIQ’s ability to remediate shared links.
Egnyte
DryvIQ supports the remediation of several Egnyte link formats that reference files or folders stored in Egnyte. These links are typically generated when users copy links from the Egnyte web interface or share content with others.
Egnyte Link Type | Egnyte Link Formats |
|---|---|
Direct File Link | https://<egnyte-domain>/app/index.do#storage/file/<GroupId> https://<egnyte-domain>/navigate/file/<GroupId> |
File Download Link | https://<egnyte-domain>/opendocument.do?entryId=<EntryId>&cache-buster=<Value> |
Shared Folder Link | https://<egnyte-domain>/fl/<FolderShareId> |
DryvIQ can remediate links in documents that point to a supported Google file type, such as Docs, Sheets, Slides, or Drive file and folder URLs.
Google Link Type | Google Link Formats |
|---|---|
Google Docs File | https://docs.google.com/document/d/<FileID>/edit> |
Google Sheets File | https://docs.google.com/spreadsheets/d/<FileID>/edit |
Google Slides File | https://docs.google.com/presentation/d/<FileID>/edit |
Google Drive File |
|
Google Drive Folder | https://drive.google.com/folder/d/<FolderID> |
Microsoft
For OneDrive and SharePoint, DryvIQ currently remediates only file-based links. This means DryvIQ can update links that point directly to documents (such as Word documents, Excel workbooks, and PowerPoint presentations).
Links pointing to folders or entire SharePoint sites are detected but not remediated automatically. If your documents contain folder paths or site URLs, those links will need to be updated manually after the migration to ensure they point to the correct locations.
Microsoft Link Type | Microsoft Link Formats |
|---|---|
Links to personal or user-owned files stored in the OneDrive document library | https://<tenant>-my.sharepoint.com/:w:/r/personal/<UserOneDrive>/_layouts/15/Doc.aspx?sourcedoc={<PlatformId>}&file=<Filename>&action=default&mobileredirect=true |
Links to team-based or site-owned files stored in libraries managed by SharePoint sites |
|
Network File System and Nasuni
DryvIQ supports the detection and remediation of file-based links in content stored on NFS-based file systems.
NFS Link Type | NFS Link Formats |
|---|---|
Absolute file links |
|
Relative file links |
|
Network File System Link Updates
When remediating Network File System links, DryvIQ updates them to use the absolute format (file://).
Application-Specific Behavior
Different applications store links in different ways. In some cases, features that appear to create “links” actually embed or import content, which removes the ability to detect or rewrite the original reference.
This section describes application-specific behaviors and limitations that affect link detection and remediation.
Application | Supported | Not Supported |
|---|---|---|
Microsoft Excel |
|
|
Microsoft Word | Standard hyperlinks (Insert → Link) |
|
Microsoft PowerPoint | Standard hyperlinks (Insert → Link) |
|
Google Sheets | Standard hyperlinks (Insert → Link) that are preserved when exported to Microsoft Excel (.xlsx) format | Plain text URLs that are not stored as links. Link detection occurs after export to xlsx format; links must survive Google's export process to be detected. |
Google Docs | Standard hyperlinks (Insert → Link) that are preserved when exported to Microsoft Word (.docx) format | Plain text URLs that are not stored as links. Functions or smart chips that dynamically construct URLs. Link detection occurs after export to docx format; links must survive Google's export process to be detected. |
Google Slides | Standard hyperlinks (Insert → Link) that are preserved when exported to Microsoft PowerPoint (.pptx) format | Plain text URLs that are not stored as links. Link detection occurs after export to PPTX format; links must survive Google's export process to be detected. |