TFS2017.1本地环境启用Feature Portfolio后添加按钮禁用解决方案咨询

Got it, let's work through this issue where your Feature Portfolio is enabled but the add button stays grayed out. I’ve run into this exact scenario with on-prem TFS 2017.1 before, so here’s a step-by-step breakdown to get that button working:

1. Verify Backlog Level Configuration #

First, make sure Feature is actually enabled as a backlog level in your project’s process template:

• Open the TFS web portal, navigate to your project, and click the gear icon (Project Settings) in the top right.
• Go to Work > Process, then select the process template your project uses (e.g., Scrum, Agile) and click Edit.
• Switch to the Backlogs tab. Check if "Feature" is checked under the backlog levels. If not, tick the box and save the changes.

2. Check Iteration/Area Path Permissions #

A common culprit is missing permissions for creating work items in the selected iteration or area:

• In Project Settings, go to Security.
• Navigate to either Iterations or Areas, find the path you’re viewing in the backlog, and verify your user account has the Create work items permission enabled.
• Also, double-check that the iteration/area selected in your backlog view is one you have permissions for.

3. Validate Feature Work Item Type Configuration #

If the Feature work item type has missing required fields or broken state configurations, the add button will stay disabled:

• In the process editor (from step 1), go to Work Item Types > Feature.
• Review the Fields tab: Ensure no mandatory fields are missing default values (required fields without defaults block creation).
• Check the States tab: Confirm there’s a valid initial state (e.g., "New") set up for Feature work items.

4. Clear Cache & Refresh (Or Restart TFS Services) #

Sometimes stale browser cache or unapplied configuration changes are to blame:

• Clear your browser’s cache (Ctrl+Shift+Delete on most browsers) and refresh the backlog page.
• If that doesn’t work, restart the TFS Application Tier Service and TFS Job Agent service on your server to ensure all configuration updates take effect.

5. Use witadmin Command Line (If All Else Fails) #

You can force-add the Feature backlog level using TFS’s witadmin tool:

• Open a Command Prompt as Administrator on your TFS server.
• Navigate to the TFS tools directory (usually C:\Program Files\Microsoft Team Foundation Server 15.0\Tools).
• Run this command to add Feature as a backlog level:

  witadmin addbackloglevel /collection:http://your-tfs-server:8080/tfs/DefaultCollection /teamproject:YourProjectName /workitemtype:Feature /name:Feature /parentbackloglevel:Epic
  

• Replace your-tfs-server and YourProjectName with your actual server and project details.

内容的提问来源于stack exchange，提问作者Elad Motola