Add features using a manual update process
You can update team projects that were created in earlier versions of Team Foundation Server (TFS) to use new features added with the upgrade to TFS 2013. You should update team projects by using the Configure Features wizard. However, if the wizard is unable to add a feature, you can add it manually.
This update adds the Feature work item type (WIT) and supports managing portfolio backlogs.
You will copy or add files from the folder of the latest version of process template that you download to the corresponding folder containing your customized process template definitions.
If you aren’t a member of the Project Collection Administrators group, get added. You’ll need these permissions to run the wizard and download process templates.
Run the Configure Features wizard to determine which features need to be configured.
If the wizard lists additional features to configure besides Portfolio Backlogs, then first apply the updates provided in the 2012 version of this topic.
Download the latest version of the process templates that is compatible with the one used to create your team project.
To download or upload process templates, you must connect to TFS 2013 from either Visual Studio 2013 or Team Explorer 2013.
Open a Command Prompt window where either Visual Studio 2013 or Team Explorer 2013 is installed and enter:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
On a 32-bit edition of Windows, replace %programfiles(x86)% with %programfiles%.
Add the Feature WIT. Specify the DirectoryPath to the WorkItem Tracking/TypeDefinitions folder that contains the process template that you downloaded.
witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\Feature.xml"
The directory path must follow this structure: Drive:\TemplateFolder\WorkItem Tracking\TypeDefinitions.
An example of CollectionURL is http://MyServer:8080/tfs/DefaultCollection.
Update the categories to support using the Feature portfolio backlog.
First, export the categories file.
witadmin exportcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\categories.xml"
Add the Feature Category.
<CATEGORY name="Feature Category" refname="Microsoft.FeatureCategory"> <DEFAULTWORKITEMTYPE name="Feature" /> </CATEGORY>
Then, import the categories file.
witadmin importcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\categories.xml"
Import the new process configuration file from the WorkItem Tracking/Process folder of the downloaded process template. Process configuration is now supported by the single file ProcessConfiguration.
witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
Incorporate any customizations that you made to the AgileConfiguration or CommonConfiguration files to ProcessConfiguration. For more information, see Process Configuration XML Reference.
You can start using the portfolio backlog as described here.
A: If you want to use your existing WIT Feature to support a portfolio backlog, then you can skip step 5 and complete the remaining steps. However, if you want to add a different named WIT for your portfolio backlog, then you’ll need to modify the categories and process configuration definition files prior to importing these files to reflect the different naming. See Add a Portfolio Backlog.
A: You can add up to five portfolio backlogs. This includes the default backlog of Feature. To get started, see Add a Portfolio Backlog.
A: To view and work with portfolio backlogs requires that each team member has Full access.