Merge branch 'main' into guidance-guidelines-fixes

Author: RobStand

powerapps-docs/maker/data-platform/formula-columns.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/media/formula-columns-decimal-adv-options.png

@@ -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)]

powerapps-docs/maker/data-platform/media/formula-columns-decimal-fd.png

@@ -1,18 +1,16 @@
 ---
 title: Explore data on a grid page
 description: Explore tabular data on a grid page in model-driven apps.
-author: jasongre
+author: fikaradz 
 ms.component: pa-user
 ms.topic: conceptual
-ms.date: 06/05/2024
+ms.date: 06/28/2024
 ms.subservice: end-user
-ms.author: jasongre
+ms.author: fikaradz
 ms.reviewer: sericks
 ms.assetid: 
 search.audienceType: 
   - enduser
-contributors:
-- fikaradz 
 ---
 # Explore data on a grid page
 
@@ -96,7 +94,7 @@ If your administrator has turned on quick find, then the search box shows **Quic
 
 ## Column header actions
 
-Dropdown column headers provide a variety of options to let you modify the data shown in the grid. 
+Dropdown column headers provide various options to let you modify the data shown in the grid. 
 
 ### Sorting
 
@@ -113,7 +111,7 @@ To focus on records that meet particular criteria, you can filter a view by one
 > In Unified Interface, grids don't pre-populate column filters based on the current view definition.
 
 > [!NOTE]
-> Filtering is not supported on virtual entities.  
+> Filtering isn't supported on virtual entities. The grid filter's look-up list is limited to 100 results.  
 
 #### Filtering on a lookup column
 
@@ -137,7 +135,7 @@ Use the activity type filter to show only the activities you're interested in, s
 
 When configured, the dropdown column headers surface a **Group by** option. This allows you to group the data in the grid by values in the selected group. 
 
--  Grouping is available for most kinds of columns. This notably does not include lookup columns.
+-  Grouping is available for most kinds of columns. This notably doesn't include lookup columns.
 -  When grouping on date fields, you need to choose a timeframe to on which to group. This includes day, week, month, quarter, and year.
 -  You can only group by one column at a time; selecting **Group by** on a different column replaces any existing grouping criteria.
 -  You can remove the grouping by selecting **Ungroup** from the same dropdown column header to remove the grouping.