Merge branch 'main' into 2739608-2

Author: tapanm-MSFT

powerapps-docs/maker/canvas-apps/control-limitations.md

@@ -2,11 +2,10 @@
 title: Limitations of controls in canvas apps
 description: Learn about the limitations of controls in canvas apps.
 author: navjotm
-
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 01/31/2022
+ms.date: 06/01/2022
 ms.subservice: canvas-maker
 ms.author: namarwah
 search.audienceType: 
@@ -32,6 +31,8 @@ In this article, learn about the general limitations of the controls used in can
    - On Android, the camera control isn't supported in Teams Mobile.
    - When using desktop browsers, the barcode scanner isn't supported. Use the Power Apps for mobile app.
 
+- [Container control](controls/control-container.md) - see [Container control limitations](controls/control-container.md#limitations).
+
 - [Export and import controls](controls/control-export-import.md) - see [Export and import control limitations](controls/control-export-import.md#limitations).
 
 - [Gallery control](controls/control-gallery.md) - see [Gallery control limitations](controls/control-gallery.md#limitations).

powerapps-docs/maker/canvas-apps/controls/control-attachments.md

@@ -4,7 +4,7 @@ description: Learn about the details, properties and examples of the attachments
 author: chmoncay
 ms.topic: reference
 ms.custom: canvas
-ms.date: 05/05/2022
+ms.date: 06/01/2022
 ms.subservice: canvas-maker
 ms.author: chmoncay
 ms.reviewer: tapanm
@@ -21,6 +21,9 @@ contributors:
 
 A control that allows users to download files to their device, as well as upload and delete files from a list created using Microsoft Lists, or a Microsoft Dataverse table.
 
+## Description
+An **Attachments** control lets you open, add, and delete files from a list or a Dataverse table.
+
 ## Limitations
 
 The attachment control has these limitations:
@@ -31,9 +34,6 @@ The attachment control has these limitations:
 
 1. Attachments control on a web browser lets you select multiple files, and allows use of drag and drop functionality. However, when using attachments control on [Power Apps Mobile](https://powerapps.microsoft.com/downloads/), you can only add files one at a time.
 
-## Description
-An **Attachments** control lets you open, add, and delete files from a list or a Dataverse table.
-
 ## Key properties
 **[Items](properties-core.md)** – The **Attachment** column of the list or Dataverse table. [Collections](../create-update-collection.md) and [Tables](../working-with-tables.md) are not supported.
 

powerapps-docs/maker/canvas-apps/controls/control-container.md

@@ -2,10 +2,9 @@
 title: Container control in Power Apps
 description: Learn about the details, properties and examples of the container control in Power Apps.
 author: chmoncay
-
 ms.topic: reference
 ms.component: canvas
-ms.date: 02/12/2021
+ms.date: 06/01/2022
 ms.subservice: canvas-maker
 ms.author: chmoncay
 ms.reviewer: tapanm-msft
@@ -20,14 +19,22 @@ contributors:
 ---
 # Container control in Power Apps
 
-Provides the ability to create hierarchy.
+Groups logically-related controls to create hierarchies.
 
 ## Description
 
 The container can hold a set of controls and has its own properties.
 
 You can start with inserting a blank container. And then, customize it by adding controls to it, resizing it, moving it, hiding it, and making other changes. You can also start with a number of controls, select them and add using tree view.
 
+## Limitations
+
+- Containers don't work within forms.
+- The following controls are not supported within a container:
+    - [Data table](control-data-table.md)
+    - [PDF viewer](control-pdf-viewer.md)
+    - [Web barcode scanner](control-barcodescanner.md)
+
 ## Properties
 
 **[BorderColor](properties-color-border.md)** – The color of a control's border.
@@ -49,18 +56,15 @@ You can start with inserting a blank container. And then, customize it by adding
 **[Y](properties-size-___location.md)** – The distance between the top edge of a control and the top edge of the parent container (screen, if no parent container). 
 
 
-## Known limitations
-
-- Containers don't work within forms.
-- You cannot add tables to the layout containers.
-
 ## Frequently asked questions
 
 ### What is the difference between a container and a group?
 
-The authoring group is a lightweight concept used for moving around controls and bulk editing similar properties of controls within the group. The authoring group doesn't affect the layout of the app.
+When editing an app, you can select controls and group them using Ctrl + G or the context menu. You can modify common properties of controls within the group. Groups are an aid for app making. They don't have properties of their own and don't affect the layout of the app.
+
+In contrast, containers are actual controls with their own properties like **Width** and **BorderColor**. Containers affect app layout and help screen reader users understand the structure of the app.
 
-The container control previously shipped in experimental as a replacement for the authoring group renamed as the enhanced group. It was renamed to the container control as there's value in both a lightweight authoring group and a structured container control with additional properties.
+While you can add any controls in a group, you should only add logically-related controls in a container. For example, [controls in a tile should be placed in containers](../accessible-apps-structure.md#logical-control-order).
 
 
 [!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/maker/canvas-apps/controls/control-gallery.md

@@ -2,11 +2,10 @@
 title: Gallery control in Power Apps
 description: Learn about the details, properties and examples of the gallery control in Power Apps.
 author: chmoncay
-
 ms.topic: reference
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 03/11/2021
+ms.date: 06/01/2022
 ms.subservice: canvas-maker
 ms.author: chmoncay
 search.audienceType:
@@ -36,7 +35,16 @@ Predefined templates for showing images and text in a gallery are available, and
 
 ## Limitations
 
-If a user scrolls the **Flexible height** gallery control before all items are loaded, the item that's currently in view may be pushed down and out of view when the data loading is finished. To avoid this issue, use a standard **Gallery** control instead of the **Flexible height** variant.
+- If a user scrolls the **Flexible height** gallery control before all items are loaded, the item that's currently in view may be pushed down and out of view when the data loading is finished. To avoid this issue, use a standard **Gallery** control instead of the **Flexible height** variant.
+- The following controls are not supported within a gallery:
+    - [Display form](control-form-detail.md)
+    - [Edit form](control-form-detail.md)
+    - [PDF viewer](control-pdf-viewer.md)
+    - [Power BI tile](control-power-bi-tile.md)
+    - [Rich text editor](control-richtexteditor.md)
+    - [Scrollable screen (Fluid grid)](../add-scrolling-screen.md)
+    - [Web barcode scanner](control-barcodescanner.md)
+- You can only add one gallery inside another gallery.
 
 ## Key properties
 

powerapps-docs/maker/canvas-apps/controls/control-richtexteditor.md

@@ -5,7 +5,7 @@ author: chmoncay
 ms.topic: article
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 04/12/2022
+ms.date: 06/01/2022
 ms.subservice: canvas-maker
 ms.author: chmoncay
 search.audienceType: 
@@ -76,8 +76,5 @@ To use the control inside a form, select the "Edit multi-line text" card, and cu
 > [!NOTE]
 > When the toolbar is focused, **Tab** and **Shift+Tab** keys will navigate between toolbar groups. But you can't cycle back from the last group to the first group and vice versa.
 
-## Limitations
-
-Rich text editor can't be used within a gallery.
 
 [!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/maker/canvas-apps/share-app.md

@@ -2,11 +2,10 @@
 title: Share a canvas app with your organization
 description: Learn about how to share canvas apps by giving other users in your organization the permissions to run or modify it.
 author: alaug
-
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: tapanm
-ms.date: 01/27/2022
+ms.date: 04/20/2022
 ms.subservice: canvas-maker
 ms.author: alaug
 search.audienceType: 
@@ -16,6 +15,7 @@ search.app:
 contributors:
   - tapanm-msft
   - alaug
+  - msftsamperl
 ---
 # Share a canvas app with your organization
 
@@ -100,6 +100,7 @@ Before you share an app, you must [save it to the cloud](save-publish-app.md#sav
     - If a user selects the link on a desktop computer, the app opens in a browser.
 
     Co-owners who receive an invitation get another link that opens the app for editing in Power Apps Studio.
+
 <!--markdownlint-disable MD036-->
 **To change permissions for a user or a security group**
 

powerapps-docs/teams/embed-teams-app.md

@@ -1,14 +1,13 @@
 ---
 title: Embed an app in Teams  | Microsoft Docs
 description: You can embed an app created in Power Apps in Microsoft Teams to share it.
-author: matthewbolanos
-
+author: msftsamperl
 ms.topic: conceptual
 ms.custom: 
   - canvas
   - intro-internal
 ms.reviewer: tapanm
-ms.date: 07/14/2021
+ms.date: 04/20/2022
 ms.subservice: teams
 ms.author: mabolan
 search.audienceType: 
@@ -32,40 +31,56 @@ You can share an app you've created by embedding it directly into Microsoft Team
 - You need a valid [Power Apps license](/power-platform/admin/pricing-billing-skus).
 - To embed an app into Teams, you need an existing app [created using Power Apps](../maker/canvas-apps/data-platform-create-app.md).
 
-## Download the app
-
-1. Sign in to [Power Apps](https://make.powerapps.com), and then select **Apps** in the menu.
+## Add to Teams
 
-    ![Show list of apps.](media/embed-teams-app/file-apps2.png "Show list of apps")
+1. Sign in to [Power Apps](https://make.powerapps.com), and then select **Apps**.
 
 1. Select **More actions** (...) for the app you want to share in Teams, and then select **Add to Teams**.
 
-    ![Add to Teams.](media/embed-teams-app/add-to-teams.png "Add to Teams")
+    :::image type="content" source="media/embed-teams-app/add-to-teams-option.png" alt-text="Add to Teams.":::
 
     **Add to Teams** panel opens on the right-side of the screen.
 
-    ![Add to Teams panel.](media/embed-teams-app/download-app.png "Add to Teams panel")
+    :::image type="content" source="media/embed-teams-app/add-to-teams-review.png" alt-text="Add to Teams - review options.":::
 
 1. (Optional) If the app doesn't have any description, select **Edit details** to open the app in Power Apps Studio to add.
 
 1. (Optional) Select **Advanced settings** to add additional details such as *Name*, *Website*, *Terms of Use*, *Privacy Policy*, *MPN ID* (Microsoft Partner Network ID).
 
     ![Add additional details.](media/embed-teams-app/additional-settings-embed.png "Add additional details")
 
-1. Select **Download app**. Power Apps will then generate your Teams manifest file using the app description and logo you've already set in your app.
+1. Select **Add to Teams** and you'll be asked to open Teams.
 
-1. Save the downloaded file.
+    :::image type="content" source="media/embed-teams-app/add-to-teams-button.png" alt-text="Add to Teams button.":::
 
-## Add the app as a personal app
+    > [!TIP]
+    > If you want, you can also choose **Download app** to download the app, and then use the steps described in [Upload your app in Microsoft Teams](/microsoftteams/platform/concepts/deploy-and-publish/apps-upload) article to upload the app to Teams.
 
-1. To add the app as a personal app or as a tab to any channel or conversation, select **Apps** in the left navigation and then select **Upload a custom app**.
+1. Select **Open Microsoft Teams** to open Teams app, or select **Cancel** followed by **Use the web app instead** to open Teams web.
 
-    > [!NOTE]
-    > The **Upload a custom app** only appears if your Teams administrator has created a [custom app policy](/microsoftteams/teams-app-setup-policies) and turned on **Allow uploading of custom apps**.
+1. Select **Add**. You can also choose to add the app to a specific team using **Add to team**, or a specific chat using **Add to chat**.
+
+    :::image type="content" source="media/embed-teams-app/add-to-teams-in-teams.png" alt-text="Add app to Teams, a team, or a chat.":::
+
+    The app is now added to Teams.
+
+    > [!TIP]
+    > You can also [pin the app](install-personal-app.md#pin-power-apps-to-teams) for easy access.
+
+## Add to Teams using the web player
 
-    ![Add app as tab.](media/embed-teams-app/upload-custom-app.png "Upload a custom app")
+You can also add canvas apps to Teams using the web player. There are two ways to run a canvas app using the web player.
 
-2. Select **Add** to add the app as a personal app or select **Add to team** to add the app as a tab within an existing channel or conversation.
+1. Go to [Power Apps](https://make.powerapps.com) > **Apps** > select the app to launch in a new browser tab.
+1. [Edit the app](../maker/canvas-apps/edit-app.md) > select ![Play the app.](media/embed-teams-app/play.png) or press **F5** to play the app.
+
+After the app is open using the web player, choose the **Add to Teams** button from the top-right side of the screen.
+
+:::image type="content" source="media/embed-teams-app/add-to-teams-web-player.png" alt-text="Add app to Teams using web player.":::
+
+When prompted, select **Open Microsoft Teams** to open Teams app, or select **Cancel** followed by **Use the web app instead** to open Teams web. And then, select **Add** to add the app to Teams.
+
+You can also choose to add the app to a specific team using **Add to team**, or a specific chat using **Add to chat**.
 
 ## Publish the app to the Teams catalog
 
@@ -124,18 +139,18 @@ The following context variables from Teams are supported:
 
 You can optionally preload your app within Teams to increase performance.
 
-1. Sign in to [make.powerapps.com](https://make.powerapps.com), and then select **Apps** in the menu.
+1. Sign in to [Power Apps](https://make.powerapps.com), and then select **Apps** in the menu.
 
 2. Select **More actions** (...) for the app you want to share in Teams, and then select **Settings**.
 
 3. In the Settings panel, toggle **Preload app for enhanced performance** to **Yes**. App will then pre-load whenever embedded in Teams.
 
-    ![Preload app for enhanced performance.](media/embed-teams-app/preload-app.png "Preload app for enhanced performance")
+    :::image type="content" source="media/embed-teams-app/preload-app.png" alt-text="Preload app for enhanced performance.":::
 
 4. For the changes to take effect, remove and add your app into Teams again.
 
-> [!NOTE]
-> This allows users to download the compiled app while authentication is in progress for embedded scenarios. However, the users can run your app only after successful authentication. This behavior ensures that your app data won't be available to unauthenticated users. Information in the compiled app includes—a collection of JavaScript files containing text authored in app controls, media assets (such as images), the app name, and the environment URL the app resides in.  
+    > [!NOTE]
+    > This allows users to download the compiled app while authentication is in progress for embedded scenarios. However, the users can run your app only after successful authentication. This behavior ensures that your app data won't be available to unauthenticated users. Information in the compiled app includes—a collection of JavaScript files containing text authored in app controls, media assets (such as images), the app name, and the environment URL the app resides in.  
 
 ### See also
 

powerapps-docs/teams/embed-teams-tab.md

@@ -23,7 +23,7 @@ contributors:
 
 # Embed a canvas app as tab app in Teams
 
-You can customize the Teams experience by adding Power Apps canvas apps to your channels in Teams using the **PowerApps** tab. In this topic, you learn how to add the Product Showcase sample app to a Teams channel, and then open the app from that channel. 
+You can customize the Teams experience by adding Power Apps canvas apps to your channels in Teams using the **Power Apps** tab. In this topic, you learn how to add the Product Showcase sample app to a Teams channel, and then open the app from that channel. 
 
 ![App embedded in Microsoft Teams.](media/open-app-embedded-in-teams/embedded-app.png "App embedded in Microsoft Teams")