To get the most out of using the Agile planning tools that Visual Studio Online and Team Foundation Server (TFS) provide, you’ll want to configure those features in ways that support your team’s processes. Several features can be configured through the web user interface. Other features can be customized only for TFS on-premises deployments by changing an XML definition.
This topic provides an overview of what you can customize and pointers to content that shows you how.
The Agile planning tools reference the configuration of the categories and process configuration XML definition files for the team project. The categories group the WITs that are used to determine what will appear on the portfolio backlog, backlog, and task backlog pages.
To edit an XML definition file, you export, edit, and then import the file. Another tool you can use to modify these files is the TFS Team Project Manager, a community resource project available on CodePlex.
To edit process configuration using the witadmin command line tool, follow these steps.
If you don't have administration permissions for your team project, get them.
Open a Command Prompt window where either Visual Studio or Team Explorer is installed and enter:
cd %programfiles%\Microsoft Visual Studio 14.0\Common7\IDE
On a 64-bit edition of Windows, replace %programfiles% with %programfiles(x86)%. You can download Team Explorer for free.
Export the process configuration file.
witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/ProcessConfiguration.xml"
An example of a CollectionURL is http://MyServer:8080/tfs/TeamProjectCollectionName.
Edit the file. For details, see Process configuration XML element reference.
Import the process configuration file.
witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/ProcessConfiguration.xml"
Open the TFS web portal to view the changes. If it is already open, refresh the page.
For more information about using witadmin, see Import and export process configuration [witadmin] and Import and export categories [witadmin].
The Kanban board supports two levels of customization. You configure the first level through the user interface and the second level by changing the workflow.
The first and simplest level includes the ability to specify as many swim lane columns as you want as described here. A swim lane is a pseudo state or interim state within a workflow state.
Each team can generate their custom view of swim lanes. One drawback, however, is that you cannot query for work items based on the swim lane status. You can only query for work items based on their assigned State.
By changing the workflow to support the swim lanes you want, you support queries based on all States/swim lanes. This customization requires changing the workflow for those WITs assigned to the Requirement Category, such as Product Backlog Item or User Story. The default swim lanes correspond to the workflow states of these WITs that have been mapped to metastates. If you want your swim lanes to correspond to a custom workflow, you must perform these two modifications:
Modify the workflow of the WITs in the Requirement Category.
Modify the process configuration to ensure all workflow states are mapped to metastates.
A: To learn how to add tags and filter lists, go here.
A: To limit the display load time to acceptable parameters, the task board is restricted to a maximum of 1000 work items.
For TFS on-premises deployments, you can increase this value up to a maximum of 1500 by specifying a value for the workItemCountLimit attribute of the TaskBacklog element.
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
A: To view and work with portfolio backlogs requires that you have Advanced access. However, the system doesn’t restrict you from creating and modifying Feature work items.
A: Yes, for TFS on-premises deployments. If your organization has several teams that work from a common backlog and across many product areas, you might want to customize the team project to support team fields. This configuration will still allow teams to work independently, but work can be assigned to teams instead of by product area path.
A: Open the Edit Chart dialog from the CFD and choose the start date. To learn more about the CFD, go here.
A: Open Settings from the team’s administration page. If you’re not a team administrator, get added as one.
A: Agile pages and charts displayed through the web portal reference the WIT data store in real time. That means there is no time delay from when data is entered or updated and data displayed in the Agile planning tool pages and charts.
In the following illustration, work item fields are displayed in a blue box to emphasize that their definitions apply across all team projects within a team project collection. The yellow-colored boxes indicate WIT objects that are defined for a team project. The Agile pages and charts, shown in purple, are defined for a team.