Manage Analytics views

Article
06/28/2022
5 minutes to read

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

With Analytics views, you gain a simplified way to specify and share the filter criteria for a Power BI report based on Analytics data. Analytics provides the reporting platform for Azure DevOps.

Important

Analytics views only support Azure Boards data (work items). Analytics views doesn't support other data types, such as Pipelines. Views provide a flat-list of work items, and don't support work item hierarchies. At this point, we have no plans to update the connector to support other types of data. For information on other approaches, read Power BI Integration Overview.

Use this article to learn how to:

Meet prerequisites to access Analytics views
Open Analytics views
Edit an existing view
Share a view
Favorite a view
Manage permissions for a shared view
Delete a view

Note

If Boards is disabled, then Analytics views will also be disabled and all widgets associated with work item tracking won't appear in the widget catalog and will become disabled. To re-enable a service, see Turn an Azure DevOps service on or off.

Prerequisites

You must be a member of a project with Basic access or higher. Anyone with access to the project, except those granted Stakeholder access, can view Analytics views. To learn more about access levels, see About access levels.
If you haven't been added as a project member, get added now.
Boards must be enabled. If it's disabled, Analytics views won't be displayed. To re-enable Boards, see Turn an Azure DevOps service on or off
The Analytics view preview features must be enabled either for individual users or for the organization.
The View Analytics permission must be set to Allow. For more information, see Grant permissions to access the Analytics service.

You must be a member of a project with Basic access or higher. Anyone with access to the project, except those granted Stakeholder access, can view Analytics views. To learn more about access levels, see About access levels.
If you haven't been added as a project member, get added now.
The Analytics service] must be installed and enabled.You must be an account owner or a member of the Project Collection Administrators group to install or enable it.
Boards must be enabled. If it's disabled, Analytics views won't display. To re-enable Boards, see Turn an Azure DevOps service on or off.
The View Analytics permission must be set to Allow. For more information, see Grant permissions to access the Analytics service.

Open Analytics to access views

Default Analytics views are defined for each project. You can view, modify, and create a custom view from Analytics.

If you don't see the project you want, choose the Azure DevOps logo to browse all projects.

For Azure DevOps Server 2019.1

After you install or enable Analytics, a set of default Analytics views are created for each project. You can view, modify, and create a custom view from Analytics.

For Azure DevOps Server 2019

After you install the Analytics Marketplace extension, a set of default Analytics views is created for each project. You can view, modify, and create a custom view from Analytics.

From your web portal, expand Overview and choose Analytics views.

Screenshot of expand overview and choose Analytics views.

From your web portal, expand Boards and choose Analytics views.

If you don't see Analytics, check that it's enabled for the project collection and that you have permissions to view Analytics. See the Prerequisites for this article.

Screenshot of expand Boards and choose Analytics views.

Edit an existing view

The creator of a view and all members of the Project Administrators and Project Collection Administrators groups have permissions to edit, manage, and delete views.

From either the Favorites or All page, hover over the view you want to edit, select the actions icon, and choose the Edit option. You can also choose Edit from the Summary panel.
You can edit any part of the view, in the same way you did to define a view. For details, see Create an Analytics view.
Save your changes.

Refresh your Power BI report to access the changes you made to the view.

Tip

If you remove fields from a view that are in use in the report, you'll need to update any Power BI report that references the view.

All contributors to a project can view shared views and create Power BI reports based on them. When you create a view, you can choose to make it private or shared.

To share a private view, edit the view and change the sharing option to Shared. To unshare a view, switch the sharing option to Private.

Important

If you plan to share Power BI reports or dashboards based on an Analytics view, make sure the view is Shared. Otherwise, you are the only one who can modify the view and manually refresh the data. We recommend sharing views to support shared reports and dashboards.

Screenshot of New View dialog, General tab.

Favorite a view

Favoriting an item provides a quick way to navigate to items you regularly visit. To favorite a view, hover over the view and choose the .

Screenshot of Analytics views, favorite a view.

Manage permissions for a shared view

All members of the Contributors group for your project can use Shared views in Power BI. For shared views that you create, you can manage the permissions of users and groups to create, delete, or view a specific shared view.

To change the permissions for a shared view, open Analytics views, and choose All. For details, see Create an Analytics view.
Choose the More Actions icon and then choose Security.
Change the permissions so that the team member or group can't edit or delete the view.
Add a user or group who you want to grant permissions to or restrict access.

Close the dialog when done. Your changes are automatically saved.

Choose Save changes when done.