Merge pull request #8097 from MicrosoftDocs/users/chcomley/curation-stale-low-views

Report/sql-reports - Curate, redirect, migrate content, refresh

Author: denrea

docs/report/.openpublishing.redirection.report.json

@@ -340,6 +340,11 @@
       "source_path_from_root": "/docs/report/powerbi/analytics-default-views.md",
       "redirect_url": "/azure/devops/report/powerbi/what-are-analytics-views",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/report/sql-reports/migration-guide.md",
+      "redirect_url": "/azure/devops/report/powerbi/reporting-roadmap",
+      "redirect_document_id": true
     }
   ]
 }

docs/report/powerbi/report - Shortcut.lnk

@@ -1,57 +1,118 @@
 ---
-title: Reporting roadmap
+title: Reporting roadmap and migration guide
 titleSuffix: Azure DevOps 
-description: Learn about the reporting roadmap for Azure DevOps.
+description: Learn about the reporting roadmap for Azure DevOps and how to migrate from SQL Reporting Services to Analytics.
 ms.subservice: azure-devops-analytics
 ms.author: chcomley
 author: chcomley
 ms.topic: conceptual
 monikerRange: '<= azure-devops'
-ms.date: 07/26/2022
+ms.date: 07/07/2025
 ---
 
-# Reporting roadmap for Azure DevOps 
+# Reporting roadmap and migration guide
 
 [!INCLUDE [version-lt-eq-azure-devops](../../includes/version-lt-eq-azure-devops.md)]
 
-The Analytics service provides support for Azure DevOps reporting. It is available for Azure DevOps Server 2019 and later versions.  It replaces the previous platform based on SQL Server Reporting Services. 
+The Analytics service provides support for Azure DevOps reporting and is available for Azure DevOps Server. It replaces the previous platform based on SQL Server Reporting Services. 
 
-With the release of Azure DevOps Server 2022, the only option for gaining Azure DevOps data insights is the Analytics service. Integration with SQL Server Reporting Services is no longer supported. For guidance on migrating from using SQL Reporting Services to Analytics, see [Migrate to Analytics from SQL Reporting Services for Azure DevOps](../sql-reports/migration-guide.md). 
+With the release of Azure DevOps Server 2022, the only option for gaining Azure DevOps data insights is the Analytics service. Integration with SQL Server Reporting Services is no longer supported. 
 
-For additional information, see the following articles: 
+For more information, see the following articles: 
 
 - [What is Analytics](../powerbi/what-is-analytics.md)
 - [Data Available in Analytics](../powerbi/data-available-in-analytics.md) 
 
 > [!NOTE]  
-> If you are looking for information about the Azure Analysis Services, see 
+> If you're looking for information about the Azure Analysis Services, see 
 [Azure Analysis Services](https://azure.microsoft.com/services/analysis-services/).
 
 ## The Analytics service
 
-::: moniker range=">= azure-devops-2020"
-
 Analytics is generally available for Azure DevOps Services and Azure DevOps Server 2020 and later versions. It provides several [advanced widgets](../dashboards/analytics-widgets.md) and supports [Power BI integration](overview.md) and access to the [OData feed](../extend-analytics/quick-ref.md). 
 
-::: moniker-end
-
 For more information, see [What is Analytics](what-is-analytics.md). It currently contains partial data. We're working to add all reportable data to Analytics. For more information, see [Data Available in Analytics](data-available-in-analytics.md).
 
-## Azure DevOps Server, TFS, and SQL Server Reporting
+## Migrating from SQL Reporting Services to Analytics
+
+If you're migrating from SQL Server Reporting Services to Analytics, the following guidance helps you make the transition successfully.
+
+### Key differences between SQL Reporting Services and Analytics
+
+- **Analytics** is an object-relational mapper, whereas **SQL Server Reporting Services** data is based on a relational database and online analytical processing (OLAP) cube
+- **Analytics** doesn't require any maintenance
+- **Analytics** stores all work tracking fields, except for HTML/rich-text fields. Custom fields are automatically added to the Analytics data store
+- **Analytics** isn't a real-time store but a curated copy of data with up to a 30-second delay before changes appear
+
+### Migration best practices
+
+- Always limit your query to the projects you have access to. You can generate cross-project reports using Power BI, however, queries only return data when you have permissions to view Analytics data for all projects you query
+- Use built-in dashboards to support views of multiple charts. Several features support viewing multiple charts within an Azure DevOps configurable dashboard
+- Identify the insights you need to make data-driven decisions. Then, use a combination of queries, dashboards, built-in reports, or Power BI and OData queries to generate the needed reports
+
+### Key features available with Analytics
+
+Analytics provides many capabilities that weren't available with SQL Server Reporting Services. Key features include:
+
+- **Advanced dashboard widgets**: Analytics-powered widgets for status and trend views, including Velocity, Burndown, Cumulative Flow Diagram, and Lead/Cycle Time widgets. For a complete overview, see the [widget catalog](../dashboards/widget-catalog.md)
+- **Built-in Analytics reports**: In-context reports for Azure Boards, Pipelines, and Test Plans that display real-time analytics data. For more information, see [About dashboards, charts, reports, & widgets](../dashboards/overview.md)
+- **Power BI integration**: Direct connectivity to create custom reports and dashboards using Power BI with Analytics data through OData feeds and Analytics views
+- **Analytics views**: Simplified way to create filtered datasets for Power BI reporting without writing OData queries. See [What are Analytics views?](../powerbi/what-are-analytics-views.md)
+- **OData API access**: Direct programmatic access to Analytics data for custom integrations and reporting solutions
+- **Rollup capabilities**: Progress bars and totals for descendant work items in hierarchies, available in any backlog view. For more information, see [Display rollup progress or totals](../../boards/backlogs/display-rollup.md)
+- **Enhanced query charts**: Query-based charts with grouping by tags, areas, iterations, and custom fields
+- **Real-time traceability**: End-to-end tracking from requirements to deployment through linked work items, branches, commits, pull requests, builds, and releases. For more information, see [End-to-end traceability](../../cross-service/end-to-end-traceability.md)
+- **Pipeline insights**: Comprehensive widgets for build and release pipeline analytics, including [Release pipeline overview](../dashboards/widget-catalog.md#release-definition-widget) and [Requirements quality](../dashboards/widget-catalog.md#requirements-quality-widget)
+- **Test analytics**: Advanced test reporting capabilities including test results trends, failure analysis, and test duration insights
+- **Velocity and burndown charts**: Built-in sprint and release tracking with configurable time periods and team comparisons
+
+For a complete list of Analytics capabilities, see [Data Available in Analytics](data-available-in-analytics.md).
+
+### Analytics tools and concepts
 
-Since [Team Foundation Server (TFS)](https://visualstudio.microsoft.com/tfs/) was released in 2005, we've offered a reporting solution [based on a data warehouse and OLAP cube](/previous-versions/azure/devops/report/sql-reports/reporting-services-reports), coupled with [a SQL Server Reporting Services server](/previous-versions/azure/devops/report/sql-reports/create-and-manage-reporting-services-reports) to host reports.
+The Analytics data model consists of entity sets, whose members (entities) contain properties that can be filtered, aggregated, and summarized. For an overview of supported entity sets and entity types, see [Data model for Analytics](../extend-analytics/data-model-analytics-service.md).
 
-![TFS Data warehouse architecture conceptual diagram](../sql-reports/media/datawarehouse-architecture.png)
+The following tools support interaction with the Analytics service:
 
-While the configuration is complex, it provides a powerful solution. You can create custom reports by writing [customized SSRS reports](../sql-reports/create-and-manage-reporting-services-reports.md?toc=/azure/devops/report/sql-reports/toc.json&bc=/azure/devops/report/sql-reports/breadcrumb/to]c.json). You can also create reports [using Excel](/previous-versions/azure/devops/report/admin/create-status-and-trend-excel-reports), and share them on SharePoint once you've [configured SharePoint to host Excel Charts](/previous-versions/azure/devops/report/sharepoint-dashboards/configure-sharepoint-tfs-2017-earlier).
+- **Analytics views**: Provide a quick way to generate reports based on work tracking and test cases. You can define an Analytics view and share with others. Using Power BI, you can build any type of report Power BI supports. To learn more, see [What are Analytics views?](../powerbi/what-are-analytics-views.md)
+- **Power BI**: Connect to Analytics from Power BI through an Analytics view, OData query, or OData feed. See [About Power BI integration](../powerbi/overview.md)
+- **OData query**: Use OData to directly query Analytics from a supported browser and use the returned JSON data as needed
+- Programmatic query of the Analytics metadata [Construct OData queries for Analytics, URL components to query the metadata](../analytics/analytics-query-parts.md#query-metadata)
 
-We have no plans to bring a cloud version of our SQL Server Reporting story to Azure DevOps Services.
+### Analytics permissions
+
+To access and work with Analytics data, users need appropriate project-level permissions. The core Analytics permissions include:
+
+- **View Analytics**: Required to access Analytics data through OData queries, Power BI connections, and Analytics widgets. By default, all Contributors with Basic access have this permission. Users with Stakeholder access don't have permission to view or edit Analytics views.
+- **Delete Shared Analytics views**: Allows users to delete Analytics views that are shared with the project
+- **Edit Shared Analytics views**: Allows users to modify Analytics views that are shared with the project
+
+For individual Analytics views, creators can set specific permissions to control who can view, edit, and delete their shared views. For detailed information about setting up and managing these permissions, see [Set permissions to access Analytics and Analytics views](../powerbi/analytics-security.md).
+
+### Query performance and latency
+
+Analytics is optimized for read and aggregation performance, and reduces the effect reporting scenarios have on Azure DevOps. The data copy introduces up to a 30-second delay before the data associated with any one change shows up in Analytics. For more information, see [OData Analytics query guidelines](../extend-analytics/odata-query-guidelines.md).
 
 ## Future of SQL Server Reporting
 
-The SQL Server Reporting Services platform is supported on all on-premises deployments from Azure DevOps Server 2020 and earlier versions. 
-Azure DevOps Server 2020 is the last version to support SQL Server Reporting. Future versions will support only Analytics. This plan allows customers time to convert their reports to Analytics.
+The SQL Server Reporting Services platform is supported on Azure DevOps Server 2020 and all earlier on-premises versions. However, **Azure DevOps Server 2020 is the final version to support SQL Server Reporting Services**. 
+
+**Starting with Azure DevOps Server 2022 and all future versions**, only Analytics is supported for reporting and data insights. This transition timeline provides you with adequate time to migrate your existing SQL Server Reporting Services reports to Analytics.
+
+> [!IMPORTANT]
+> **Azure DevOps Services** doesn't support SQL Server Reporting Services and continues to use only Analytics for all reporting capabilities. There are no plans to introduce SQL Server Reporting Services support to the cloud service.
  
 ## Roadmap timeline
 
 Check out the [Features Timeline](/azure/devops/release-notes/features-timeline) for the roadmap of reporting features.
+
+## Recommended resources
+
+**Power BI and OData**
+- [Power BI Desktop download page](/power-bi/desktop-what-is-desktop)
+
+**Learn resources**:  
+- [Run quality tests in your build pipeline by using Azure Pipelines](/training/modules/run-quality-tests-build-pipeline)
+- [Run functional tests in Azure DevOps](/training/modules/run-functional-tests-azure-pipelines)
+
+For an overview of supported entity sets and entity types, see [Data model for Analytics](../extend-analytics/data-model-analytics-service.md).