Skip to content

Commit

Permalink
Merging changes synced from https://github.com/MicrosoftDocs/powerbi-…
Browse files Browse the repository at this point in the history
…docs-pr (branch live)
  • Loading branch information
Learn Build Service GitHub App authored and Learn Build Service GitHub App committed Feb 3, 2025
2 parents 256ca5d + 82b5d1a commit ebf2138
Show file tree
Hide file tree
Showing 22 changed files with 101 additions and 524 deletions.
7 changes: 6 additions & 1 deletion .openpublishing.redirection.json
Original file line number Diff line number Diff line change
Expand Up @@ -6415,6 +6415,11 @@
"source_path": "powerbi-docs/create-reports/filters-copilot.md",
"redirect_url": "/power-bi/create-reports/service-the-report-editor-take-a-tour",
"redirect_document_id": false
}
},
{
"source_path": "powerbi-docs/developer/visuals/scanner-api.md",
"redirect_url": "/power-bi/developer",
"redirect_document_id": false
}
]
}
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
11 changes: 10 additions & 1 deletion powerbi-docs/create-reports/power-bi-dark-mode.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ ms.reviewer: ''
ms.service: powerbi
ms.subservice: pbi-reports-dashboards
ms.topic: how-to
ms.date: 11/29/2024
ms.date: 01/03/2025
LocalizationGroup: Create reports
---
# Dark mode in Power BI Desktop
Expand Down Expand Up @@ -41,6 +41,10 @@ There's a mode for every window in Power BI Desktop. For example, for dark mode:

:::image type="content" source="media/power-bi-dark-mode/dark-mode-report-view.png" alt-text="Screenshot of Dark mode for report view." lightbox="media/power-bi-dark-mode/dark-mode-report-view.png":::

> [!NOTE]
> Dark mode is not applied to the Report view Canvas, including the Filter Pane and Wallpaper.

## Model view

:::image type="content" source="media/power-bi-dark-mode/dark-mode-model-view.png" alt-text="Screenshot of Dark mode for model view." lightbox="media/power-bi-dark-mode/dark-mode-model-view.png":::
Expand All @@ -55,6 +59,11 @@ There's a mode for every window in Power BI Desktop. For example, for dark mode:

Try the different modes and see which you prefer.

## Considerations and limitations

Collapsing of the **Power Query** editor ribbon is not currently available in Dark mode or Light mode.


## Related content

- [Create reports in Power BI Desktop with Copilot](copilot-create-desktop-report.md)
Expand Down
4 changes: 1 addition & 3 deletions powerbi-docs/developer/embedded/TOC.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
items:
- name: "Create a Microsoft Entra tenant"
href: create-an-azure-active-directory-tenant.md
- name: "Power BI app registration tool"
- name: "Register a Power BI app"
href: register-app.md
- name: "Configure credentials"
href: configure-credentials.md
Expand Down Expand Up @@ -150,8 +150,6 @@
href: dev-camp-links.md
- name: "Developer center"
href: https://powerbi.microsoft.com/en-us/developers/
- name: "Embedding setup tool"
href: https://aka.ms/embedsetup
- name: "Embedded analytics playground"
href: https://go.microsoft.com/fwlink/?linkid=848279
- name: "Power BI embedded analytics Client APIs"
Expand Down
8 changes: 2 additions & 6 deletions powerbi-docs/developer/embedded/dev-camp-links.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ ms.author: monaberdugo
ms.service: powerbi
ms.subservice: powerbi-developer
ms.topic: reference
ms.date: 11/05/2023
ms.date: 02/02/2025
---

# Power BI Dev Camp
Expand All @@ -31,7 +31,7 @@ The Power BI Dev Camp tutorials are targeted toward developers who are intereste

---

* [Tabular-Object-Model-Tutorial](https://github.com/PowerBiDevCamp/Tabular-Object-Model-Tutorial) - A tutorial and sample code programming semantic model that use the Tabular Object Model with Power BI Desktop and the Power BI service via the XMLA endpoint.
* [Tabular-Object-Model-Tutorial](https://github.com/PowerBiDevCamp/Tabular-Object-Model-Tutorial) - A tutorial and code programming semantic model that use the Tabular Object Model with Power BI Desktop and the Power BI service via the XMLA endpoint.

* [PowerBI-PowerShell-Tutorial](https://github.com/PowerBiDevCamp/PowerBI-PowerShell-Tutorial) - Student files for the Power BI PowerShell tutorial from Power BI Dev Camp.

Expand Down Expand Up @@ -59,10 +59,6 @@ The Power BI Dev Camp examples provide additional resources for developers who a

* [Tenant management application for Power BI](https://github.com/PowerBiDevCamp/TenantManagement) - A .NET 5 sample application that demonstrates how to manage service principals within a large-scale Power BI embedding environment with thousands of customer tenants.

## Videos

To view Power BI Dev Camp videos, go to the [video page](https://www.powerbidevcamp.net/videos/).

## Presentations

To download Power BI Dev Camp presentations, go to the [Camp-Sessions](https://github.com/PowerBiDevCamp/Camp-Sessions) GitHub repository.
Expand Down
19 changes: 14 additions & 5 deletions powerbi-docs/developer/embedded/embed-auto-install-app.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,14 @@
---
title: Automatically install Power BI apps when embedding content for your organization
title: Automatically install Power BI apps for your organization
description: Learn how to set up automatic app installation for Power BI apps when embedding content from apps for your organization.
author: mberdugo
ms.author: monaberdugo
ms.topic: how-to
ms.service: powerbi
ms.subservice: powerbi-developer
ms.custom:
ms.date: 06/03/2024
ms.date: 01/07/2025
# customer intent: As a developer, I want to learn how to set up automatic app installation for Power BI apps when embedding content from apps for my organization.
---

# Automatically install Power BI apps when embedding content for your organization
Expand All @@ -22,11 +23,14 @@ If you have access to an app that isn't installed, and try to embed app content,

## Embedding for Power BI users (User owns data)

To allow the automatic installation of apps for your users, add the *Create APIs* permission to your application when you're [registering your application](register-app.md#step-2---register-your-application). If you've already registered your app, add the Create APIs permission by [changing your application's permissions](/power-bi/developer/embedded/change-permissions).
To allow the automatic installation of apps for your users:

:::image type="content" source="media/embed-auto-install-app/register-app-create-content.png" alt-text="Screenshot of the Power BI embedding setup tool, which shows the selected Create APIs option.":::
1. Add the *Create APIs* permission to your application when you're [registering your application](register-app.md). If you've already registered your app, add the Create APIs permission by [changing your application's permissions](/power-bi/developer/embedded/change-permissions).

Provide the app ID in the embed URL. To provide the app ID, the app creator must install the app and then use one of the supported [Power BI REST API](/rest/api/power-bi/) calls, such as [Get Reports](/rest/api/power-bi/reports/getreports) or [Get Dashboards](/rest/api/power-bi/dashboards/getdashboards). The app creator must take the embed URL from the REST API response. The app ID appears in the URL if the content is from an app. Use the embed URL to embed content.
:::image type="content" source="media/embed-auto-install-app/register-app-create-content.png" alt-text="Screenshot of the Power BI embedding setup tool, which shows the selected Create APIs option.":::

1. Provide the app ID in the embed URL. To provide the app ID, the app creator must install the app and then use one of the supported [Power BI REST API](/rest/api/power-bi/) calls, such as [Get Reports](/rest/api/power-bi/reports/getreports) or [Get Dashboards](/rest/api/power-bi/dashboards/getdashboards). The app creator must take the embed URL from the REST API response. The app ID appears in the URL if the content is from an app.
1. Use the embed URL to embed content.

## Secure embedding

Expand All @@ -37,3 +41,8 @@ To use automatic application installation, the app creator must install the app.
* You can only embed reports and dashboards in this scenario.

* This feature is currently not supported for app-owns data or SharePoint embedding scenarios.

## Related content

* [Register a Power BI Embedded app](register-app.md)
* [Embed content for your organization](embed-sample-for-your-organization.md)
41 changes: 9 additions & 32 deletions powerbi-docs/developer/embedded/embed-paginated-reports.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: Embed paginated reports in your Power BI application
description: Learn how to integrate or embed a Power BI paginated report into a Power BI embedded analytics application.
title: Embed paginated reports in your embedded analytics app
description: Learn how to integrate or embed a Power BI paginated report into an embedded analytics application, and explore its features and capabilities.
author: mberdugo
ms.author: monaberdugo
ms.reviewer:
ms.topic: how-to
ms.service: powerbi
ms.subservice: powerbi-developer
ms.custom: ''
ms.date: 01/08/2024
#Customer intent: As a developer, I want to embed paginated reports in my application to provide my users with interactive and integrated reports.
ms.date: 02/02/2025
#customer intent: As a developer, I want to learn how to integrate or embed a Power BI paginated report into an embedded analytics application.
---

# Embed Power BI paginated reports
Expand Down Expand Up @@ -76,38 +76,15 @@ In Power BI service, create a workspace for your paginated report.

### [Embed for your customers](#tab/customers)

Before you import or upload a paginated report to embed, you must assign the workspace containing the report to a capacity. There are two types of capacity you can choose from:
Before you import or upload a paginated report to embed, you must assign the workspace containing the report to a capacity.

* **Power BI Premium** - To embed a paginated report, you need an *EM* or *P* SKU. For more information about this subscription, see [What is Power BI Premium?](../../enterprise/service-premium-what-is.md).
* **Azure Power BI Embedded** - You can purchase a capacity from the [Microsoft Azure portal](https://portal.azure.com). This subscription uses the *A* SKUs. For details on how to create a Power BI Embedded capacity, see [Create Power BI Embedded capacity in the Azure portal](azure-pbie-create-capacity.md).

The following table describes the resources and limits of each SKU. To determine which capacity best fits your needs, see the [which SKU should I purchase for my scenario](./embedded-faq.yml#which-solution-should-i-choose-) table.

| Capacity Nodes | V-cores | RAM (GB) |
| --- | --- | --- |
| EM1/A1 | 1 | 2.5 |
| EM2/A2 | 2 | 5 |
| EM3/A3 | 4 | 10 |
| P1/A4 | 8 | 25 |
| P2/A5 | 16 | 50 |
| P3/A6 | 32 | 100 |
To figure out what kind of capacity you need, see [Microsoft Fabric concepts](/fabric/enterprise/licenses#microsoft-fabric-concepts).

### [Embed for your organization](#tab/organization)

By creating a capacity, you can take advantage of having a resource for the content in your app workspace. For paginated reports, you must back your app workspace with an *EM* or a *P* capacity. You can create a capacity with [Power BI Premium](../../enterprise/service-premium-what-is.md).

The following table lists the Power BI Premium SKUs that create a capacity for paginated reports in [Microsoft Office 365](/microsoft-365):
By creating a capacity, you can take advantage of having a resource for the content in your app workspace. For paginated reports, you must back your app workspace with an *EM*, *P*, or *F* capacity. You can create a capacity with [Power BI Premium](../../enterprise/service-premium-what-is.md).

| Capacity node | V-cores | RAM (GB) | DirectQuery/live connection limits (per sec) |
| --- | --- | --- | --- |
| EM1/A1 | 1 | | 3.75 |
| EM2/A2 | 2 | | 7.5 |
| EM3/A3 | 4 | | 15 |
| P1/A4 | 8 | 25 | 30 |
| P2/A5 | 16 | 50 | 60 |
| P3/A6 | 32 | 100 | 120 |
| P4 | 64 | 200 | 240 |
| P5 | 128 | 400 | 480 |
Learn more about capacities and SKUs at [Microsoft Fabric concepts](/fabric/enterprise/licenses#microsoft-fabric-concepts).

---

Expand Down Expand Up @@ -191,7 +168,7 @@ For more information on embedding tokens, see [Embedded analytics access tokens]
---

* Paginated reports don't support client-side events (like `loaded` or `rendered`).
* Paginated reports don't support client-side setAccessToken API (you can not update acccess token without reloading the report).
* Paginated reports don't support client-side setAccessToken API (you cannot update access token without reloading the report).
* Embedding paginated reports with a real-time dataset (push dataset) is not supported.

## Related content
Expand Down
21 changes: 5 additions & 16 deletions powerbi-docs/developer/embedded/embedded-faq.yml
Original file line number Diff line number Diff line change
Expand Up @@ -365,36 +365,25 @@ sections:
answer: |
There's no special Azure pricing for non-profit and educational entities.
- name: Embedding setup tool
- name: Set up environment
questions:
- question: |
What is the Embedding setup tool?
answer: |
The [Embedding setup tool](https://app.powerbi.com/embedsetup) allows you to quickly get started and download a sample application to begin embedding with Power BI.
The Embedding setup tool was a tool that allowed you to quickly register and download a sample application to begin embedding with Power BI. This tool has been retired. To register an app see [Register an app](register-app.md).
- question: |
Which solution should I choose?
answer: |
* [Embedding for your customers](embedded-analytics-power-bi.md#embed-for-your-customers) provides the ability to embed dashboards and reports to users who don't have an account for Power BI. In the [Embedding setup tool](https://app.powerbi.com/embedsetup), run the *Embed for your customers* solution.
* [Embedding for your organization](embedded-analytics-power-bi.md#embed-for-your-organization) allows you to extend the Power BI service. In the [Embedding setup tool](https://app.powerbi.com/embedsetup), run the *Embed for your organization* solution.
- question: |
I've downloaded the sample app, which solution do I choose?
answer: |
If you're working with the **Embed for your customers** experience, save and unzip the `PowerBI-Developer-Samples.zip` file. Then open the `PowerBI-Developer-Samples-master\App Owns Data` folder and run the `PowerBIEmbedded_AppOwnsData.sln` file.
If you're working with the **Embed for your organization** experience, save and unzip the `PowerBI-Developer-Samples.zip` file. Then open the `PowerBI-Developer-Samples-master\User Owns Data\integrate-report-web-app` folder and run the `pbi-saas-embed-report.sln` file.
* [Embedding for your customers](embedded-analytics-power-bi.md#embed-for-your-customers) provides the ability to embed dashboards and reports to users who don't have an account for Power BI. When you [register your app](./register-app.md), run the *Embed for your customers* solution.
* [Embedding for your organization](embedded-analytics-power-bi.md#embed-for-your-organization) allows you to extend the Power BI service. When you [register your app](./register-app.md), run the *Embed for your organization* solution.
- question: |
How can I edit my registered application?
answer: |
To learn how to edit Microsoft Entra registered applications, see [Quickstart: Update an application in Microsoft Entra ID](/azure/active-directory/develop/quickstart-v1-update-azure-ad-app).
- question: |
How can I edit my Power BI user profile or data?
answer: |
You can learn how to edit your Power BI data [here](../../fundamentals/service-basic-concepts.md).
For more information, see [Troubleshooting your embedded application](embedded-troubleshoot.md).
More questions? [Try the Power BI Community](https://community.powerbi.com/)
Loading

0 comments on commit ebf2138

Please sign in to comment.