TL;DR; Explains how to resolve the “unable to find a unique local path” error in TFS Integration Tools during source control migration, including causes and practical workarounds.
When you are doing a Source Control migration using the TFS Integration Platform you receive a “unable to find a unique local path” runtime conflict.
Figure: You get a “MigrationException: unable to find a unique local path”
At this point the migration fails and you are unable to continue.
In order for the TFS Integration Platform to minimise the likelihood of hitting the 258 character limit of Windows it shortens the mapped path.
Figure: Shortened Local Folders
This works only when there are enough characters after the last “” to be able to get a distinct path. If there are no enough characters then a Local path is unable to be mapped and the exception results.
The duplicates tend to come from multiple applications being stored under a single Team Project and all being mapped at once. If you chop your list of migrations down to a smaller list you are less likely to get duplicates.
Figure: 
Bad example, chance of collision is very high
Reduce the number of mappings by grouping them. You still want to include all of the things within a branch structure together, but make sure that you have distinct names.
Originally published at Where Technology Meets Teamwork by Martin Hinshelwood , Senior ALM Consultant. ( source )
Each classification [Concepts, Categories, & Tags] was assigned using AI-powered semantic analysis and scored across relevance, depth, and alignment. Final decisions? Still human. Always traceable. Hover to see how it applies.
If you've made it this far, it's worth connecting with our principal consultant and coach, Martin Hinshelwood, for a 30-minute 'ask me anything' call.
We partner with businesses across diverse industries, including finance, insurance, healthcare, pharmaceuticals, technology, engineering, transportation, hospitality, entertainment, legal, government, and military sectors.
NIT A/S
Genus Breeding Ltd
Higher Education Statistics Agency
Philips
Schlumberger
New Signature
Flowmaster (a Mentor Graphics Company)
Cognizant Microsoft Business Group (MBG)
ALS Life Sciences
DFDS
MacDonald Humfrey (Automation) Ltd.
ProgramUtvikling
Illumina
Healthgrades
Slaughter and May
Lockheed Martin
Boeing
Trayport
Ghana Police Service
Department of Work and Pensions (UK)
New Hampshire Supreme Court
Royal Air Force
Washington Department of Transport
Nottingham County Council
ALS Life Sciences
Jack Links
New Signature
Epic Games
Boeing
DFDS
