Merge pull request #12992 from MicrosoftDocs/main

2/17/2025 PM Publish

Author: Albertyang0

powerbi-docs/connect-data/service-r-packages-support.md

@@ -2181,7 +2181,7 @@ The following table shows which packages aren't supported in the Power BI servic
 
 - R visuals aren't supported with Service Principal Profiles for App Owns Data.
 - The R visuals rendered from the Power BI service (for Premium/ F SKUs) will support payloads of < 30Mb.
-- R visuals with HTML and XML packages fail to render due to Out Of Memory (OOM). Migrate the visual with the [PbiViz tool] (../developer/visuals/develop-power-bi-visuals#power-bi-visual-packages). The visual must render. 
+- R visuals with HTML and XML packages fail to render due to Out Of Memory (OOM). Migrate the visual with the [PbiViz tool](../developer/visuals/develop-power-bi-visuals.md#power-bi-visual-packages).The visual must render. 
 
 
 

powerbi-docs/consumer/mobile/mobile-iphone-app-get-started.md

@@ -7,7 +7,7 @@ ms.reviewer: ''
 ms.service: powerbi
 ms.subservice: powerbi-mobile
 ms.topic: how-to
-ms.date: 03/31/2024
+ms.date: 02/17/2025
 ms.custom: intro-get-started
 ---
 # Get started with the Power BI mobile app on iOS devices
@@ -27,7 +27,7 @@ Find out [what's new in the Power BI mobile apps](mobile-whats-new-in-the-mobile
 ## Download the app
 [Download the iOS app](https://go.microsoft.com/fwlink/?LinkId=522062 "Download the iOS app")  from the Apple App Store to your iPhone or iPad.
 
-You can run the Power BI mobile app for iOS on any device running iOS/iPadOS 16.4 or later.
+You can run the Power BI mobile app for iOS on any device running iOS/iPadOS 17 or later.
 
 ## Sign up for the Power BI service
 If you haven't already signed up, go to [powerbi.com](https://powerbi.microsoft.com/get-started/), and select **Try Power BI for free**.

powerbi-docs/create-reports/desktop-excel-stunning-report.md

@@ -9,7 +9,7 @@ tags: ''
 ms.service: powerbi
 ms.subservice: powerbi-developer
 ms.topic: reference
-ms.date: 11/09/2023
+ms.date: 11/09/2024
 ---
 
 # Semantic model REST API permissions
@@ -28,7 +28,7 @@ Power BI has two sets of permissions:
 
 Workspace permissions, also known as folder permissions or [roles](../../collaborate-share/service-roles-new-workspaces.md), are the highest level of permissions in Power BI. These permissions override permissions that are given to a specific item in the workspace folder.
 
-The table below lists the four types of folder roles. It shows each role's level, and the code string returned by the Power BI REST APIs. Admin is the highest workspace permission level, and viewer is the lowest. Every permission level includes the capabilities of the permissions below it. You can review the capabilities of each permission in [Workspace roles](../../collaborate-share/service-roles-new-workspaces.md#workspace-roles).
+The following table lists the four types of folder roles. It shows each role's level, and the code string returned by the Power BI REST APIs. Admin is the highest workspace permission level, and viewer is the lowest. Every permission level includes the capabilities of the permissions below it. You can review the capabilities of each permission in [Workspace roles](../../collaborate-share/service-roles-new-workspaces.md#workspace-roles).
 
 |Folder Role |Level |Derived permissions for semantic models created in the workspace |
 |------------|------|--------------------------|
@@ -38,7 +38,7 @@ The table below lists the four types of folder roles. It shows each role's level
 |Viewer      |1     |`Read`                    |
 
 >[!NOTE]
->The *write* permission is applied to Power BI semantic models created by *admin*, *member* and *contributor* users in a workspace they own. The write permission can be granted or deleted using workspace permissions only. It cannot directly be granted to, or deleted from, a Power BI item.
+>The *write* permission is applied to Power BI semantic models created by *admin*, *member*, and *contributor* users in a workspace they own. The write permission can be granted or deleted using workspace permissions only. It can't directly be granted to, or deleted from, a Power BI item.
 
 #### Get and add workspace permissions with APIs
 
@@ -56,14 +56,14 @@ Power BI items, such as reports, semantic models, and dashboards have their own
 
 ## Semantic model permissions and REST APIs
 
-Semantic model permissions are part of the [item permissions](#item-permissions). The table below lists the Power BI semantic model permissions and their representation in the [Power BI REST APIs](/rest/api/power-bi/).
+Semantic model permissions are part of the [item permissions](#item-permissions). The following table lists the Power BI semantic model permissions and their representation in the [Power BI REST APIs](/rest/api/power-bi/).
 
 >[!TIP]
 >Although the API permissions are identical to the Power BI service permissions, [`build`](#build-permissions-and-rest-apis) permissions are referred to as *explore* permissions in the APIs.
 
 |Permission             |Read     |Explore  |Reshare  |
 |-----------------------|---------|---------|---------|
-|Description            |Allows the user to read the content of the semantic model|Equivalent to [build permissions](#build-permissions-and-rest-apis) |Allows the user to share the content of the semantic model with other users who will get read, reshare, or explore permissions for it |
+|Description            |Allows the user to read the content of the semantic model|Equivalent to [build permissions](#build-permissions-and-rest-apis) |Allows the user to share the content of the semantic model with other users who get read, reshare, or explore permissions for it |
 |**ReadReshareExplore** | :::image type="icon" source="../../includes/media/yes-icon.svg" border="false":::     |:::image type="icon" source="../../includes/media/yes-icon.svg" border="false":::       |:::image type="icon" source="../../includes/media/yes-icon.svg" border="false":::        |
 |**ReadReshare**        |:::image type="icon" source="../../includes/media/yes-icon.svg" border="false":::        |:::image type="icon" source="../../includes/media/no-icon.svg" border="false":::      |:::image type="icon" source="../../includes/media/yes-icon.svg" border="false":::        |
 |**ReadExplore**        |:::image type="icon" source="../../includes/media/yes-icon.svg" border="false":::        |:::image type="icon" source="../../includes/media/yes-icon.svg" border="false":::       |:::image type="icon" source="../../includes/media/no-icon.svg" border="false":::       |
@@ -74,7 +74,7 @@ Semantic model permissions are part of the [item permissions](#item-permissions)
 
 ### Build permissions and REST APIs
 
-In the [Power BI REST APIs](/rest/api/power-bi/), the `build` permission is returned as *explore*. For example, a string with the *read*, *reshare* and *build* permissions, will look like this: `ReadReshareExplore`.
+In the [Power BI REST APIs](/rest/api/power-bi/), the `build` permission is returned as *explore*. For example, a string with the *read*, *reshare* and *build* permissions, looks like this: `ReadReshareExplore`.
 
 When you give a user `build` permission, they can build new content on your semantic model. Examples of content they can build are reports, dashboards, pinned tiles from Q&A, paginated reports, and Insights Discovery.
 
@@ -88,7 +88,7 @@ Users also need `build` permissions to work with data outside Power BI:
 
 ### Row-level security
 
-For a semantic model that uses row-level security (RLS), any permissions *higher* than `build` will enable the user to view all the data in the semantic model. `Build`, and permissions lower than `build`, will only give the semantic model user access to the data they're allowed to see as configured in your RLS settings.
+For a semantic model that uses row-level security (RLS), any permissions *higher* than `build` enables the user to view all the data in the semantic model. `Build`, and permissions lower than `build`, only give the semantic model user access to the data they're allowed to see as configured in your RLS settings.
 
 ### Get and update semantic model permissions with APIs
 
@@ -107,9 +107,7 @@ For a semantic model that uses row-level security (RLS), any permissions *higher
   * [Datasets - Get Dataset Users](/rest/api/power-bi/datasets/get-dataset-users)
   * [Datasets - Get Dataset Users In Group](/rest/api/power-bi/datasets/get-dataset-users-in-group)
 
-## Considerations and limitations
-
-Each of the above APIs comes with certain limitations regarding who can use them and how. To see the limitations of each API, select the link for that API.
+Each of these APIs comes with certain limitations regarding who can use them and how. To see the limitations of each API, select the link for that API.
 
 ## Related content
 

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-column-chart-date.png

@@ -7,7 +7,8 @@ ms.reviewer: sabre
 ms.service: powerbi
 ms.subservice: powerbi-developer
 ms.topic: how-to
-ms.date: 11/08/2023
+ms.date: 01/12/2025
+#customer intent: As an ISV, I want to embed a Power BI report that uses data stored in Azure Analysis Services (AAS) in an embed for your customers scenario, so that I can provide my customers with a report that uses data from an AAS database.
 ---
 
 # Embed a report with an Azure Analysis Services (AAS) database
@@ -18,7 +19,7 @@ This article explains how to embed a Power BI report that uses data stored in [A
 
 ## Prerequisites
 
-You'll need a report with a live connection to AAS database, with or without RLS.
+You need a report with a live connection to AAS database, with or without RLS.
 
 ## Dynamic security - RLS
 
@@ -52,10 +53,10 @@ Use the [**service principal object ID**](embedded-troubleshoot.md#whats-the-dif
 
 ## Analysis Service migration
 
-You can [migrate from AAS to Power BI Premium](../../guidance/migrate-azure-analysis-services-to-powerbi-premium-migration-scenarios.md) even if you have an embedded AAS report. Your embedded report won't break during the migration, as long as the principal that's calling the [Embed Token - Generate Token](/rest/api/power-bi/embed-token/generate-token) API, is a member or admin of the workspace.
+You can [migrate from AAS to Power BI Premium](../../guidance/migrate-azure-analysis-services-to-powerbi-premium-migration-scenarios.md) even if you have an embedded AAS report. Your embedded report doesn't break during the migration, as long as the principal that's calling the [Embed Token - Generate Token](/rest/api/power-bi/embed-token/generate-token) API, is a member or admin of the workspace.
 
 >[!NOTE]
-> If the service principal is not an admin, and you don't want to make it an admin of the workspace when you migrate, migrate that model into a separate workspace where you can give it admin permissions.
+> If the service principal isn't an admin, and you don't want to make it an admin of the workspace when you migrate, migrate that model into a separate workspace where you can give it admin permissions.
 
 ## Generate an embed token
 
@@ -68,15 +69,15 @@ The information needed to generate an embed token depends on how you're connecte
 To generate an embed token, provide the following information:
 
 * **Username** (Optional if no RLS. Required for RLS) - The username must be the same as API caller (in this case, the Master user's [UPN](./pbi-glossary.md#user-principal-name-upn)). If the database doesn't use RLS, and no username is provided, the master user's credentials are used.
-* **Role** (required for RLS) - The report will only display data if the effective identity is a member of the role.
+* **Role** (required for RLS) - The report only displays data if the effective identity is a member of the role.
 
 Example:  
 
 Define the user identity and roles for one of the following three scenarios:
 
 * If RLS isn't implemented:
 
-There is no need to define any effective identity.
+You don't need to define any effective identity.
 
 * If using static RLS:
 
@@ -100,7 +101,7 @@ There is no need to define any effective identity.
   ```
 
     >[!NOTE]
-    >`customData` in the embed token cannot be larger than 1,024 characters.
+    >`customData` in the embed token can't be larger than 1,024 characters.
 
 Use the effective identity to generate an embed token:
 
@@ -175,7 +176,7 @@ public EmbedToken GetEmbedToken(Guid reportId, IList<Guid> datasetIds, [Optional
 
 ---
 
-Use the embed token to embed the report into your app or website. Your report will filter data according to the applied RLS in the report.
+Use the embed token to embed the report into your app or website. Your report filters data according to the applied RLS in the report.
 
 ## Related content
 

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-column-month.png

@@ -45,17 +45,6 @@ PBIR is currently in preview. You can only create or convert existing Power BI p
 
 During preview, Fabric Git Integration and Fabric REST APIs continue to use PBIR-legacy (report.json) when exporting the report definitions. However, if the report is imported into Fabric using PBIR format, then both features start exporting the report definition using PBIR format. At general availability (GA), PBIR will become the default report format.
 
-## Limitations 
-
-Initially, the PBIR format has some service restrictions, such as these:
-
-- You can't use subscriptions.
-- Mobile views are not displayed in Power BI Apps.
-- Can't be deployed with deployment pipelines.  
-- Large reports with more than 500 files experience authoring performance issues (report viewing isn't affected), including:
-  - Saving in Power BI Desktop
-  - Synchronization in Fabric Git Integration
-
 Refer to [PBIR documentation](/power-bi/developer/projects/projects-report#pbir-format) for more details.
 
 ## Next steps

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-column-year.png

@@ -7,7 +7,7 @@ ms.reviewer:
 ms.service: powerbi
 ms.subservice: powerbi-developer
 ms.topic: how-to
-ms.date: 11/09/2023
+ms.date: 11/09/2024
 # customer intent: As an ISV, I want to learn how to embed Power BI content with token-based, single sign-on (SSO) identities so I can provide secure access to my customers' data.
 ---
 
@@ -75,40 +75,6 @@ See the following examples for generating embed tokens for different scenarios.
 
 #### [Power BI report with SSO](#tab/Power-BI-report-with-SSO)
 
-<!--
-
-```json
-{
-  "datasets": [
-    {
-      "id": "66ba5010-xxxx-xxxx-xxxx-f2bf0125abeb",
-      "xmlaPermissions": "ReadOnly"
-    }
-  ],
-  "reports": [
-    {
-      "allowEdit": false,
-      "id": "9e6da541-xxxx-xxxx-xxxx-7d9442827cce"
-    }
-  ],
-  "datasourceIdentities": [
-    {
-      "identityBlob": "eyJ…",
-      "datasources": [
-        {
-          "datasourceType": "Sql",
-          "connectionDetails": {
-            "server": "YourServerName.database.windows.net",
-            "database": "YourDataBaseName"
-          }
-        }
-      ]
-    }
-  ]
-}
-```
--->
-
 ```json
 {
   "datasets": [

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-date-hierarchy-trim.png

@@ -7,7 +7,7 @@ ms.reviewer: tebercov
 ms.service: powerbi
 ms.subservice: powerbi-custom-visuals
 ms.topic: concept-article
-ms.date: 12/12/2023
+ms.date: 12/12/2024
 #customer intent: As a Power BI visual developer, I want to understand how data view mapping works in Power BI visuals so that I can create different types of visuals.
 ---
 

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-date-hierarchy.png

@@ -7,7 +7,7 @@ ms.reviewer: tebercov
 ms.service: powerbi
 ms.subservice: powerbi-custom-visuals
 ms.topic: how-to
-ms.date: 11/18/2023
+ms.date: 11/18/2024
 #customer intent: As a Power BI visual developer, I want to learn how to fetch more data from Power BI so that I can display large semantic models in my visual.
 ---
 
@@ -178,7 +178,7 @@ btn_click(){
 As a response to calling the `this.host.fetchMoreData` method, Power BI calls the `update` method of the visual with a new segment of data.
 
 > [!NOTE]
-> Although the data in the different updates of the data views are mostly exclusive, there is some overlap between consecutive data views.
+> Although the data in the different updates of the data views are mostly exclusive, there's some overlap between consecutive data views.
 >
 > For table and categorical data mapping, the first `N` data view rows can be expected to contain data copied from the previous data view.
 >

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-date-numeric-range.png

@@ -7,7 +7,7 @@ ms.reviewer: ''
 ms.service: powerbi
 ms.subservice: powerbi-custom-visuals
 ms.topic: how-to
-ms.date: 12/12/2023
+ms.date: 01/12/2025
 #customer intent: As a custom Power BI visual developer, I want to learn how to customize the new Format pane in Power BI custom visuals using the new formatting model so that I can create visuals that are easier for report creators to use.
 ---
 

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-desktop-canvas-sample-dataset.png

@@ -7,7 +7,7 @@ ms.reviewer: ""
 ms.service: powerbi
 ms.subservice: powerbi-custom-visuals
 ms.topic: how-to
-ms.date: 12/2/2023
+ms.date: 01/12/2025
 #customer intent: As a Power BI user, I want to learn how to import a custom visual from AppSource or from a file so that I can use it in my Power BI reports.
 ---
 

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-fields-list-sigmas-date.png

@@ -7,7 +7,7 @@ ms.reviewer:
 ms.service: powerbi
 ms.subservice: powerbi-custom-visuals
 ms.topic: reference
-ms.date: 06/28/2022
+ms.date: 06/28/2024
 ---
 
 # Check permissions API

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-financial-navigator.png

@@ -76,9 +76,6 @@ Make sure that the following commands don't return any errors.
 * `npm audit` - Must not return any warnings with high or moderate level.
 * `ESlint` with the [required configuration](https://www.npmjs.com/package/eslint-plugin-powerbi-visuals). This command must not return any lint errors.
 
-  >[!NOTE]
-  > We're in the process of migrating from TSlint to ESLint. Visuals using TSlint will be accepted for certification until March 2023. After that, ESlint will be required.
-
 ### Compiling requirements
 
 Use the latest version of [powerbi-visuals-tools](https://www.npmjs.com/package/powerbi-visuals-tools) to write the Power BI visual.

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-line-month.png

@@ -7,10 +7,11 @@ ms.reviewer: ""
 ms.service: powerbi
 ms.subservice: powerbi-custom-visuals
 ms.topic: troubleshooting
-ms.date: 12/21/2023
+ms.date: 12/21/2024
+# customer intent: As a Power BI developer, I want to learn how to troubleshoot common issues that might occur when setting up my developer environment for creating custom Power BI visuals so that I can develop my visuals effectively.
 ---
 
-# Troubleshoot your Power BI developer environment setup
+# Troubleshoot your Power BI developer environment setup for custom visuals
 
 This article explains how to diagnose and fix the following common problems that can occur when setting up your developer environment for creating custom Power BI visuals.
 

powerbi-docs/create-reports/media/desktop-excel-stunning-report/power-bi-map-visual.png

@@ -7,7 +7,7 @@ ms.reviewer: tebercov
 ms.service: powerbi
 ms.subservice: powerbi-custom-visuals
 ms.topic: how-to
-ms.date: 11/22/2023
+ms.date: 11/22/2024
 #customer intent: As a Power BI visual developer, I want to learn how to use the Total and Subtotal API to request aggregated subtotal data from the Power BI host.
 ---
 
@@ -31,7 +31,7 @@ The API offers the following customization for each data-view type (currently, o
 * `columnSubtotals`: (boolean) Indicates if the *subtotal* data should be requested for all fields in the columns field well.
 * `columnSubtotalsPerLevel`: (boolean) Indicates if the *subtotal* data can be toggled for individual fields in the columns field well.
 * `levelSubtotalEnabled`: (boolean) Indicates if the subtotals are requested for the row or column. Unlike all the other properties, this property is applied to individual rows or columns.
-* `rowSubtotalsType`: ("Top" or "Bottom") Indicates if the row with the *total* data should be retrieved before (`top`) or after (`bottom`) the rest of the data. If this property is set to `bottom`, the total can only be displayed after all the data has been fetched. The default is `bottom`.
+* `rowSubtotalsType`: ("Top" or "Bottom") Indicates if the row with the *total* data should be retrieved before (`top`) or after (`bottom`) the rest of the data. If this property is set to `bottom`, the total can only be displayed after all the data is fetched. The default is `bottom`.
 
 Each of these switches is assigned a value based on the related properties in the property pane and the defaults.