[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
If the build definitions you can create by using the Default Template or the Upgrade Template do not meet your team's needs, you can create your own richly customized build process template.
This topic includes the following sections:
Required Permissions
To perform the following procedures, you must have the Edit Build Definition permission set to Allow. For more information, see Team Foundation Server Permissions.
Create a Build Process Template
To create a custom template
In Team Explorer, select a team project.
On the Build menu, click New Build Definition.
Type a name in the Build definition name field.
Click the Process tab, and then click New.
The New Build Process Template dialog box appears.
Click Copy an existing XAML file, and then click OK.
In the build definition window, below the Build process file menu, click the hyperlink that contains the name of your template.
The folder that contains your new template appears in Source Control Explorer.
In the Folders pane, right-click the folder that contains your new template and click Get Latest Version.
Right-click your new template and click View.
The Visual Studio Windows Workflow Designer appears. For more information, see either of the following topics:
Use the designer to edit your template.
After you have finished editing your template save it and close the designer.
Right-click your new template and click Check In Pending Changes.
The Check In dialog box appears.
Click Check In.
Register a Build Process Template with the System
You can register build process templates created outside your team project. For example, you may have received a build process template from a colleague in e-mail and checked it into the TeamBuildProcessTemplates folder in your team project's version control system.
Before you and others on your team can use the build process template to create build definitions, you must register it with the system.
To register a build process template with the system
In Team Explorer, select a team project.
On the Build menu, click New Build Definition.
Type a name in the Build definition name field.
Click the Process tab, and then click New.
The New Build Process Template dialog box appears.
Click Select an existing XAML file.
Click Browse.
The Browse dialog box appears.
Use the Browse dialog box to locate and select the custom template that you want to register.
Your new build process template is now displayed in the Build process file list and can be used by you or others on your team to create build definitions.
Working with Build Process Templates
Following are some recommendations and tips that can help you be more successful in working with build process templates:
We recommend that you do not modify the Default Template or the Upgrade Template. Instead, create a template based on one of these templates, as described in Create a New Custom Build Process Template.
You can register a build process template with more than one team project. This capability means that you can share a build process across any team project in the team project collection that contains your template.
If you need to modify a build process template, you should plan to review all build definitions that are based on the template and correct them after you have completed your changes to the build process template. If you do not do this, your build definitions may fail or function in an unexpected way.
If you decide to delete a build process template, first make sure that you locate and delete all build definitions that are based on the template. When you delete the template, any remaining build definitions based on the template will no longer function.
