Add a chart to a dashboard

Last Update: 3/16/2017

Team Services | TFS 2015

To enrich your team dashboards with visual status and trends, add charts that show work in progress, test results, and build summaries.

Feature availability: You can add charts from the widget catalog to multiple team dashboards when you connect to the web portal for Team Services or the application-tier server that has TFS 2015 Update 1 or later version installed. The widget catalog provides widgets for all tiles supported in previous releases of TFS for the team homepage.

For on-premises TFS 2015, you can add charts to the team homepage using the Pin to home page feature.
Chart Team Services TFS 2015 TFS 2015.1 TFS 2015.2
Build history chart 1 checkmark checkmark checkmark
Release definition 1 checkmark
Test chart 2 checkmark checkmark checkmark checkmark
Test quality trend chart 1 checkmark checkmark
Work item query 2 checkmark checkmark checkmark checkmark
Work item query chart 2 checkmark checkmark checkmark checkmark
  1. These charts are configured by the system. You can't edit them.
  2. These charts are user-configurable. See Using queries, Charts, and Tracking test status.
**Required permissions: ** You must be a team admin to add a chart to a team dashboard or homepage. Also, you must be in the team context in order to view the context menu selection, Add to dashboard. Or, if you're a member of the Project Administrators group, you can add charts to any team's dashboards or home page.

Add a build history chart

Feature availability: This feature is supported from Team Services or TFS 2015 Update 1 or later. With Team Services, you can add a build history chart widget to a team dashboard.

Each time a build is run, it logs information about the build, including the run time, errors and warnings, and whether it successfully completed or failed.

  1. Select your team context and then open the Build hub to add a build history chart to a team dashboard.

    Add a build summary chart to a dashboard

    If you aren't a team administrator, get added as one. The Add to dashboard menu selection is disabled when you don't have permissions to add it to the dashboards of the selected team context.

  2. Build summary charts look like this:

    Add a test plan chart to a dashboard

    Hover over a bar to view build information and run time. Click a bar to go to the build summary page.

Add a work item query or chart

Feature availability: This feature is supported from Team Services or TFS 2015. With Team Services, you can add a work item query chart widget to a team dashboard.

You add work item queries and charts to a dashboard from the Queries page. Queries and charts must be associated with queries under the Shared queries folder.

  1. First, make sure you have selected your team context. Only those dashboards created for a team appear in the context menu for each query or chart. Switch team context as needed.

  2. If you aren't a team administrator, get added as one. Only team and project admins can add and customize team dashboards.

  3. If you haven't yet created the dashboard, do that now.

  4. From the charts Actions menu, choose the team dashboard.

    Chart context menu, add to a dashboard

    You can only add charts associated with shared queries. Charts associated with queries under My Queries folder won't display the add to dashboard option.

Add a test chart

Feature availability: This feature is supported from Team Services or TFS 2015.

As you create and run tests, you can track your status by defining lightweight charts of test plans and test results.

  1. Select your team context, make sure you're a team admin, and if you haven't yet created the dashboard, do that now.

  2. Open the Test hub charts page and select the dashboard to add the test chart to.

    Add a test plan chart to a dashboard

Add a test quality trend chart

Feature availability: This feature is supported from Team Services or TFS 2015 Update 2 or later.

You can add trends to the dashboard of the failures and duration of those tests that were run as part of a build.

  1. Select your team context, make sure you're a team admin, and if you haven't yet created the dashboard, do that now.

  2. Open a build summary for a build definition to which you've added tests, open the Tests page, and click the bar chart for either Test failures or Test duration.

    Add a test plan chart to a dashboard

  3. Click the Actions icon Actions menu and choose the dashboard to add the chart to.

    Open Actions menu and select dashboard

    Learn more about reviewing automated test results after a build.

Add a release summary chart

Feature availability: This feature is supported from Team Services.

Each time a release is deployed, it logs information about the release to each of its environments. You can add a release tile to your team dashboard to monitor release progress and gain quick access to each release.

  1. Select your team context and then open the Release hub to add a release definition chart to a team dashboard.

    Add a Release definition chart to a dashboard

    If you aren't a team administrator, get added as one. The Add to dashboard menu selection is disabled when you don't have permissions to add it to the dashboards of the selected team context.

  2. Release definition charts show the success (green), in progress (blue), cancellation (red), or non-deployment (grey) to an environment for the current and last four releases:

    Release definition tile

You can track changes to a source control folder on the team dashboard in the same way. Go to the Code hub and access the add to dashboard action from the context menu for each folder or repository you want to add.

To learn more about charts and dashboards, see:

Switch team project or team focus

Several features depend on the team project or team that you have selected. For example, dashboards, backlogs, and board views will change depending on the context selected.

When you add a work item, the system references the default area and iteration paths defined for the team context. Work items you add from the team dashboard (new work item widget) and queries page are assigned the team default iteration. Work items you add from a team backlog or board, are assigned the team default backlog iteration. To change team defaults, see Set team defaults.

You navigate to your team context from the top navigation bar. The method changes slightly depending on the platform/version you work from and the features you have enabled.

NOTE

Feature availability: The Account Landing feature is in preview mode for Team Services and the web portal for TFS 2017.1. To learn more about this feature, see Work effectively from your account hub. To enable or disable the feature, see Enable preview features.

Click the VS icon Visual Studio icon and select a team or team project that you've recently visited. If you don't see the team or team project you want, click My Projects to browse all team projects and teams.

Choose another team from the team project menu

Click the context menu icon and select a team or team project that you've recently visited. If you don't see the team or team project you want, click Browse all to browse all team projects and teams.

Choose another team from the team project menu

Click the context menu icon and select a team or team project that you've recently visited. If you don't see the team or team project you want, click Browse all to browse all team projects and teams.

Choose another team from the team project menu

Click the name of the team project/team and select a team or team project that you've recently visited. If you don't see the team or team project you want, click Browse all to browse all team projects and teams.

Choose another team from the team project menu