TFS Integration Tools - Issue: unable to find a unique local path

Published on
2 minute read

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.

TFS Integration Tools - Issue: unable to find a unique local path  

Figure: You get a “MigrationException: unable to find a unique local path”

At this point the migration fails and you are unable to continue.

Applies to

Finding

In order for the TFS Integration Platform to minimise the likelihood of hitting the 258 character limit of Windows it shortens the mapped path.

TFS Integration Tools - Issue: unable to find a unique local 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.

Workarounds

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.

TFS Integration Tools - Issue: unable to find a unique local path  

Figure: TFS Integration Tools - Issue: unable to find a unique local path 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  )

Practical Techniques and Tooling Install and Configuration Software Development Troubleshooting Pragmatic Thinking

Related blog posts

No related videos found.

Connect with Martin Hinshelwood

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.

Our Happy Clients​

We partner with businesses across diverse industries, including finance, insurance, healthcare, pharmaceuticals, technology, engineering, transportation, hospitality, entertainment, legal, government, and military sectors.​

Higher Education Statistics Agency Logo
Hubtel Ghana Logo
Big Data for Humans Logo
DFDS Logo
Slicedbread Logo
Deliotte Logo
ProgramUtvikling Logo
Qualco Logo

CR2

Slaughter and May Logo
Illumina Logo
Genus Breeding Ltd Logo
YearUp.org Logo
Philips Logo
Bistech Logo
Lean SA Logo
Ericson Logo
Emerson Process Management Logo
New Hampshire Supreme Court Logo
Washington Department of Enterprise Services Logo
Royal Air Force Logo
Department of Work and Pensions (UK) Logo
Nottingham County Council Logo
Ghana Police Service Logo
Jack Links Logo
Emerson Process Management Logo
Graham & Brown Logo
Workday Logo
Microsoft Logo

NIT A/S