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

TFS Integration Tools - Issue: TF205022: The following path contains more than the allowed 259 characters

Explains how to resolve the TFS error caused by file paths exceeding 259 characters during migration, with steps to shorten paths and adjust workspace settings.

Published on
3 minute read
Image
https://nkdagility.com/resources/gkD4iN7ZkP4
Subscribe

You get error “TF205022: The following path contains more than the allowed 259 characters” when trying to migrate over some folders.

TFS Integration Tools - Issue: TF205022: The following path contains more than the allowed 259 characters

Figure: TF205022: The following path contains more than the allowed 259 characters

The full error message:

1TF205022: The following path contains more than the allowed 259 characters:
2
3$/XXX XXXXXXX/XXXXXXXXX XXXXXXXXX/Image Source Files/Promotions/SixZero/XXX
4XXXXXXXX XXX-Australia/XX XXXXXXX Materials/XX XXXXXXX web content, banner ads,
5and images for localization/Promo XX XXXXXXX Ad Banner and Badge/675x180_XXXXXXX
6ads/XXXXXXX_675x180.jpg.
7
8Specify a shorter path.

Figure: OMG that’s 264

You can’t make this stuff up!

Applies to

Findings

The mapped path for the destination TFS server is a might too long. In this case it is 264 (use http://www.javascriptkit.com/script/script2/charcount.shtml rather than counting manually) and that is just too long for getting data into TFS.

If you end up in this position then you are looking at a manual intervention to fix. Folks that are using these folders can map them at a lower level and you can indeed do that with the Integration Plafrom and achieve the same result. However, you will be left in the same place as they currently are.

  1. Perform manual mappings of each folder that is causing problems
  2. Manually go a get, clean and checkin.

I am opting for #1 as it maintains my branching and history but the ultimate solution would be to think long and hard about the folder structure that you check into TFS. Its not just a network share and it comes with its own requirements.

Solution #0

By default the TFS Integration Platform uses “x:TfsIpData” for its workspaces. To gain a few much needed characters you can change this to “x:ipw”.

  1. Open “C:Program Files (x86)Microsoft Team Foundation Server Integration Tools”
  2. Edit “MigrationToolServers.config” as Admin
  3. Edit the AppSettings Value for Key “WorkSpaceRoot”

TFS Integration Tools - Issue: TF205022: The following path contains more than the allowed 259 characters

Figure: Alter the AppSettings Key

Now you have saved a few characters! Its not enough for me, but may be for you…

Solution #1

You will need to setup your mappings so that the target is shorter for all folders that end up longer. As you map all of the source and targets or the branches to the new shorter names the merge/branch history is still preserved.

In this case I want to rip out “XX XXXXXXX web content, banner ads, and images for localization” (63) and replace it with “ContentForLocalization”( 22) which will free up 41 characters for the path. If I also shorten “XXXXXXXXX XXXXXXXXX” to “XXX” I get another 16 characters and that I think puts me back into a safe place.

Figure: Shorten the path in the config

Now that the path has been shortened the Integration Platform should detect that the config has changed and reset the migration data. The problem is that these errors can be resolved due to a “Sequence contains no matching elements” error.

TFS Integration Tools - Issue: TF205022: The following path contains more than the allowed 259 characters

Figure: Sequence contains no matching elements

In order to proceed I will need to again recreate the session. Remembering to call “tf destroy” on the source that has already been migrated.

Did this help you save a few characters from your path?

Troubleshooting Software Development
Subscribe

Related Blog

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

Akaditi Logo

Akaditi

Schlumberger Logo

Schlumberger

YearUp.org Logo

YearUp.org

Big Data for Humans Logo

Big Data for Humans

Deliotte Logo

Deliotte

Illumina Logo

Illumina

Capita Secure Information Solutions Ltd Logo

Capita Secure Information Solutions Ltd

Boxit Document Solutions Logo

Boxit Document Solutions

Ericson Logo

Ericson

Brandes Investment Partners L.P. Logo

Brandes Investment Partners L.P.

Sage Logo

Sage

Emerson Process Management Logo

Emerson Process Management

Slicedbread Logo

Slicedbread

ProgramUtvikling Logo

ProgramUtvikling

SuperControl Logo

SuperControl

ALS Life Sciences Logo

ALS Life Sciences

Higher Education Statistics Agency Logo

Higher Education Statistics Agency

Xceptor - Process and Data Automation Logo

Xceptor - Process and Data Automation

Royal Air Force Logo

Royal Air Force

Nottingham County Council Logo

Nottingham County Council

New Hampshire Supreme Court Logo

New Hampshire Supreme Court

Washington Department of Transport Logo

Washington Department of Transport

Washington Department of Enterprise Services Logo

Washington Department of Enterprise Services

Ghana Police Service Logo

Ghana Police Service

YearUp.org Logo

YearUp.org

Illumina Logo

Illumina

Akaditi Logo

Akaditi

Qualco Logo

Qualco

Higher Education Statistics Agency Logo

Higher Education Statistics Agency

Jack Links Logo

Jack Links