OneDrive for Business file server migration troubleshooting for engineering files: breaks recent links

When you migrate engineering files from a file server to OneDrive for Business, recent file links in design tools, project management software, and email attachments often break. This happens because the file path changes from a mapped drive letter or UNC path to a OneDrive URL or a local sync folder path. Engineering teams using CAD, CAM, or BIM software rely on absolute file references that stop working after the migration. This article explains why the file server path change breaks recent links, provides step-by-step methods to restore those links, and lists related failure patterns and their fixes.

Why Migrating Engineering Files from a File Server to OneDrive Breaks Recent Links

Engineering files such as SolidWorks assemblies, AutoCAD drawings, Revit models, and Inventor projects use absolute file paths to reference external components, templates, and related drawings. On a traditional file server, these paths look like \\server\project\part.ipt or X:\drawings\assembly.dwg. When you move the files to OneDrive, the path changes to one of two forms:

• Local sync path: C:\Users\[username]\OneDrive - [tenant]\project\part.ipt
• Web URL: https://[tenant].sharepoint.com/sites/[site]/Shared%20Documents/project/part.ipt

The software’s recent files list stores the old server path. When the software tries to open a file using that path, Windows cannot resolve the drive letter or UNC path, and the software reports a missing file or broken reference. OneDrive itself does not rewrite file paths inside engineering application data. The migration tool, such as Microsoft SharePoint Migration Tool or a third-party mover, copies the file content but does not update references embedded in the file or in the software’s recent files registry.

Steps to Restore Broken Recent Links After Engineering File Migration

1. Identify the old server path and the new OneDrive path
   Open Windows File Explorer on the engineering workstation. Navigate to the old file server location. If the drive letter is still mapped but empty, note the exact path. Then go to the OneDrive sync folder at C:\Users\[username]\OneDrive - [tenant name]. Locate the same folder structure that was on the server. Write down both paths.
2. Clear the software’s recent files list
   Open your engineering application. Go to the recent files menu. In SolidWorks, click File > Recent Documents. In AutoCAD, click the application menu > Recent Documents. Right-click each broken entry and select Remove from List or Remove from Recent. This prevents the software from trying the old path and showing an error dialog every time.
3. Add the new OneDrive path to the recent files list
   In the same software, click File > Open or the Open icon. Navigate to the OneDrive sync folder. Select the engineering file and open it. The software now registers the new path in its recent files list. Repeat this for each file that was referenced in recent documents. For files with external references, such as Xrefs in AutoCAD or derived parts in Inventor, open the parent assembly or drawing first. The software will prompt you to locate missing references. Point each reference to the file in the OneDrive folder.
4. Update hyperlinks and shared links in project documentation
   If you shared links to files on the server through email, project management tools, or internal wikis, those links now point to a dead path. Open OneDrive in a web browser. Navigate to the file. Click the three dots next to the file name, then select Share > Copy link. Paste this OneDrive URL into the email or document. Recipients must have the correct OneDrive or SharePoint permissions to access the file.
5. Use the OneDrive sync app to keep files local
   In the OneDrive sync app, right-click the OneDrive icon in the system tray and select Settings. Go to the Account tab. Under Sync and backup, click Choose folders. Select the engineering project folders that contain the migrated files. Enable Files On-Demand or set the folder to Always keep on this device. This ensures the file path remains consistent on the local machine and the software can find the files without a network connection.
6. Test the restored links
   Close and reopen the engineering application. Open the recent files list. Each entry should now show the OneDrive path. Open each file to verify that external references, materials, and textures load correctly. If a file still shows a missing reference, use the software’s reference manager tool. In SolidWorks, use File > Find References. In AutoCAD, use the External References palette. Update each reference path to point to the OneDrive folder.

If OneDrive Migration Still Breaks Links After Following the Main Fix

OneDrive file names are too long for the engineering software

OneDrive and SharePoint allow file paths up to 400 characters. Some engineering applications have a lower limit, typically 260 characters. When the file path including the OneDrive sync folder root exceeds this limit, the software cannot open the file. To fix this, shorten the folder structure inside OneDrive. Move the files to a folder with a shorter name, such as OneDrive - Company\Proj\Part.ipt instead of OneDrive - Company\Engineering\2024\Q1\Project Alpha\CAD Files\Final\Part.ipt. After moving, repeat the steps to add the file to the recent files list.

OneDrive sync status shows a red X on engineering files

A red X in File Explorer means the file is not syncing. This can happen because the file is open in another application, the file name contains characters that OneDrive blocks, or the file is too large. OneDrive has a file size limit of 250 GB per file. If your engineering file exceeds this, you must split the file into smaller parts or use a different storage solution. Check the file name for invalid characters: ~ " # % & : < > ? / \ { | }. Rename the file if necessary. Then right-click the file in the OneDrive folder and select Sync or Resolve conflict.

Software recent files list does not update after opening the file

Some engineering applications cache the recent files list in the Windows registry at HKEY_CURRENT_USER\Software\[Vendor]\[Application]\Recent File List. If the application is not writing the new path, you can edit the registry directly. Back up the registry first. Locate the key for your application. Change the path value from the old server path to the new OneDrive path. Be careful: a registry error can break the application. Only do this if the normal method does not work and you have confirmed the exact registry key name for your software version.

Item	File Server Path	OneDrive Local Sync Path
Description	UNC path or mapped drive letter	Local folder under C:\Users with tenant name
Example	\\server\projects\assembly.sldasm	C:\Users\jdoe\OneDrive – Company\projects\assembly.sldasm
Access method	Network share or mapped drive	OneDrive sync app or web browser
Offline availability	Requires VPN or offline files	Always available when synced
Link reliability	Breaks if drive letter changes	Stable if folder is synced and path is short

After completing the steps above, your engineering software should open files from OneDrive without broken recent links. To prevent future link breaks, train your team to always open files from the OneDrive sync folder rather than from a web browser. Use the OneDrive sync app’s Always keep on this device setting for active project folders. If you use Microsoft 365, consider enabling Known Folder Move to automatically sync Desktop, Documents, and Pictures, which reduces the chance of users saving files outside OneDrive.