Walkthrough: Creating a New Team Project

This walkthrough illustrates how to use Team Explorer to create a team project named Adventure Works.

Tasks illustrated in this walkthrough include:

  • Creating a team project using the process template MSF for Agile Software Development.

  • Configuring project area and iteration settings for a team project.

  • Opening the project checklist.


To complete this walkthrough, you need:

  • A Team Foundation Server.

  • Permissions as described in the following section.

Required Permissions

To perform this walkthrough, you must be a member of the Team Foundation Administrators security group or have the server-level View server-level information and Create new projects permission set to Allow. Additionally, your user account must be a member of the Windows SharePoint Services Administrator role and a member of the SQL Server Reporting Services Content Manager role. For more information, see Team Foundation Server Permissions.

Creating a Team Project

Software projects in Team Foundation are called team projects and are very different from the software projects (.csprj or .vbproj) in Visual Studio. The team project is the central concept that holds together the team endeavor of creating a specific software technology or product. When you create a team project, the New Team Project Wizard creates a number of focal points by which to centralize the team efforts. A team project Web site is created containing document templates, and predefined reports. A work item database is created for tracking all effort on the project. A process template is installed that determines rules, policies, security groups, and queries for all work effort. A source code branch is created for source control.

Team projects are created on a Team Foundation Server, therefore, you must connect to a Team Foundation Server. For more information, see How to: Connect to Team Foundation Server

After you have connected, you can create a team project.

To create a team project

  1. On the File menu, click New Team Project.

    The New Team Project wizard appears.


    If you are not using the Project Management, Visual Basic Development, or Web Development environment settings, then on the File menu, point to New, and then click Team Project.

  2. On the Specify the Team Project Settings page, type AdventureWorks in the What is the name of the team project? box, and click Next.

  3. On the Select a Process Template page, in the Which process template should be used to create the team project? drop-down list, select MSF for Agile Software Development - v4.0.

    Team Explorer includes process templates based on the Microsoft Solutions Framework (MSF). Two process templates are available by default: MSF for Agile Software Development - v4.0, and MSF for CMMI Process Improvement - v4.0. Your team or organization may provide additional process templates or may remove the MSF templates.

    You can see a description for each process template by selecting the template and reading the text in the The following describes the process template in more detail: box.

  4. On the Specify the Setting for the Project Portal page, keep the default title, and type Adventure Works Sample Team Project in the What is the description of the team project portal? box.

    The project portal is a team Web site (using Windows SharePoint Services) that stores and versions team project-related documents.

    Click Next.

  5. On the Specify the Source Control Settings page, keep the default values and click Next.

  6. On the Confirm the Team Project Settings page, click Finish.

    The New Team Project wizard creates your new team project.


    It may take several minutes for the wizard to finish.

  7. On the Team Project Created page, click Close.

    Because the check box for Launch the process guidance for more information about running the team project was selected by default, the wizard opens the overview page for the process guidance for MSF Agile for Software Development.

    The AdventureWorks team project displays in Team Explorer. Take a moment to explore the team project hierarchy by expanding the nodes. There are several top-level nodes:

    • Work Items   This node provides access to add work items and to create and view queries against the work item database.

    • Documents   This node provides access to documents such as the process guidance, functional specifications, and risk assessments that are stored on the project portal.

    • Reports   This node provides access to reports containing metrics for the team project.

    • Team Builds   This node provides access to the builds of your team project.

    • Source Control   This node provides access to the team project source control management hierarchy.

Configuring Team Project Settings

After you create a team project, you must configure settings such as groups, permissions, areas and iterations, build configurations, and source control. You can modify team project settings from the Team menu or Team Explorer.

In this walkthrough, you will modify the team project classifications. The classifications are used to categorize work items by project areas and iterations. The project structure is a hierarchy of nodes representing feature areas or teams. An iteration is a period of development effort dedicated to achieving a specific milestone.

In this walkthrough, you will modify the team project structure to map to the organization structure of Adventure Works. There is a Kiosk team that will handle the work of creating software for in-store kiosks that customers can use to order or pick up products. There is also a Web team working on an Internet Web site. Modifying the project structure to match the organization will allow you to map work items to the teams working on them. You can then use the categories to classify, query, and report on work items.

To modify the team project structure

  1. In Team Explorer, click the AdventureWorks team project.

  2. On the Team menu, point to Team Project Settings, and then click Areas and Iterations.

  3. In the Areas and Iterations dialog box, click the Area tab.

  4. Click the Add a child node toolbar button.

  5. Right-click the new node, click Rename, and then in the edit box type Kiosk.

  6. Click the Area node.

  7. Repeat steps 2, 3, and 4 to create an additional area named Web.

Next, modify the team project to specify the iterations that are planned. In this walkthrough scenario, there are three milestones. Each milestone marks the end of an iteration: M1 Prototype, M2 Beta, and M3 Release.

To modify the team project iterations

  1. In the Areas and Iterations dialog box, click the Iteration tab.


    The MSF for Agile Software development template includes three predefined iterations. For this procedure, you can delete those iterations, rename them instead of creating new ones, or simply leave them unchanged.

  2. Click the Add a child node toolbar button.

  3. Right-click the new node, click Rename, and then in the edit box type M1 Prototype.

  4. Click the Iteration node.

  5. Repeat steps 2, 3, and 4 to create two additional items named M2 Beta, and M3 Release.

  6. Click Close.

Opening the Project Checklist

Finally, open the project checklist and review the initial set of tasks created by the MSF for Agile Software Development template. The checklist provides you a sequence of tasks to follow in getting started on your project.

To open the project checklist

  1. In Team Explorer, expand the AdventureWorks node, expand the Documents node, and then expand the Project Management node.

  2. Right-click Project checklist.xls, and click Open.

  3. In the File Download dialog box, click OK.

    The project checklist opens as a spreadsheet inside Microsoft Excel.

  4. Review the list of tasks.

  5. Close the checklist.

Next Steps

Now that you have created a team project, you and other team members can begin working in the team project. Consider following these additional steps:

See Also


Walkthrough: Joining a Team Project


Team Foundation Process Guidance