Live publish

Author: buck1ey

powerapps-docs/cards/card-requirements.md

@@ -16,11 +16,11 @@ ms.collection:
 
 [!INCLUDE[cards_preview_notice](includes/preview-include.md)]
 
-This article contains information on requirements for cards to show up and work as expected.
+This article contains information about requirements for cards to show up and work as expected.
 
 ## Environment requirements
 
-Cards are available in environments with Dataverse.
+Cards are available in environments with Microsoft Dataverse.
 
 The table below shows the environment regions cards are supported in.
 

powerapps-docs/cards/make-a-card/designer-overview.md

@@ -42,7 +42,7 @@ Legend:
 
 ### Main menu
 
-Use the main menu to switch between the tools available in the card designer:
+Use the main menu to switch between the tools available in the card designer.
 
 - **Tree View**: View card elements as a hierarchy and view the relationships between elements
 - **Insert**: Add controls
@@ -75,16 +75,16 @@ Each element also has advanced properties, such as:
 
 - **Repeat for every**: Trigger whether or when an element should be repeated
 - **Show when**: Trigger when to show the element
-- **Requires**: Make the element dependent on certain features, with a corresponding minimum version
+- **Requires**: Make the element dependent on certain features with a corresponding minimum version
 
 You can also enter Power Fx expressions in some properties, creating low-code solutions that make your card more powerful.
 
 ### Formula bar and Power Fx editor
 
-Use the formula bar to enter a Power Fx expression as a property of the selected control; for example, to calculate a value when a button is clicked. The formula bar even assists you as you're writing an expression. [Learn more about Power FX](../make-a-card/power-fx/intro-to-pfx.md) and the [functions and formulas you can use in an expression](/powerapps/maker/canvas-apps/formula-reference).
+Use the formula bar to enter a Power Fx expression as a property of the selected control (for example, to calculate a value when a button is clicked). The formula bar even assists you as you're writing an expression. [Learn more about Power FX](../make-a-card/power-fx/intro-to-pfx.md) and the [functions and formulas you can use in an expression](/powerapps/maker/canvas-apps/formula-reference).
 
 > [!NOTE]
-> Some expressions that are supported in Power Apps aren't available for cards. For more information, see [Power Fx and cards overview](../make-a-card/power-fx/intro-to-pfx.md).
+> Some expressions that are supported in Power Apps aren't available for cards. For more information, go to [Power Fx and cards overview](../make-a-card/power-fx/intro-to-pfx.md).
 
 ### Play button
 

powerapps-docs/cards/make-a-card/power-fx/intro-to-pfx.md

@@ -29,7 +29,7 @@ The [Power Fx documentation](/power-platform/power-fx/overview) is the main sour
 
 ## Known limitations of using Power Fx in cards
 
-The following table lists the Power Fx formulas that don't work in cards, or have limitations. All other functions are fully supported.
+The following table lists the Power Fx formulas that don't work in cards or have limitations. All other functions are fully supported.
 
 | Power Fx formula | Supported in cards | 
 |---------|:---:|

powerapps-docs/cards/make-a-card/variables/variables.md

@@ -41,7 +41,7 @@ As an example, you've created a card that counts how many times the user presses
 
     You can't change the name or type of a variable. If you need to change them, create a new variable.
 
-    You can also customize sender options and, under **Additional variable information**, the **Title** and **Description** of the variable. This information may be helpful for testing and debugging and using your variable with Power Automate flows and Power Virtual Agents bots.
+    You can also customize sender options and, under **Additional variable information**, the **Title** and **Description** of the variable. This information may be helpful for testing, debugging, and using your variable with Power Automate flows and Power Virtual Agents bots.
 
     :::image type="content" source="../../media/variables/new-variable.png" alt-text="Screenshot of the New variable window in the card designer.":::
 

powerapps-docs/cards/manage-cards/manage-cards.md

@@ -26,7 +26,7 @@ This section shows you how to manage cards using security roles.
 
 Cards are stored as rows in Dataverse within the **Card** table. Administrators can use [security roles to control who can create, read, and update cards](/power-platform/admin/wp-security-cds#tablerecord-ownership).
 
-For example, if the user is only assigned to a security role that does not have permission to create rows in the **Card** table, then the user will not be able to create cards.
+For example, if the user is only assigned to a security role that does not have permission to create rows in the **Card** table, then the user won't be able to create cards.
 
 Note that a user will still be able to receive and use cards sent in Teams, regardless of the security role assigned to the user, as those cards are accessed by the Cards for Power Apps service.
 
@@ -57,4 +57,4 @@ This section shows you how to delete a card.
 
 ### Delete a card as the administrator
 
-If the owner of an app is unavailable, it is currently not possible for an administrator, such as Global admin, Azure Active Directory Global admin, or Dynamics 365 admin to delete a card. We are working on enabling this capability.
+If the owner of an app is unavailable, it is currently not possible for an administrator, such as Global admin, Azure Active Directory Global admin, or Dynamics 365 admin to delete a card. We're working on enabling this capability.

powerapps-docs/developer/data-platform/includes/cc-legacy-update-messages.md

@@ -8,4 +8,11 @@
 |<xref:Microsoft.Crm.Sdk.Messages.SetBusinessEquipmentRequest>|[Equipment](/dynamics365/customer-engagement/developer/entities/equipment).[BusinessUnitId](/dynamics365/customer-engagement/developer/entities/equipment#BKMK_BusinessUnitId)|  
 |<xref:Microsoft.Crm.Sdk.Messages.SetBusinessSystemUserRequest>|[SystemUser](../reference/entities/systemuser.md).[BusinessUnitId](../reference/entities/systemuser.md#BKMK_BusinessUnitId)|  
 
- *&lt;entity>* refers to any entity that provides this attribute.  
+ *&lt;entity>* refers to any entity that provides this attribute.  
+
+> [!IMPORTANT]
+> When you update the `StateCode` column, it is important to always set the desired `StatusCode`.
+> 
+>`StateCode` and `StatusCode` have dependent values. There can be multiple valid `StatusCode` values for a given `StateCode` value, but each `StateCode` column has a single [DefaultStatus](xref:Microsoft.Xrm.Sdk.Metadata.StateOptionMetadata.DefaultStatus) value configured.   When you update `StateCode` without specifying a `StatusCode`, the default status value will be set by the system.
+>
+> Also, when auditing is enabled on the table and the `StatusCode` column, the changed value for the `StatusCode` column will not be captured in the audit data unless it is specified in the update operation.

powerapps-docs/developer/data-platform/webapi/update-delete-entities-using-web-api.md

@@ -1,7 +1,7 @@
 ---
 title: "Update and delete table rows using the Web API (Microsoft Dataverse)| Microsoft Docs"
 description: "Read how to perform update and delete operations on tables using the Web API"
-ms.date: 08/01/2022
+ms.date: 12/14/2022
 author: divka78
 ms.author: dikamath
 ms.reviewer: jdaly
@@ -30,6 +30,8 @@ The `If-Match: *` header ensures you don't create a new record by accidentally p
 
 > [!IMPORTANT]
 > When updating an entity, only include the properties you are changing in the request body. Simply updating the properties of an entity that you previously retrieved, and including that JSON in your request, will update each property even though the value is the same. This can cause system events that can trigger business logic that expects that the values have changed. This can cause properties to appear to have been updated in auditing data when in fact they haven't actually changed.
+>
+> When you update the `statecode` property, it is important to always set the desired `statuscode`. `statecode` and `statuscode` have dependent values. There can be multiple valid `statuscode` values for a given `statecode` value, but each `statecode` column has a single [DefaultStatus](xref:Microsoft.Xrm.Sdk.Metadata.StateOptionMetadata.DefaultStatus) value configured.   When you update `statecode` without specifying a `statuscode`, the default status value will be set by the system. Also, when auditing is enabled on the table and the `statuscode` column, the changed value for the `statuscode` column will not be captured in the audit data unless it is specified in the update operation.
 
 > [!NOTE] 
 > The definition for attributes includes a `RequiredLevel` property. When this is set to `SystemRequired`, you cannot set these attributes to a null value. More information: [Attribute requirement level](../entity-attribute-metadata.md#column-requirement-level)

powerapps-docs/teams/add-app-notifications.md

@@ -16,9 +16,9 @@ contributors:
 
 # Add notifications to make your apps collaborative
 
-Apps in Microsoft Teams are designed to enable collaboration between people in your organization. When you have an app that has a hand-off of information, such as group A doing something that group B then needs to process, if everything happens in the app, users may miss important updates and processes might stall.
+Apps in Microsoft Teams are designed to enable collaboration between people in your organization. When you have an app that has a hand-off of information, such as group A doing something that group B then needs to process, if everything happens in the app, users may miss important updates, and processes might stall.
 
-Using notifications for critical events in your apps in Teams enhances collaboration by proactively letting users know that there's something that needs their attention, or needs to be done.
+Using notifications for critical events in your apps in Teams enhances collaboration by proactively letting users know that something needs their attention or needs to be done.
 
 Teams and Power Platform give you many options in the ways that you can notify people.
 
@@ -33,7 +33,7 @@ Watch this video to learn how to add notifications to make your apps collaborati
 
 ## Choose the right notification type
 
-How should you decide what type of notification to use? Many people default to email notifications, but many people also complain that they receive too many emails. Email is an acceptable type of notification, but it should be used sparingly. Especially for urgent notifications, as frequently emails aren't seen immediately.
+How should you decide what type of notification to use? Many people default to email notifications, but many people also complain that they receive too many emails. Email is an acceptable type of notification, but it should be used sparingly. Especially for urgent notifications, as frequent emails are only seen after a period of time.
 
 Here are some questions to ask when defining the appropriate type of notification: