Issue [ TFS 2013 Preview ] TF400654: Unable to configure Planning Tools

TL;DR

Explains how to resolve TF400654 errors in TFS 2013 Preview by updating process templates to ensure custom fields exist in all required work item types.

27 June 2013
Written by Martin Hinshelwood
2 minute read
Comments
Subscribe

If you have the ‘team field’ enabled you will receive a “TF400654: Unable to configure Planning Tools” when you try to use the automatic configuration.

[Error] TF400654: Unable to configure Planning Tools. The following element contains an error: TypeFields/TypeField[type=‘Team’]. TF400517: The value of this element is set to: HinshLabs.Team. You must set the value to a field that exists in all of the work item types that are defined in Microsoft.FeatureCategory. The field does not exist in the following work item types: Feature.

image

Figure: TF400654 Unable to configure Planning Tools

Applies to

  • Team Foundation Server 2013 Preview

Findings

When you get a “TF400654 Unable to configure Planning Tools” error after an upgrade and you are trying to ‘configure’ the new features that have been added to TFS it is because you have customised the Process Template. The “Configure Features” wizard does a really good job of figuring out which process template and

  • Changed to use ‘team field’
  • Modifying the States

In the case of the ‘team field’ I am really hoping that they will be able to fix this for the RTM. The Field ‘HinshLabs.Team’ is already there in the Collection and if the wizard could just add it to the fields of the vanilla Feature and then pick a known UI point to add it. The customer can always move it later but this would give them a much slicker experience…

Solution

You need to manually update your process template by following the instructions on the link provides or you can follow Upgrading to Visual Studio Scrum 3.0 process template in TFS 2013 .

  1. Download the Visual Studio Scrum 3.0 Process Template
  2. Edit Task, Bug, Product Backlog Item, Issue and Feature to have the same custom field… in this case “HinshLabs.Team”
  3. Re-implement any other customisations that you had
  4. Import the work items

This process is much easier and less time consuming if you have only One Team Project or use the same Process Template across all of your Team Projects.

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.

Comments
Subscribe

What to read next

Article

Issue [ TFS 2013 ] Value cannot be null. Parameter name: key

Explains how a missing required Team Field in customised TFS 2013 work item templates causes "Value cannot be null" errors, and how to …

Read article
Article Scrum

Process Template Upgrade #7 – Rename Work Items and Import new ones

Step-by-step guide to upgrading TFS process templates by renaming and importing work item types, preserving data, updating fields, …

Read article