Overview of process template files

You customize the initial configuration of team projects for Visual Studio Team Foundation Server (TFS) by customizing one or more process template files. You can customize several types of template files, which include the root XML file, plug-in files, and XML definition files. By customizing these files, you can define the initial configuration of all team projects that are created from the process template.

Go here to learn more about the default TFS process templates. Go here to learn about process template plug-in files.

You can customize elements of an existing team project by changing how its reports, work item types, and project portal function. In this case, your changes affect the way people work in that project, but they do not affect existing or future projects. For more information, see An end-to-end view of what you can configure and customize in Visual Studio TFS.

In this topic

  • The root process template file

  • Plug-in files

  • New Team Project Wizard and plug-in file interaction

  • XML definition files for test management

  • Files that define objects used to track work items

  • Process guidance files

The root process template file

You customize the root XML file, ProcessTemplate.xml, to define the sequence of plug-in files to be processed and the dependencies of each plug-in. The ProcessTemplate.xml file contains all task groups that must run to successfully create a team project. Each task group references a subordinate XML plug-in file (often in a subfolder) where the specific tasks are defined. In general, you specify one task group for each plug-in.

When the New Team Project Wizard creates a team project, it runs the set of plug-ins that are defined in the ProcessTemplate.xml file. For more information, see Define the root tasks using the process template plug-in file File.

Plug-in files

Plug-in files define the tasks that will be run and the screens that appear when a project lead creates a team project by using the New Team Project wizard. Each plug-in file defines one or more tasks. Tasks either specify to upload a file, set permissions for a group, or define some other configuration element. Each plug-in can be modified to customize a process template. Except for the Classification plug-in, plug-ins can also be deleted from the process template.

Each plug-in reads the set of tasks and dependencies to obtain the list of tasks that it must run and determine whether the requisite preceding tasks have been run. By using these definition files, you specify the initial configurations that each plug-in must implement.

A plug-in uploads files or configures data for a specific functional area. For example, the Work Item Tracking plug-in sets up work item types, queries, and initial work items for a new team project. TSF process templates include the plug-in files that are described in the following table. For information about how to customize each of these files, see Customize a process template.

Folder

Plug-in file

Description

Build

Build.xml

Defines the tasks to configure the initial security permissions that are assigned to identities for Team Foundation Build and to upload the build template files.

Classification

Classification.xml

Defines the initial iterations and areas of a team project.

Groups and Permissions

GroupsandPermissions.xml

Defines the initial security groups of a team project and their permissions.

Lab

Lab.xml

Defines the tasks to configure the initial security permissions that are assigned to identities for Visual Studio Lab Management.

Reports

ReportsTasks.xml

Defines the initial reports for a team project and sets up the report site.

Test Management

TestManagement.xml

Defines the test management files to upload that will create the initial test variables, configurations, settings, and resolution states of a team project. These settings are used by Microsoft Test Manager.

Version Control

VersionControl.xml

Defines the initial security permissions for version control, check-in notes for a team project, and whether exclusive check-out is required.

WorkItem Tracking

WorkItems.xml

Defines the initial work item types, queries, and work item instances of a team project.

Windows SharePoint Services

WssTasks.xml

Defines the project portal for the team based on a template for a SharePoint site. Also defines template files and process guidance.

New Team Project Wizard and plug-in file interaction

Project leads create team projects by using the New Team Project Wizard. The screens that appear in the wizard are determined by the plug-ins that are used. For example, if a process template does not include the plug-in for Windows SharePoint Services, no screen appears to ask the project lead for information about the project portal.

After the project lead finishes the wizard and clicks Finish, the wizard makes calls to the plug-ins to perform the work of creating the team project. The order in which the plug-ins are called is determined by the XML process definition files.

XML definition files for test management

The following table describes the XML definition files that are used to configure the initial states for Microsoft Test Manager. These files are located in the Test Management folder. Microsoft Test Manager is available with Visual Studio Ultimate and Microsoft Visual Studio Test Professional. For more information, see Define the initial configuration of Test Manager and Testing the application.

File

Description

testconfiguration

Configures the default test configurations (hardware and software) that are defined for a team project. After the project is created, you can delete these configurations and create other configurations.

testresolutionstate

Defines the test resolution states that are used by Test Runner and Microsoft Test Manager.

Note

You cannot change these states after the team project is created.

testsettings

Specifies the initial test settings files. Only one file is specified, localrun.testsettings.

testvariable

Defines the initial test variables. After the project is created, you can modify these variables and create other variables.

Files that define objects that are used to track work items

Team members use work items to track work. You might want to expand the selection of work items that is provided by Visual Studio Application Lifecycle Management (ALM) so that it better serves the processes that your team uses and the ways that you communicate. To do that, you can author new work item types. A work item type is a template from which new work items are created. You can also modify existing work item types.

The following table describes the XML definition files that are used to configure objects that are used to track work items. These files can be customized for a process template or afterward for an individual team project.

Folder

File

Description

Classification

FileMapping

Specifies the file that defines how fields are mapped from Office Project to Team Foundation. For more information, see Map Microsoft Project fields to Team Foundation fields.

WorkItem Tracking/Work Item Types

MSF Agile Software Development :

  • User Story, Bug, and Task

  • Code Review Request, Code Review Response, and Review

  • Feedback Request and Feedback Response

  • Issue

  • Test Case and Shared Steps

MSF for Capability Maturity Model Integration (CMMI) Process Improvement:

  • Requirements, Change Request, Bug, and Task

  • Code Review Request, Code Review Response, and Review

  • Feedback Request and Feedback Response

  • Issue and Risk

  • Test Case and Shared Steps

Visual Studio Scrum :

  • Product Backlog Item, Bug, and Task

  • Code Review Request, Code Review Response, and Review

  • Feedback Request and Feedback Response

  • Impediment

  • Test Case and Shared Steps

Defines the fields, workflow, and form for each type of work item. For more information about the work items that are defined for the MSF process templates, see the following topics:

For more information about how to customize or create work item types, see Customize work tracking objects to support your team's processes.

WorkItem Tracking/LinkTypes

MSF Agile Software Development:

  • SharedSteps, TestedBy

MSF for CMMI Process Improvement:

  • Affects

  • SharedSteps, TestedBy

Visual Studio Scrum:

  • Storyboard

  • SharedSteps, TestedBy

Defines additional types of links that are used to create relationships among work items.

For more information, see Define a custom link type.

WorkItem Tracking

Global Lists

Note

No global lists are defined in the default process templates.

Global lists define a list of menu items that is shared across work item types and team projects. You can define global lists within work item types that you upload with your process template. For more information, see Define global lists.

WorkItem Tracking

Categories.xml

  • Bug Category

  • Code Review Request Category and Code Review Response Category

  • Feature Category

  • Feedback Request Category and Feedback Response Category

  • Requirement Category

  • Shared Step Category and Test Case Category

  • Task Category

  • Hidden Types Category

Defines groups that associate a type of work item with a category. For more information, see Use categories to group work item types.

Several of these categories are required to support the process configuration used by the Agile backlog and task boards available from Team Web Access. For more information, see Configure and customize Agile planning tools for a team project.

WorkItem Tracking/Process

Process Configuration

Defines the configuration for the backlog and task board pages that appear in Team Web Access. For more information, see Configure and customize Agile planning tools for a team project.

WorkItem Tracking/Queries

Team work item queries (.wiq)

Defines an initial set of team queries that support finding work items. You can add or modify these queries. For more information, see Add work item queries to a process template.

Process guidance files

Process guidance files are uploaded to a team project portal. These files specify links to process guidance content, project management workbooks, and sample templates and documents. All of these objects can be customized for a process template or afterward when they are defined for a team project.

The following table describes the process guidance files that are included in the MSF process templates.

Note

Process template files do not include dashboards or Microsoft Excel reports. These files are added to the team project, depending on selections that are made when a team project is created. If no SharePoint site is provisioned for the team project, no dashboards or Office Excel reports are available. For more information about these artifacts, see the following topics: Dashboards, Dashboards (CMMI), Excel reports, and Excel reports (CMMI).

Folder

File type

Description

Windows SharePoint Services/Process Guidance/Supporting Files

.htm files

Defines process guidance URL files. These files define the URL that is opened when a team member clicks Open process guidance for work item in a work item form. The TFS process templates contain links to topics on MSDN. These files can be customized to point to other resources for process guidance.

Windows SharePoint Services/Shared Documents

.xslx files

Defines Microsoft Excel workbooks to support bug triage and track issues.

Windows SharePoint Services/Samples and Templates

.docx, .dotx, and .xslx files

Provides sample documents and templates as a starting point for creating work products. These files are uploaded to the team project portal when a SharePoint site is provisioned for the team project.

See Also

Concepts

Work with team project artifacts, choose a process template

Customize a process template