Configure or add a project portal

TFS 2017 | TFS 2015 | TFS 2013

The project portal is a site associated with a team project for the purposes of sharing information. Project portals that are created when the team project is created are associated with a SharePoint site. These portals provide access to shared documents, dashboards, and support files that contain redirect links to MSDN process guidance topics.

Important

Configuring the project portal and process guidance features have been deprecated. You can only set them from Visual Studio 2017 or earlier versions and when connected to TFS 2017 or earlier versions. SharePoint integration with Azure DevOps (formerly named Team Foundation Server) was deprecated with the release of TFS 2018.

For TFS 2018 and later versions, you can use the built-in wiki feature to share information, guidance, and documents. To learn more, see About Wikis, READMEs, and Markdown.

If your team project was created using the Basic configuration, you won't have access to a SharePoint integrated project portal. If you want to configure a portal that points to a networked web site, you can. Also, you can configure the portal and process guidance independently of each other.

Choose one of the following options based on your deployment configuration and team requirements:

• Determine if your team project portal is enabled.

  Choose this option if you're not sure if your team project is already configured.

• Configure a Web site for your portal.

  Choose this option if you want to use a website that doesn't require SharePoint integration.

• Configure a prepared SharePoint site for your portal.

  Choose this option if you have already configured TFS to integrate with a SharePoint Web application.

• Add a SharePoint server and upload portal contents from the process template

  Choose this option to prepare a SharePoint Web application, and add all portal artifacts and process guidance for a team project that was created using the Basic configuration.

Prerequisites

• To enable a team project portal, you must be a member of the Project Collection Administrators group.

Determine if your team project portal is enabled

If you cannot access Excel reports or dashboards, you might want to verify whether a portal has been enabled for your team project.

1. From Visual Studio>Team Explorer, connect to your team project.

2. Open Portal Settings.

   

   If the Enable team project portal check box is not selected, your team project portal is not enabled.

   

Configure a Web site for your portal

Configure this option when you aren't using SharePoint Products.

1. If you aren't a member of the Team Project Administrators group, get added now.

2. Open Portal Settings.

3. Select the Enable team project portal check box and then enter the URL for the Web site you've prepared for your team project portal.

   

Configure a prepared SharePoint site for your portal

Choose this option when you have a SharePoint Web application that has been integrated to work with TFS. To learn how to do this, see SharePoint Products requirements for Team Foundation Server.

1. If you aren't a member of the Team Project Administrators group, get added now.

2. Open Portal Settings from the Settings page in Team Explorer.

3. Select the Enable team project portal check box and then choose Configure the URL.

4. Enter the URL for the SharePoint site you've prepared for your team project portal.

   

Add SharePoint site integration and upload portal contents from a process template

Choose this option to gain access to Excel reports, dashboards, and process guidance support. To add the portal to the team project, use the tfpt command line tool that TFS Power Tools provides.

1. Add SharePoint products to your deployment.

2. Verify that you have the following tools, configurations, and permissions.

   1. If you haven't installed TFS power tools, install them now to your Visual Studio client:

   2. TFS 2015: Microsoft Visual Studio Team Foundation Server 2015 Power Tools

   3. TFS 2013: Microsoft Visual Studio Team Foundation Server 2013 Power Tools

   4. If you haven't installed a version of Visual Studio, install one of them now. You can download Team Explorer for free. Team Explorer must be installed on the same machine where you run the tfpt command line tool.

   5. If you aren't a member of the Project Administrators group, get added now.

   6. If you haven't been granted Full Control for the SharePoint site, get that permission now.

3. Open a Command Prompt in administrative mode and change to the directory where you installed the power tools.

   cd %programfiles%\TFS 2013 Power Tools  
   

   On a 64-bit edition of Windows, replace %programfiles% with %programfiles(x86)%.

4. Add the portal. The process template you specify must be compatible with the template used to create the team project. And, it must have been uploaded to the team project collection that hosts your team project.

   tfpt addprojectportal /collection:"http://MyServer:8080/tfs/DefaultCollection" /teamproject:MyProject /processtemplate:"TemplateName"   
   

   These are the names of the process templates available with TFS 2013:

   • Microsoft Visual Studio Scrum 2013
   • MSF for Agile Software Development 2013
   • MSF for CMMI Process Improvement 2013

5. Open Portal Settings and verify that the SharePoint site is configured as expected.

6. From the Home page, open the Documents page.

   Git	TFVC

7. Open the project portal.

   

8. From your project portal, add team member accounts to the Contributors group for the SharePoint site.

Related notes

The artifacts you'll have access to depend on the process template created with your team project. For an overview of the artifacts available with the default process templates, see Choose a process.