Merge pull request #4616 from MicrosoftDocs/12298

tapanm-MSFT · web-flow · commit 247c126427bf · 2021-06-21T20:27:07.000-07:00
Portals copy edit - Power BI - 12298
diff --git a/powerapps-docs/maker/portals/add-powerbi.md b/powerapps-docs/maker/portals/add-powerbi.md
@@ -1,6 +1,6 @@
 ---
 title: Add Power BI
-description: Learn about how to add Power BI component to a Power Apps portals page using portals Studio.
+description: Learn how to add a Power BI component to a Power Apps portals webpage. Get familiar with considerations about Power BI access types.
 author: neerajnandwana-msft
 ms.service: powerapps
 ms.topic: conceptual
@@ -15,112 +15,112 @@ contributors:
 
 # Add Power BI
 
-You can add Power BI component on a page to display Power BI dashboards and reports on your portal.
+You can add a Power BI component on a page to display Power BI dashboards and reports on your portal.
 
 > [!NOTE]
 > Before you begin, read [Power BI access type considerations](#power-bi-access-type-considerations) and [general Power BI considerations](#general-power-bi-considerations) to get familiar with important Power BI terms and considerations for Power Apps portals.
 
-To add a Power BI component to a web page:
+To add a Power BI component to a webpage:
 
 1. [Edit the
     portal](../portals/manage-existing-portals.md#edit).
 
-1. Select the page to add a component to.
+1. Select the page you want to add the component to.
 
 1. Select an editable element on the canvas.
 
 1. Select **Components** from the left side of the screen.
 
-1. From Portal components section, select **Power BI**. The Power BI placeholder is added to the canvas:
+1. From the Portal components section, select **Power BI**. The Power BI placeholder is added to the canvas.
 
 1. In the properties pane on the right side of the screen, enter the following information:
 
-    1. **Access type**: Select appropriate option from the drop-down as per your requirement.
+    1. **Access type**: From the drop-down, select the appropriate option for your business requirements.
 
         ![Power BI Access type](media/powerbi-access-type.png "Power BI Access type")
 
-        1. **Embed for your customers** - Allows you to securely share the Power BI dashboards or reports to external users without Power BI license or Azure Active Directory authentication setup. This option uses Power BI Embedded services to integrate Power BI dashboards or reports into portal.
+        1. **Embed for your customers** - Allows you to securely share the Power BI dashboards or reports to external users without a Power BI license or Azure Active Directory authentication setup. This option uses Power BI Embedded services to integrate Power BI dashboards or reports into your portal.
             > [!NOTE]
-            > Ensure [Power BI Embedded service is enabled](../portals/admin/set-up-power-bi-integration.md#enable-power-bi-embedded-service) and respective Power BI workspaces are selected, and shared with the maker or the logged-in user.
+            > Ensure [Power BI Embedded service is enabled](../portals/admin/set-up-power-bi-integration.md#enable-power-bi-embedded-service) and respective Power BI workspaces are selected and shared with the maker or the logged-in user.
 
-        1. **Embed for your organization** - Allows you to securely share the Power BI dashboards or reports to Azure Active Directory authenticated users.
+        1. **Embed for your organization** - Allows you to securely share the Power BI dashboards or reports with Azure Active Directory authenticated users.
 
             > [!NOTE]
-            > Ensure you've shared Power BI workspaces with maker and target portal users.
+            > Ensure you've shared Power BI workspaces with the maker and target portal users.
 
-        3. **Publish to web** - Allows you to share Power BI report or dashboard to anyone on the internet.
+        3. **Publish to web** - Allows you to share Power BI dashboards or reports to anyone on the internet.
 
-        For more information about access types, go to [access types](#power-bi-access-type-considerations).
+        For more information about access types, go to [Power BI access type considerations](#power-bi-access-type-considerations).
 
     1. **Workspace**: Select the Power BI workspace from the list.
 
     1. **Select type**: Select type as *Dashboard* or *Report* from the list.
 
         ![Select type](media/type-powerbi.png "Select type")
 
-        - **Dashboard** - Allows you to choose a **Dashboard**, and then a **Tile** from the selected dashboard to display on the web page.
-        - **Report** - Allows you to select a **Report**, and then a **Page** from the report to display on the web page.
+        - **Dashboard** - Allows you to choose a **Dashboard**, and then a **Tile** from the selected dashboard to display on the webpage.
+        - **Report** - Allows you to select a **Report**, and then a **Page** from the report to display on the webpage.
 
-    1. **Apply roles**: If you have defined roles in Power BI and assigned them to reports, you must enter appropriate roles in this field.
+    1. **Apply roles**: If you have defined roles in Power BI and assigned them to reports, you must enter the appropriate roles in this field.
 
         ![Apply roles](media/apply-roles-powerbi.png "Apply roles")
     
         - You can enter multiple roles separated by a comma (for example, `role_1,role_2`). For more information on defining roles in Power BI, go to [Row-level security (RLS) with Power BI](/power-bi/service-admin-rls). <br>
-        - Only available for access type **Embed for your customer**.
+        - This option is only available for the access type **Embed for your customers**.
 
-    1. **Apply filter**: Allows user to load the report with pre-filtered values. User can provide filter condition in the field. 
+    1. **Apply filter**: Allows the user to load the report with pre-filtered values. The user can provide a filter condition in the field. 
         
         ![Apply filter](media/apply-filter-powerbi.png "Apply filter")
 
-        - Filter parameter must be without `?filter=''` prefix. For example, `Table/Field eq 'value'`.
+        - The filter parameter must be without the `?filter=''` prefix. For example, `Table/Field eq 'value'`.
         <br> For more information, go to [filter parameter details](/power-bi/service-url-filters).
-        - Only available for **Reports** with access types **Embed for your customer** and **Embed for your organization**.
+        - This option is only available for **Reports** with access types **Embed for your customers** and **Embed for your organization**.
 
-    1. **Embed code URL**: Enter embed code URL.
+    1. **Embed code URL**: Enter the embed code URL.
     
         ![Embed Code URL](media/embed-code-url.png "Embed Code URL")
 
-        - To learn about how to get embed code URL, go to [Publish to web from Power BI](/power-bi/service-publish-to-web)
-        - Only available for access type **Publish to web**.
+        - To learn how to create and manage embed codes, go to [Publish to web from Power BI](/power-bi/service-publish-to-web)
+        - This option is only available for the access type **Publish to web**.
 
 ### Power BI access type considerations
 
-The following list explains Power BI access types in brief and lists access type considerations for Power Apps portals. For more information about Power BI access types, go to [Difference between Power BI service and Power BI embedded](/power-bi/developer/embedded/embedded-faq#how-is-power-bi-embedded-different-from-power-bi-the-service).
+The following list explains Power BI access types in brief and lists access type considerations for Power Apps portals. For more information about Power BI access types, go to [The difference between Power BI service and Power BI Embedded](/power-bi/developer/embedded/embedded-faq#how-is-power-bi-embedded-different-from-power-bi-the-service).
 
 - **Embed for your customers**:
-    - Shows the list of workspaces shared to user currently logged in and enabled for [Power BI Embedded service](../portals/admin/set-up-power-bi-integration.md#enable-power-bi-embedded-service).
+    - Shows the list of workspaces shared to a user currently logged in and enabled for [Power BI Embedded service](../portals/admin/set-up-power-bi-integration.md#enable-power-bi-embedded-service).
     - Uses Power BI Embedded service.
     - If you've used Power BI Embedded service with Power Apps portals before, you'll see the following error when you select **Embed for your customers**:
 
         ![Power BI Embed for your customers - enable visualization again](media/embed-power-bi-visualization-enable-again.png)
     
-        When this happens, ensure you [disable](../portals/admin/set-up-power-bi-integration.md#disable-power-bi-visualization) and then [enable](../portals/admin/set-up-power-bi-integration.md#enable-power-bi-visualization) Power BI visualization again.
-    - If you add Power BI with **Embed for your customers** on a Power Apps portal page that is available **anonymously**, anyone can view the dashboard. To secure such a web page, read [web page access control in Power Apps portal](../portals/configure/webpage-access-control.md).
+        When this message appears, ensure you [disable](../portals/admin/set-up-power-bi-integration.md#disable-power-bi-visualization) and then [enable](../portals/admin/set-up-power-bi-integration.md#enable-power-bi-visualization) Power BI visualization again.
+    - If you add Power BI with **Embed for your customers** on a portal page that's available **anonymously**, anyone can view the dashboard. To secure this page, read [webpage access control in Power Apps portals](../portals/configure/webpage-access-control.md).
 
 - **Embed for your organization**:
 
-    - Shows the list of workspaces shared with logged in user.
+    - Shows the list of workspaces shared with a logged-in user.
     - Uses Azure Active Directory authentication.
 
-- **Publish to web**: Anyone on Internet can view your published report or visual. This requires no authentication and includes viewing detail level data your reports aggregate. Before publishing a report, make sure you can share the data and visualizations publicly. Don't publish confidential or sensitive information. Refer to your organization's policies before publishing.
+- **Publish to web**: Anyone on the internet can view your published report or visual. This option requires no authentication and includes viewing detail-level data that your reports aggregate. Before publishing a report, make sure you can share the data and visualizations publicly. Don't publish confidential or sensitive information. Refer to your organization's policies before publishing.
 
 ### General Power BI considerations
 
-- [Portals Studio](../portals/portal-designer-anatomy.md) performance can degrade while working with Power BI workspaces because of the following Power BI workspace configurations:
-    - High number of workspaces shared with logged in maker user.
+- [Portals Studio](../portals/portal-designer-anatomy.md) performance can degrade while working with Power BI workspaces because of the following:
+    - A high number of workspaces shared with a logged-in user.
     - Power BI workspaces are shared with many users.
-- [Capture liquid variable](../portals/liquid/portals-entity-tags.md#powerbi) isn't supported in portals Studio while working with Power BI component.
-- If you [reset portal](../portals/admin/reset-portal.md) and provision a new portal, you must add portal application ID of the new portal to the **Portal Power BI Embedded service** Azure AD security group. For more information, go to [Set up Power BI integration](../portals/admin/set-up-power-bi-integration.md#create-security-group-and-add-to-power-bi-account).
-- If you make a change in Power Apps portals admin center, you must reload the portals Studio if you already have it open.
+- [The capture Liquid variable](../portals/liquid/portals-entity-tags.md#powerbi) isn't supported in portals Studio while working with a Power BI component.
+- If you [reset a portal](../portals/admin/reset-portal.md) and provision a new portal, you must add the portal application ID of the new portal to the **Portal Power BI Embedded service** Azure AD security group. For more information, go to [Set up Power BI integration](../portals/admin/set-up-power-bi-integration.md#create-security-group-and-add-to-power-bi-account).
+- If you make a change in the Power Apps portals admin center, you must reload the portals Studio if you already have it open.
 - Adding users to Power BI dashboards and reports may take a while to reflect in the portals Studio.
 
 ### Power BI performance and optimization considerations
 
-Embedding multiple Power BI workspaces may need additional considerations. Refer to the following resources for Power BI embed scenario troubleshooting, optimization, and best practices:
+Embedding multiple Power BI workspaces may need extra considerations. Refer to the following resources for Power BI Embedded troubleshooting, optimization, and best practices:
 
-- [Troubleshooting Power BI Embedded application content rendering](/power-bi/developer/embedded/embedded-troubleshoot#content-rendering).
-- [Power BI Embedded performance best practices](/power-bi/developer/embedded/embedded-performance-best-practices).
-- [Power BI optimization guide](/power-bi/guidance/power-bi-optimization).
+- [Troubleshooting Power BI Embedded application content rendering](/power-bi/developer/embedded/embedded-troubleshoot#content-rendering)
+- [Power BI Embedded performance best practices](/power-bi/developer/embedded/embedded-performance-best-practices)
+- [Power BI optimization guide](/power-bi/guidance/power-bi-optimization)
 
 ### See also
 
@@ -131,4 +131,4 @@ Embedding multiple Power BI workspaces may need additional considerations. Refer
 [WYSIWYG editor](compose-page.md)
 
 
-[!INCLUDE[footer-include](../../includes/footer-banner.md)]
+[!INCLUDE[footer-include](../../includes/footer-banner.md)]
diff --git a/powerapps-docs/maker/portals/admin/add-powerbi-report.md b/powerapps-docs/maker/portals/admin/add-powerbi-report.md
@@ -1,6 +1,6 @@
 ---
-title: Add a Power BI report or dashboard to a web page in portal
-description: Learn how to add a Power BI report or dashboard to a web page in the portal.
+title: Add a Power BI report or dashboard to a webpage in a portal
+description: Learn how to add a Power BI report or dashboard to a webpage in the portal by using the powerbi Liquid tag.
 author: neerajnandwana-msft
 ms.service: powerapps
 ms.topic: conceptual
@@ -13,14 +13,14 @@ contributors:
     - tapanm-msft
 ---
 
-# Add a Power BI report or dashboard to a web page in portal
+# Add a Power BI report or dashboard to a webpage in a portal
 
 > [!TIP]
 > This article explains how to add a Power BI report or dashboard using *powerbi* Liquid tag. To add **Power BI component** on a webpage in your portal using the portals Studio, go to [Add a Power BI component to a webpage using the portals Studio](../add-powerbi.md).
 
 You can add a Power BI report or dashboard to a web page in portal by using the [powerbi](../liquid/portals-entity-tags.md#powerbi) Liquid tag. Use the `powerbi` tag in the **Copy** field on a web page or in the **Source** field on a web template.
 
-If adding a Power BI report or dashboard created in the new workspace in Power BI, you must specify the authentication type as **powerbiembedded** in the *powerbi* Liquid tag.
+If you're adding a Power BI report or dashboard created in the new workspace of Power BI, you must specify the authentication type as **powerbiembedded** in the *powerbi* Liquid tag.
 
 > [!NOTE]
 > - If you have specified AAD as the authentication type in powerbi Liquid tag, you must share it with the required users before adding the secure Power BI report or dashboard to a web page in portal. More information: [Share Power BI workspace](/power-bi/service-how-to-collaborate-distribute-dashboards-reports#collaborate-with-coworkers-in-an-app-workspace) and [Share Power BI dashboard and report](/power-bi/service-share-dashboards).
@@ -85,7 +85,7 @@ Roles are contained within the Azure Analysis Services database and not in the r
 
 2.	Open the dashboard or report you want to embed in your portal.
 
-3.	Copy URL from the address bar.
+3.	Copy the URL from the address bar.
 
     > [!div class=mx-imgBorder]
     > ![Get the path of a Power BI dashboard](../media/powerbi-dashboard-url.png "Get the path of a Power BI dashboard")
@@ -108,12 +108,12 @@ Roles are contained within the Azure Analysis Services database and not in the r
 
 ## How to use powerbi-client JavaScript library in portals
 
-You can use [powerbi-client JavaScript library](https://github.com/microsoft/PowerBI-JavaScript#powerbi-client) while embedding Power BI reports or dashboards in portals. For more information about powerbi-client JavaScript library, see [Power BI JavaScript wiki](https://github.com/Microsoft/PowerBI-JavaScript/wiki).
+You can use [powerbi-client JavaScript library](https://github.com/microsoft/PowerBI-JavaScript#powerbi-client) while embedding Power BI reports or dashboards in your portal. For more information about powerbi-client JavaScript library, see the [Power BI JavaScript wiki](https://github.com/Microsoft/PowerBI-JavaScript/wiki).
 
-Below is a sample JavaScript to update the report settings, or to handle events. This sample disables filters pane, disables page navigation, and enables *dataSelected* event.
+Below is a sample JavaScript to update the report settings or to handle events. This sample disables filter pane, disables page navigation, and enables *dataSelected* event.
 
 > [!IMPORTANT]
-> Use powerbi-client JavaScript library to disable or enable filter pane. However, if you want to restrict access to data or configure security, use [Row-level security (RLS) with Power BI](/power-bi/admin/service-admin-rls). Disabling filter pane doesn't restrict data access, and can be re-enabled using JavaScript library code.
+> Use powerbi-client JavaScript library to disable or enable filter pane. However, if you want to restrict access to data or configure security, use [Row-level security (RLS) with Power BI](/power-bi/admin/service-admin-rls). Disabling filter pane doesn't restrict data access, and it can be re-enabled using JavaScript library code.
 
 ```javascript
 $(window).load(function(){
@@ -140,16 +140,16 @@ $(window).load(function(){
 })
 ```
 
-To add custom JavaScript to a web page:
+To add custom JavaScript to a webpage:
 
 1. Open the [Portal Management](../configure/configure-portal.md) app.
-1. Select **Web Pages** from the left-pane.
-1. Select the web page that contains the Power BI report or dashboard.
+1. Select **Web Pages** from the left pane.
+1. Select the webpage that contains the Power BI report or dashboard.
 1. Select **Advanced** tab.
 1. Copy and paste the JavaScript inside the **Custom JavaScript** section.
 1. Select **Save & Close**.
 
-Let's understand the sample JavaScript operations, and different options.
+Now, let's understand the sample JavaScript operations and different options.
 
 ### Get a reference to the embedded report HTML
 
@@ -169,9 +169,9 @@ var report = powerbi.get(embedContainer);
 
 ### Work with Power BI panes
 
-You can use the settings for panes to work with Power BI panes on a portals web page. For example, you can use the filters setting to hide or show the pane. Or, use the paging with page navigation setting.
+You can use the settings for panes to work with Power BI panes on a portals webpage. For example, you can use the filters setting to hide or show the pane, or work with the page navigation setting.
 
-Below is the sample to remove filters pane:
+Below is a sample to remove filters pane:
 
 ```javascript
 report.updateSettings({
@@ -185,7 +185,7 @@ report.updateSettings({
         });
 ```
 
-Sample to work with both page navigation, and filters:
+Below is a sample to work with both page navigation and filters:
 
 ```javascript
 report.updateSettings({
@@ -227,4 +227,4 @@ More information: [Handling events](https://github.com/Microsoft/PowerBI-JavaScr
 - [powerbi Liquid tag](../liquid/portals-entity-tags.md#powerbi)
 
 
-[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
+[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
diff --git a/powerapps-docs/maker/portals/admin/set-up-power-bi-integration.md b/powerapps-docs/maker/portals/admin/set-up-power-bi-integration.md
