Skip to content

Commit 9528102

Browse files
authored
Merge pull request #35717 from Petebro-MSFT/docs-editor/pin-reporting-services-items-t-1762193556
Update pin-reporting-services-items-to-power-bi-dashboards.md
2 parents ea45e86 + c45dc41 commit 9528102

2 files changed

Lines changed: 22 additions & 20 deletions

File tree

docs/includes/ssrs-no-pin-2-power-bi.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,4 +10,4 @@ ms.custom: include file
1010
---
1111

1212
>[!NOTE]
13-
>Pinning paginated reports to Power BI dashboards is deprecated for all releases of SQL Server Reporting Services after SQL Server Reporting Services 2019. It is discontinued starting in SQL Server Reporting Services 2022 and Power BI Report Server.
13+
>Pinning paginated reports to Power BI dashboards is deprecated and discontinued for all releases of SQL Server Reporting Services and Power BI Report Server.

docs/reporting-services/install-windows/power-bi-report-server-integration-configuration-manager.md

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,8 @@ ms.custom:
1818

1919
The **Power BI Integration** page in [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] Configuration Manager is used to register the report server with the desired Microsoft Entra tenant to allow users of the report server to pin supported report items to [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] dashboards. For a list of the supported items you can pin, see [Pin Reporting Services items to Power BI Dashboards](../../reporting-services/pin-reporting-services-items-to-power-bi-dashboards.md).
2020

21+
[!INCLUDE [ssrs-no-pin-2-power-bi](../../includes/ssrs-no-pin-2-power-bi.md)]
22+
2123
## <a name="bkmk_requirements"></a> Requirements for Power BI Integration
2224

2325
In addition to an active internet connection so you can browse to the [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] service, the following are requirements to complete [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] integration.
@@ -33,17 +35,17 @@ In addition to an active internet connection so you can browse to the [!INCLUDE[
3335
- The server with Reporting Services installed needs to be configured to use TLS 1.2 or newer. For more information, see [Transport Layer Security (TLS) best practices with the .NET Framework](/dotnet/framework/network-programming/tls).
3436

3537

36-
- Reports that you want to pin from must use stored credentials. This is not a requirement of the [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] integration itself but of the refresh process for the pinned items. The action of pinning a report item creates a [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] subscription to manage the refresh schedule of the tiles in [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)]. [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] subscriptions require stored credentials. If a report does not use stored credentials, a user can still pin report items but when the associated subscription attempts to refresh the data to [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)], you will see an error message similar to the following on the **My Subscriptions** page.
38+
- Reports that you want to pin from must use stored credentials. This isn't a requirement of the [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] integration itself but of the refresh process for the pinned items. The action of pinning a report item creates a [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] subscription to manage the refresh schedule of the tiles in [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)]. [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] subscriptions require stored credentials. If a report doesn't use stored credentials, a user can still pin report items but when the associated subscription attempts to refresh the data to [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)], you'll see an error message similar to the following on the **My Subscriptions** page.
3739

38-
PowerBI Delivery error: dashboard: IT Spend Analysis Sample, visual: Chart2, error: The current action cannot be completed. The user data source credentials do not meet the requirements to run this report or shared dataset. Either the user data source credential.
40+
Power BI Delivery error: dashboard: IT Spend Analysis Sample, visual: Chart2, error: The current action can't be completed. The user data source credentials don't meet the requirements to run this report or shared dataset. Either the user data source credential.
3941

4042
For more information on how to store credentials, see the section "Configure stored credentials for a report-specific data source" in [Store Credentials in a Reporting Services Data Source](../../reporting-services/report-data/store-credentials-in-a-reporting-services-data-source.md).
4143

42-
An administrator can review the [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] log files for more information. They will see messages similar to the following. A great way to review and monitor [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] logs files is to use [!INCLUDE[msCoName](../../includes/msconame-md.md)] Power Query over the files. for more information and a short video, see [Report Server Service Trace Log](../../reporting-services/report-server/report-server-service-trace-log.md).
44+
An administrator can review the [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] log files for more information. They'll see messages similar to the following. A great way to review and monitor [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] logs files is to use [!INCLUDE[msCoName](../../includes/msconame-md.md)] Power Query over the files. For more information and a short video, see [Report Server Service Trace Log](../../reporting-services/report-server/report-server-service-trace-log.md).
4345

44-
- subscription!WindowsService_1!1458!09/24/2015-00:09:27:: e ERROR: PowerBI Delivery error: dashboard: IT Spend Analysis Sample, visual: Chart2, error: The current action cannot be completed. The user data source credentials do not meet the requirements to run this report or shared dataset. Either the user data source credentials are not stored in the report server database, or the user data source is configured not to require credentials but the unattended execution account is not specified.
46+
- subscription!WindowsService_1!1458!09/24/2015-00:09:27:: e ERROR: Power BI Delivery error: dashboard: IT Spend Analysis Sample, visual: Chart2, error: The current action can't be completed. The user data source credentials don't meet the requirements to run this report or shared dataset. Either the user data source credentials are not stored in the report server database, or the user data source is configured not to require credentials but the unattended execution account isn't specified.
4547

46-
- notification!WindowsService_1!1458!09/24/2015-00:09:27:: e ERROR: Error occurred processing subscription fcdb8581-d763-4b3b-ba3e-8572360df4f9: PowerBI Delivery error: dashboard: IT Spend Analysis Sample, visual: Chart2, error: The current action cannot be completed. The user data source credentials do not meet the requirements to run this report or shared data set. Either the user data source credentials are not stored in the report server database, or the user data source is configured not to require credentials but the unattended execution account is not specified.
48+
- notification!WindowsService_1!1458!09/24/2015-00:09:27:: e ERROR: Error occurred processing subscription fcdb8581-d763-4b3b-ba3e-8572360df4f9: Power BI Delivery error: dashboard: IT Spend Analysis Sample, visual: Chart2, error: The current action can't be completed. The user data source credentials don't meet the requirements to run this report or shared data set. Either the user data source credentials aren't stored in the report server database, or the user data source is configured not to require credentials but the unattended execution account isn't specified.
4749

4850
## <a name="bkmk_steps2integrate"></a> To Integrate and Register the Report Server
4951

@@ -54,7 +56,7 @@ Complete the following steps from the [!INCLUDE[ssRSnoversion](../../includes/ss
5456
2. Select **Register with Power BI**.
5557

5658
>[!Note]
57-
> Make sure that port 443 is not blocked.
59+
> Make sure that port 443 isn't blocked.
5860
5961
3. At the [!INCLUDE[msCoName](../../includes/msconame-md.md)] sign-in dialog, enter the credentials you use to sign into [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)].
6062

@@ -64,37 +66,37 @@ Complete the following steps from the [!INCLUDE[ssRSnoversion](../../includes/ss
6466

6567
## <a name="bkmk_unregister"></a> Unregister With Power BI
6668

67-
**Unregister:** Un-registering the report server from Microsoft Entra ID will result in the following:
69+
**Unregister:** Un-registering the report server from Microsoft Entra ID results in the following:
6870

69-
- The **My Settings** link will no longer be visible from the web portal menu bar.
71+
- The **My Settings** link is no longer visible from the web portal menu bar.
7072

7173
- Report items that have already been pinned will still be pinned to dashboards, however the tiles will no longer be updated on the dashboard.
7274

73-
- The [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] subscriptions that were updating the tiles will still exist on the report server but when they run on their configured schedule, they will show an error message similar to the following.
75+
- The [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] subscriptions that were updating the tiles still exist on the report server, but when they run on their configured schedule, they show an error message similar to the following:
7476

7577
**The delivery extension for this subscription could not be loaded**
7678

7779
From the **Power BI** page of configuration manager, select the **Unregister with Power BI** button.
7880

7981
## <a name="bkmk_updateregistration"></a> Update Registration
8082

81-
Use the **Update Registration** if the configuration of your report server has changed. For example if you want to add or remove the URLS your users use to browse to the [!INCLUDE[ssRSWebPortal](../../includes/ssrswebportal.md)].
83+
Use the **Update Registration** if the configuration of your report server has changed. For example, if you want to add or remove the URLs your users use to browse to the [!INCLUDE[ssRSWebPortal](../../includes/ssrswebportal.md)].
8284

8385
- In [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] Configuration Manager, select the **Web Portal URL**
8486

8587
Select **Advanced**.
8688

8789
- Select **Add** to add a new HTTP identity for the [!INCLUDE[ssRSWebPortal](../../includes/ssrswebportal.md)] and then select **OK**.
8890

89-
The [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] icon will change to indicate the server configuration has changed. ![ssrs_powebi_icon_warning](../../reporting-services/install-windows/media/ssrs-powebi-icon-warning.png "ssrs_powebi_icon_warning")
91+
The [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] icon changes to indicate the server configuration has changed. ![ssrs_powebi_icon_warning](../../reporting-services/install-windows/media/ssrs-powebi-icon-warning.png "ssrs_powebi_icon_warning")
9092

9193
- On the **Power BI Integration** page, select **Update Registration**.
9294

93-
You will be prompted to login to Microsoft Entra ID. The page will refresh and you will see the new URL listed in the **Redirect URLs**.
95+
You'll be prompted to log in to Microsoft Entra ID. The page will refresh and you'll see the new URL listed in the **Redirect URLs**.
9496

9597
## <a name="bkmk_integration_process"></a> Summary of the Power BI Integration and Pin Process
9698

97-
This sections summarizes the basic steps and technologies involved when you integrate your report server with [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] and pin a report item to a dashboard.
99+
This section summarizes the basic steps and technologies involved when you integrate your report server with [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] and pin a report item to a dashboard.
98100

99101
**Integrate:**
100102

@@ -114,21 +116,21 @@ This sections summarizes the basic steps and technologies involved when you inte
114116

115117
1. Users preview reports in the [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] [!INCLUDE[ssRSWebPortal](../../includes/ssrswebportal.md)] and the first time they click to pin a report item from the [!INCLUDE[ssRSWebPortal](../../includes/ssrswebportal.md)].
116118

117-
2. They will be redirected to the Microsoft Entra sign-in page. They can also sign in from the [!INCLUDE[ssRSWebPortal](../../includes/ssrswebportal.md)] **My Settings** page. When users sign in to the Azure managed tenant, a relationship is established between their Azure account and the [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] permissions. For more information, see [My Settings for Power BI Integration &#40;web portal&#41;](../my-settings-for-power-bi-integration-web-portal.md).
119+
2. They'll be redirected to the Microsoft Entra sign-in page. They can also sign in from the [!INCLUDE[ssRSWebPortal](../../includes/ssrswebportal.md)] **My Settings** page. When users sign in to the Azure managed tenant, a relationship is established between their Azure account and the [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] permissions. For more information, see [My Settings for Power BI Integration &#40;web portal&#41;](../my-settings-for-power-bi-integration-web-portal.md).
118120

119121
3. A user security token is returned to the report server.
120122

121123
4. The user security token is saved to the ReportServer database.
122124

123-
5. A list of groups, and dashboards, the user has access to are retrieved from the [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] service. The user selects the destination group, and dashboard, and the configure how often they want the data refreshed on the [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] tile.
125+
5. A list of groups, and dashboards, the user has access to are retrieved from the [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] service. The user selects the destination group and dashboard, and then configures how often they want the data refreshed on the [!INCLUDE[sspowerbi](../../includes/sspowerbi-md.md)] tile.
124126

125127
6. The report item is pinned to the dashboard.
126128

127129
7. A [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] subscription is created to manage the scheduled refresh of the report item to the dashboard tile. The subscription uses the security token that was created when the user signed in.
128130

129-
The token is good for **90 days**, after which users need to sign in again to create a new user token. When the token is expired, the pinned tiles will still be displayed on the dashboard but the data will no longer be refreshed. The [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] subscriptions used for the pinned items will error until a new user token is created. See [My Settings for Power BI Integration &#40;web portal&#41;](../my-settings-for-power-bi-integration-web-portal.md). for more information.
131+
The token is good for **90 days**, after which users need to sign in again to create a new user token. When the token is expired, the pinned tiles will still be displayed on the dashboard but the data will no longer be refreshed. The [!INCLUDE[ssRSnoversion](../../includes/ssrsnoversion-md.md)] subscriptions used for the pinned items error until a new user token is created. See [My Settings for Power BI Integration &#40;web portal&#41;](../my-settings-for-power-bi-integration-web-portal.md). for more information.
130132

131-
The second time a user pins an item, the steps 1-4 are skipped and instead the App id and URLS are retrieved from the ReportServer database and the flow continues with step 5.
133+
The second time a user pins an item, the steps 1-4 are skipped and instead the App ID and URLS are retrieved from the ReportServer database and the flow continues with step 5.
132134

133135
![Diagram showing what happens when a user pins a report item to a dashboard.](../../reporting-services/install-windows/media/ssrs-pin-to-powerbi-flow.png)
134136

@@ -142,15 +144,15 @@ The second time a user pins an item, the steps 1-4 are skipped and instead the A
142144

143145
4. The token is sent to Microsoft Entra ID for validation. If the token is valid, the report item data is sent to the dashboard tile and the date property of the tile is updated.
144146

145-
5. If the token is not valid, and error is returned and logged with the report server. No status or other information is sent to the dashboard.
147+
5. If the token isn't valid, and error is returned and logged with the report server. No status or other information is sent to the dashboard.
146148

147149
![Diagram showing what happens when a subscription fires to refresh a dashboard tile.](../../reporting-services/install-windows/media/ssrs-subscription-to-powerbi-flow.png)
148150

149151
> [!VIDEO https://www.youtube-nocookie.com/embed/QhPQObqmMPc]
150152
151153
## Considerations and limitations
152154

153-
* Viral and government tenants are not supported.
155+
* Viral and government tenants aren't supported.
154156

155157
## Related content
156158

0 commit comments

Comments
 (0)