Widget catalog

Last Update: 3/16/2017

Team Services | TFS 2017 | TFS 2015.1-2015.3

NOTE

Feature availability: You can access the widget catalog from Team Services or the web portal for TFS 2015 Update 1 or later version. All widgets listed below are available from the web portal for Team Services. Some widgets listed below are only available when you connect to TFS 2015 Update 2 or later version.

With TFS 2015, you have access to a single team dashboard with which you can pin items but can't add widgets to the dashboard. Install TFS 2015 Update 1 or later version to get access to the widget catalog and multiple team dashboards. Go here to determine the platform and version you're on.

To add a widget to a dashboard or copy a widget from one dashboard to another, see Add a widget to a dashboard.

User-focused and team-scoped widgets

User-focused widgets display information based on the logged-in user.

Team-scoped widgets display data based on the selected team context.

Code

Code tile

Code tile widget

Adds a configurable tile to display the summary of a code folder or Git repository. To configure, simply click the added tile, select a repository, select a branch (Git only) and select a path. The code tile supports both TFVC and Git repositories.

Pull request (user-focused or team-scoped)

Pull request widget
Feature availability: Available from Team Services or TFS 2015.2 or later version.

Adds a configurable tile to display active pull requests requested by the team, or assigned to or requested by the person logged in. Select the Git repository for the pull requests of interest.

You need to add a widget for each Git repository of interest.

Plan and track work

Assigned to me (user-focused)

Assigned to me widget
Feature availability: You can access this widget from Team Services and TFS 2017.

Displays the list of work items currently assigned to the currently logged in user. The list ignores closed and deleted work items.

Chart for work items

Chart work item query widget
Feature availability: You can access this widget from Team Services or TFS 2015.2 or later version. For TFS 2015.1 and earlier versions, see Add a chart to a dashboard to add shared query charts to a dashboard.

Adds a tile to display a progress or trend chart that builds off a shared work item query.

From the configuration dialog, select a shared query and specifying the chart type and values.


Cumulative flow diagram (team-scoped)

Cumulative flow diagram widget
Feature availability: This widget relies on the Analytics Service. The service is in preview and only available to select customers of Visual Studio Team Services at this time.

Displays the cumulative flow of backlog items based on the time frame, team, backlog level and swimlane you select.

From the configuration dialog, specify the team, backlog level, and other parameters you want.

Hover over each color within the chart to see the count of items for a particular Kanban column.


Lead time (team-scoped)

Lead time widget
Feature availability: This widget relies on the Analytics Service. The service is in preview and only available to select customers of Visual Studio Team Services at this time.

Displays the lead time of work items closed in a specified timeframe for a single team and backlog level. The lead time of a work item is defined as the time taken to close a work item after it was created.

Each marker on the chart corresponds to one or more work items with a particular lead time. The lower the lead time, the faster work is being delivered to the customer.


Cycle time (team-scoped)

Cumulative flow diagram widget
Feature availability: This widget relies on the Analytics Service. The service is in preview and only available to select customers of Visual Studio Team Services at this time.

Displays the cycle time of work items closed in a specified timeframe for a single team and backlog level. The cycle time of a work item is defined as the time taken to close a work item after work on it has started.

Each marker on the chart corresponds to one or more work items with a particular cycle time. The lower the cycle time, the faster work is progressing through your development pipeline.


New Work item (team-scoped)

New work item widget
Enables you to add work items from the dashboard. You use work items to plan and track work.

Work items that you add using this widget are automatically scoped to the team's default area path and the team's current sprint (TFS) or the default iteration (Team Services). To change team defaults, see Set team defaults.

Other links (team-scoped)

Other links widget

Provides links to the following features:

For on-premises TFS, additional links are displayed when the corresponding resource is configured for the team project:

On-premises TFS with configured resources Other links widget

  • View project portal (opens either a SharePoint site or URL that's been configured as the team project's portal.
  • View process guidance (opens either a SharePoint site or URL that's been configured as the team project's process guidance.
  • View reports (opens SQL Server Reporting Services). Go here to add or update reports for a team project.

Query results

Query results widget
Adds a configurable tile that lists the results of a shared query.

From the configuration dialog, select either a team favorite or shared query.

To create a shared query, see using queries.

Query tile

Query tile widget
Adds a configurable tile to display the summary of a shared query results.

From the configuration dialog, select either a team favorite or shared query. You can optionally specify rules to change the query tile color based on the number of work items returned by the query.

To create a shared query, see using queries.


Sprint burndown (team-scoped)

Sprint burndown widget

Adds the team's burndown chart for the current sprint to the dashboard. This chart always displays data for the current sprint.

Teams use the burndown chart to mitigate risk and check for scope creep throughout the sprint cycle.

Sprint capacity (team-scoped)

Sprint capacity widget

Inserts the team's capacity bar chart for the current sprint.

Teams specify their capacity to plan and monitor their sprint resources.

Sprint overview (team-scoped)

Sprint overview widget

For Team Services, inserts a configurable overview of sprint progress. You can choose between a count of story points or number of work items.

For on-premises TFS, inserts a visual overview of sprint progress indicating the number of backlog items in progress, completed, or not started.

Teams plan their sprints by defining sprints and assigning backlog items to an iteration.

Work links (team-scoped)

Work links widget

Provides quick access to open the following Agile tools and team resources:

Build, test, release


Chart for build history

Build history widget
Feature availability: You can access this widget from Team Services or TFS 2015.2 or later version. For TFS 2015.1 and earlier versions, see Add a chart to a dashboard to add build summary charts to a dashboard.

Adds a tile to display a histogram of all builds run for the configured build definition.

From the configuration dialog, select the build you want to monitor.

Hover over a bar to learn how long the build took to complete. Click the bar to open the summary for that specific build. Bar color indicates: green-completed, red-failed, and yellow-completed without tests.

Deployment status

Deployment status widget
Feature availability: You can only access this widget from Team Services or TFS 2017.

Configurable widget that shows a consolidated view of the deployment status and test pass rate across multiple environments for a recent set of builds. You configure the widget by specifying a build definition, branch, and linked release definitions.

Release definition overview

Release definition overview widget
Feature availability: You can only access this widget from Team Services.

Configurable widget that you can use to view and track the status of a release definition. The widget shows the release as a series of environments, with the name of the release and the date or time it was started. The color of the heading and the icon in each environment indicate the current status of the release, which are the same as are used on the Releases page. Select a release definition in the left column to filter the list to just releases for that definition. To learn more, see Add release information to the dashboard.

Requirements quality


Requirements quality widget
Feature availability: You can access this widget from Team Services or TFS 2017.

Configurable widget that you can use to track quality continuously from a build or release definition. To learn more, see Traceability with continuous testing.

Test results trend

Test results trend widget
Feature availability: You can access this widget from Team Services or TFS 2017.

Adds a configurable tile that displays the trend of test results, such as passed or failed tests, for the selected build definition.

From the configuration dialog, select the build whose test results you'd like to monitor. Then, choose the type of chart you want displayed. You can track the trend of test duration by adding an optional line chart.

To learn more about creating charts for tracking test results, see Track your test results.

Informational content and other links

Embedded web page

Embedded web page widget
Feature availability: You can access this widget from Team Services or TFS 2017 or later version.

Adds a configurable tile to display the contents of a web page. Only webpages that allow iframe embedding are supported.

Markdown

Markdown widget
Feature availability: For Team Services and TFS 2015.2 or later versions, you can configure the widget to point to a file stored in your repository.

Adds a configurable tile to display any type of information, guidance, or links that you want.

From the configuration dialog, add the information you want to share with your team.

To learn more about markdown format, see Markdown guidance.

Team members (team-scoped)

Team members widget

Shows team member profiles and, on-hover, their user account alias.

For team admins, supports access to the quick dialog to add or remove team members.


Team room (team-scoped)

Team room widget

Provides status and access to team rooms.

Team rooms support increased team productivity by providing a space to discuss work in progress, ask questions, share status, and clarify issues that arise. Team administrators can create additional team rooms.


Visual Studio Shortcuts

Visual Studio widget

Provides links to open or download Visual Studio. The Visual Studio IDE client comes with the Team Explorer plug-in which provides quick access to several features (some of which aren't available through the web portal).

Welcome

How to links widget

Provides links to the Work, Code, and Build hubs and reference documentation on how to add charts.

These represent the basic widgets. Look forward to more widgets becoming available in the coming months.

See also these additional resources for tracking and monitoring progress:

Marketplace widgets

You may find additional widgets of interest from the Marketplace.

If your account or project collection administrator disables a marketplace widget, you'll see the following image:

Disabled widget extension notification

To regain access to it, request your admin to reinstate or reinstall the widget.

Extensibility

Using the REST API service, you can create a dashboard widget. To learn more about the REST APIs for dashboards and widgets, go here.

Provide feedback

We welcome your feedback.

Send suggestions on UserVoice, and follow us on Twitter @VSTeam. Or, tell us what you think with Send-a-Smile on the title bar ... Send-a-Smile.

Or, see our comprehensive feedback and support page.