Merge branch 'main' into tapanm-MSFT-patch-11

Author: mduelae

powerapps-docs/maker/TOC.yml

@@ -400,7 +400,7 @@
             href: ./canvas-apps/inline-actions.md
           - name: Add comments
             href: ./canvas-apps/comments.md
-          - name: Understand copresence
+          - name: Understand coauthoring
             href: ./canvas-apps/copresence-power-apps-studio.md
           - name: Add and configure controls
             href: ./canvas-apps/add-configure-controls.md

powerapps-docs/maker/canvas-apps/copresence-power-apps-studio.md

@@ -5,7 +5,7 @@ author: mkaur
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: mkaur
-ms.date: 06/09/2023
+ms.date: 06/27/2024
 ms.subservice: canvas-maker
 ms.author: mkaur
 search.audienceType: 
@@ -41,42 +41,65 @@ You might be working on the app, or you're inactive, but once someone else saves
 
 ## Inactive during editing
 
-When you're editing an app and become inactive for two hours, a **Continue editing** dialog box is displayed, asking if you want to continue editing the app or switch to read-only. If you don't respond, the system informs you that you were inactive and puts you in read-only mode, so other readers can to become the editor. 
+When you're editing an app and become inactive for two hours, a **Continue editing** dialog box is displayed, asking if you want to continue editing the app or switch to read-only. If you don't respond, the system informs you that you were inactive and puts you in read-only mode, so other readers can become the editor. 
 
 If auto save is turned on, your changes are automatically saved. If auto save isn't turned on, a **You're no longer editing** dialog box appears that lets you save a copy of your changes.
 
 
-## Live updates (experimental)
+## Coauthoring (preview)
 
 [This section is pre-release documentation and is subject to change.]
 
-> [!IMPORTANT]
-> - This is an experimental feature.
-> - Experimental features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
-> - This feature is in the process of rolling out, and might not be available in your region yet.
+Coauthoring allows multiple makers to edit a canvas app at the same time. When more than one person is editing an app, you'll see presences indicators showing where another maker is working on the app and see their changes in real time.
+
 
+> [!div class="mx-imgBorder"] 
+> ![Coauthoring in Power Apps Studio.](media/copresence/coauthoring.png)
 
-Live updates is a new experimental feature that works similarly to copresence. The user who opens the app first has the editing privileges. When another user attempts to open the app, a notification is displayed, informing them that someone else is currently editing the app and they're limited to read-only access. The benefit of live updates is that you can see in real-time the changes that are being made by the maker editing the app without the need to refresh the app.
 
-### Enable live updates
+Legend
 
-To use live updates, it must be turned on for each individual app. Once live updates is enabled, it takes precedence over the copresence feature.
+1. The command bar shows that you're in **Editing** mode. When there's multiple editors, you'll see their avatar.
+1. The area that's being edited by another maker is highlighted and shows their initials.  
+1. The left-hand navigation pane in Power Apps Studio displays the app's structure, indicating which part of the app is being edited by another maker. 
 
-1. To enable live updates, open your app for editing in Power Apps Studio.
-2. Go to **Settings** > **Upcoming features** > **Experimental**.
-3. Set the toggle for **Enable live updates** to **On**.
+> [!NOTE]
+> Since multiple users can select and edit the same control at the same time, you may overwrite each other’s edits.
 
 
-### Limitations of live updates
+> [!IMPORTANT]
+> - This is a preview feature.
+> - This feature is in the process of rolling out, and might not be available in your region yet.
+
+### Enable coauthoring
+
+To use coauthoring, it must be turned on for each individual app. Once coauthoring is enabled, it takes precedence over the copresence feature.
+
+1. To enable live updates, open your app for editing in Power Apps Studio.
+2. Go to **Settings** > **Updates** > **Preview**.
+3. Set the toggle for **Coauthoring** to **On**.
+
+
+### Limitations 
+
+- The following options are disabled when there's more than one user editing the app:
+  - Search 
+  - Save as
+  - Open another or new app
+  - Undo and redo
+  - Switch authoring versions
+- The maximum number of coauthors allowed is 10, either in one session or across a total of 10 tabs, depending on which limit is reached first. Any additional coauthors or tabs beyond 10 will be in copresence and will not have the ability to edit the app or receive real-time updates.
+- The app language is locked to the locale of the first user that opens the app for editing.
+-  Cut is disabled.
+- Coauthoring is disabled in the Monitor tool.
+- Problems might occur with the following actions:
+  - When you rename a control
+  - When you add AI Builder components
+  - When you add geospatial controls
+  - When one author adds a flow and another coauthor tries to run the flow without first refreshing the app
+  - Some errors from one author's actions are visible to all other coauthors
+  - When you copy and paste
 
-The maker editing the app and those accessing it in read-only mode are unable to perform or have disabled access to these options:
 
-- Undo or redo changes
-- Switch authoring version
-- Open a new app from data, app from template, new app from blank, and edit app
-- Use **Save as** option or save the app locally
-- [Monitor tool](../monitor-overview.md)
-- Search pane
-- Makers accessing the app in read-only mode can't make any changes
 
 

powerapps-docs/maker/canvas-apps/media/copresence/coauthoring.png

@@ -4,10 +4,11 @@ description: Learn how to access ready only data that is in long term storage.
 author: pnghub
 ms.author: gned
 ms.reviewer: matp
+contributors: manasdalai
 ms.service: powerapps
 ms.topic: how-to
-ms.date: 03/12/2024
-ms.custom: template-how-to 
+ms.date: 06/27/2024
+ms.custom: template-how-to
 ---
 # View long term retained data
 
@@ -39,6 +40,20 @@ If you need to retrieve long term data from multiple related tables, such as the
 
 More information: [Advanced find in model-driven apps](../../user/advanced-find.md)
 
+## View retained data using using FetchXml
+In order to fetch the retained data for a table, specify the `datasource="retained"` in the FetchXml.
+
+Example:
+```xml
+<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="true" no-lock="false" datasource="retained">
+	<entity name="opportunity">
+		<attribute name="opportunityid"></attribute>
+	</entity>
+</fetch>
+```
+
+More information: [Use FetchXml to retrieve data](/power-apps/developer/data-platform/fetchxml/retrieve-data?tabs=sdk)
+
 ## View retained data using a flow
 
 Create a Power Automate cloud flow to create an Excel file of the retained data from a FetchXML query and send as an email attachment. More information: [Create a cloud flow to view Dataverse long term retained data](/power-automate/dataverse/data-retention-flow)

powerapps-docs/maker/data-platform/data-retention-view.md

@@ -5,7 +5,7 @@ author: sanjeevgoyalmsft
 reviewer: mattp123
 ms.topic: how-to
 ms.custom: 
-ms.date: 04/30/2024
+ms.date: 06/28/2024
 ms.subservice: teams
 ms.author: dikamath
 ms.reviewer: matp
@@ -14,6 +14,7 @@ contributors:
   - mattp123
   - sanjeevgoyalmsft
   - JimDaly
+  - neerajatmsft
 ---
 # Work with formula columns
 
@@ -135,11 +136,12 @@ For more information, go to [Operators in Power Apps](../canvas-apps/functions/o
 You can display the following data types in a formula column:
 
 - Text
-- Decimal number
+- [Decimal number](#create-a-decimal-formula-column)
 - Choice Yes/No (boolean)
 - Datetime
+- [Whole Number](#create-a-whole-number-formula-column)
 
-The currency, whole number, and choice (formerly option sets) data types aren't currently supported.
+The currency, and choice (formerly option sets) data types aren't currently supported.
 
 ## Function types
 
@@ -367,6 +369,36 @@ You can use the following scalar functions in a formula column:
 |---------|---------|
 |Retrieve a date value.  |  `DateAdd(UTCNow(),-1,TimeUnit.Years)`   |
 
+## Create a decimal formula column
+
+Create a formula column that returns a decimal number.
+
+1. When you create a column, enter the following information:
+   - A **Display name** for the column.
+   - Optionally, enter a **Description** of the column.
+1. For **Data type** select ***fx* Formula**.
+1. Enter a formula that returns a numeric value in the **Formula** bar.
+   This example creates a formula column called *Total Amount*. The *Price Per Unit* column is of decimal data type.
+   :::image type="content" source="media/formula-columns-decimal-fd.png" alt-text="Screenshot of a create a new formula column pane for use with a decimal number.":::
+1. Expand **Advanced options**, select **Decimal** as the **Formula data type**, and then set the required number of decimal places.
+  :::image type="content" source="media/formula-columns-decimal-adv-options.png" alt-text="Screenshot of a decimal formula column definition.":::
+1. Select **Save**.
+
+## Create a whole number formula column
+
+Create a formula column that returns a whole number.
+
+1. When you create a column, enter the following information:
+   - A **Display name** for the column.
+   - Optionally, enter a **Description** of the column.
+1. For **Data type** select ***fx* Formula**.
+1. Enter a formula that returns a numeric value in the **Formula** bar.
+   This example creates a formula column called *Number of Units*. *Total Price* and *Price Per Unit* columns are of decimal data type.
+   :::image type="content" source="media/formula-columns-wholenum-fd.png" alt-text="Screenshot of a create a new formula column pane for use with a whole number..":::
+1. Expand **Advanced options**, and select **Whole number** as the **Formula data type** and set the required format for whole number column.
+  :::image type="content" source="media/formula-columns-wholenum-adv-options.png" alt-text="Screenshot of a whole number formula column definition.":::
+1. Select **Save**.
+
 ## Guidelines and limitations
 
 This section describes guidelines and the known limitations with formula columns in Dataverse.
@@ -442,6 +474,8 @@ This section describes guidelines and the known limitations with formula columns
 - Duplicate detection rules aren't triggered on formula columns.
 - The `Now` function can be used with formula columns. `Now()` has user local behavior and `UTCNow()` has time zone independent behavior.
 - You can set the precision property for decimal columns.
+- Default formula data type value is set to **Decimal** for numeric value returning formulas.
+- Updating whole number formula column's format isn't supported.
 
 ### Power Fx functions not currently supported
 
@@ -453,7 +487,6 @@ This section describes guidelines and the known limitations with formula columns
 
 ### Formula columns of data types that can't be produced
 
-- Whole Number
 - Choices (except Yes/No choice)
 - Currency
 

powerapps-docs/maker/data-platform/formula-columns.md

@@ -6,7 +6,7 @@ editor: ''
 tags: ''
 ms.topic: how-to
 ms.component: model
-ms.date: 10/18/2023
+ms.date: 06/28/2024
 ms.subservice: mda-maker
 ms.author: matp
 search.audienceType:
@@ -155,7 +155,7 @@ There are a few key environment and licensing prerequisites required when sharin
 - A Microsoft 365 user with Power Platform administrator rights or global admin rights must exist within the organization. [Learn how to assign Power Platform Administrator rights](/power-platform/admin/use-service-admin-role-manage-tenant).  This provides the user with administrator rights over all environments.
 - The app sharer must have admin privileges to the specific environment (or be a Power Platform administrator). The app sharer must have a [security role](/power-platform/admin/security-roles-privileges) with equal or greater privileges than the security role they're assigning to the app and to other users. Usually, this takes the form of the app sharer having the Dataverse **System Administrator** or **System Customizer** security role.  These roles can be assigned by Power Platform administrators (who have rights over all Dataverse environments). The system administrator and system customizer security roles are standard roles that exist within all Dataverse environments.
 - The user must exist as a user within the environment. It isn't enough to only be a Microsoft 365 user. This is because all users in an environment are accounted for and described within tables in the environment. [Learn how to add a user to an environment](/power-platform/admin/add-users-to-environment)
-- Users must have the correct [license](/power-platform/admin/pricing-billing-skus) to be able to use the app. Users can [request a license themselves](../../user/request-license.md), or a [maker can request licenses for their app users](../common/request-licenses-for-users.md). Also, the license must be assigned in the tenant hosting the app. The exception to this prerequisite is when an app is hosted in a Microsoft Dataverse for Teams environment.
+- Users must have the correct [license](/power-platform/admin/pricing-billing-skus) to be able to use the app. Users can [request a license themselves](../../user/request-license.md), or a [maker can request licenses for their app users](../common/request-licenses-for-users.md). Also, the license must be assigned in either the users home tenant or the tenant hosting the app. 
 
 ## About predefined security roles
 
@@ -184,4 +184,4 @@ Administrators can use their organization's Microsoft Entra groups to manage acc
 
 [Run a model-driven app on a mobile device](/dynamics365/customerengagement/on-premises/basics/dynamics-365-phones-tablets-users-guide-onprem)
 
-[!INCLUDE[footer-include](../../includes/footer-banner.md)]
+[!INCLUDE[footer-include](../../includes/footer-banner.md)]