Add a Team Project Portal

  • Article

By adding a Web site to act as the portal for your team project, you can help provide a single point of information about the team project and its status. You can provide a single point of information about the team project to encourage members of that project to communicate and share resources. You can add a SharePoint site when you create a team project if your Team Foundation administrator has configured one or more SharePoint Web applications to support the team project collection in which your project resides. As an alternative, you can add a Web site to act as the team project portal after a project is created.

Important

If you add a SharePoint site as the team project portal, a Documents folder will appear for the team project in Team Explorer. This folder is linked to the SharePoint library for the team project, and project members can use it to store and share documents that relate to the project. This feature is available only if you add a SharePoint site. If you add a Web site, no Documents folder will appear for the team project in Team Explorer.

For more information about how to add a team project portal when you create a team project, see Create a Team Project.

Note

If you add a SharePoint site or another type of site (such as a wiki) after the team project is created, you must specify an existing Web site. You cannot create a site from the Project Portal tab. Also, if you add a Web site that exists on a server that does not have the extensions for SharePoint Products installed, you will not be able to use many of the automated integration features for team project portals.

Required Permissions

To perform these procedures, you must be a member of the following groups or have the following permissions:

  • The Project Administrators group or have the View Collection-Level Information and Edit Collection-Level Information permissions set to Allow.

For more information about permissions, see Team Foundation Server Permissions.

To add a SharePoint site as a portal to an existing team project

  1. In Team Explorer, right-click the name of the project, point to Team Project Settings, and then click Portal Settings.

  2. On the Project Portal tab, select the Enable project portal check box.

  3. Click Use this SharePoint site, and then click Configure URL.

  4. In the Web application list, click a SharePoint Web application.

    Note

    If the list is empty, your administrator has not configured any SharePoint Web applications for use with the team project collection that contains your team project. You must click Use a Web site instead or contact an administrator for Team Foundation Server and request the addition of a SharePoint Web application to the team project collection.

  5. In Relative site path, type the relative path of an existing SharePoint site.

    As you type the path, it appears at the end of the value in URL.

  6. In URL, click the link, verify that the path is correct, and then click OK.

  7. If you want this SharePoint site to show data for this project, select the Reports and dashboards refer to data for this team project check box.

    Important

    If you select this check box and another team project is already using that site, you will cause serious consequences for that team project. By selecting this check box, you will redirect all automated reports and data on this portal to reflect the data for this team project instead of the other team project. You must ensure that no other team projects use this SharePoint site, or you must verify with the owner of the other team project that you should make this change. To redirect the reports and data, you must also be a member of the Project Administrator group in both projects.

  8. Click OK.

    Note

    If the site that you are adding as a portal is hosted on a server that is running Microsoft Office SharePoint Server 2007, you might need to activate the SharePoint Feature for that site before the reports and dashboards appear correctly on that portal.

To add a Web site as a portal to an existing team project

  1. In Team Explorer, right-click the name of the project, point to Team Project Settings, and then click Portal Settings.

  2. On the Project Portal tab, select the Enable project portal check box.

  3. Click Use a Web site, and then type the URL for the site that you want to use.

  4. Click Check URL to verify that the Web site is valid.

    The Web site that you specified opens in a new window.

  5. Click OK.

See Also

Tasks

Add a SharePoint Web Application to Your Deployment

Modify or Remove Access Between a SharePoint Web Application and Team Foundation Server

Configure a Default Location for Team Project Portals

Connect a Microsoft Office Document to Team Foundation Server