a·gen·tic a·gil·i·ty

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

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.

Published on
2 minute read
Image
https://nkdagility.com/resources/-dAwZr3zpgy
Subscribe

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 )

Smart Classifications

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.

Subscribe

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.​

Emerson Process Management Logo

Emerson Process Management

New Signature Logo

New Signature

Philips Logo

Philips

Flowmaster (a Mentor Graphics Company) Logo

Flowmaster (a Mentor Graphics Company)

MacDonald Humfrey (Automation) Ltd. Logo

MacDonald Humfrey (Automation) Ltd.

Slaughter and May Logo

Slaughter and May

Bistech Logo

Bistech

Teleplan Logo

Teleplan

Alignment Healthcare Logo

Alignment Healthcare

Genus Breeding Ltd Logo

Genus Breeding Ltd

Deliotte Logo

Deliotte

Higher Education Statistics Agency Logo

Higher Education Statistics Agency

Lean SA Logo

Lean SA

Akaditi Logo

Akaditi

ALS Life Sciences Logo

ALS Life Sciences

Ericson Logo

Ericson

Capita Secure Information Solutions Ltd Logo

Capita Secure Information Solutions Ltd

ProgramUtvikling Logo

ProgramUtvikling

Ghana Police Service Logo

Ghana Police Service

Department of Work and Pensions (UK) Logo

Department of Work and Pensions (UK)

Nottingham County Council Logo

Nottingham County Council

Washington Department of Transport Logo

Washington Department of Transport

New Hampshire Supreme Court Logo

New Hampshire Supreme Court

Washington Department of Enterprise Services Logo

Washington Department of Enterprise Services

Lockheed Martin Logo

Lockheed Martin

Qualco Logo

Qualco

Ericson Logo

Ericson

Deliotte Logo

Deliotte

Brandes Investment Partners L.P. Logo

Brandes Investment Partners L.P.

NIT A/S