Merge remote-tracking branch 'origin/main' into matp-3011780

Author: Mattp123

.openpublishing.redirection.json

@@ -1,5 +1,15 @@
 {
   "redirections": [
+   {
+      "source_path": "powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/removeOnPostSave.md",
+      "redirect_url": "../../formContext-data-entity/removeOnPostSave",
+      "redirect_document_id": false
+   },
+   {
+      "source_path": "powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/addOnPostSave.md",
+      "redirect_url": "../../formContext-data-entity/addOnPostSave",
+      "redirect_document_id": false
+   },
    {
       "source_path": "powerapps-docs/developer/data-platform/org-service/metadata-retrieve-detect-changes.md",
       "redirect_url": "../query-schema-definitions",

powerapps-docs/cards/card-requirements.md

@@ -0,0 +1,52 @@
+---
+title: Requirements for cards
+description: Learn about the requirements for using Cards for Power Apps.
+ms.date: 11/17/2022
+ms.topic: overview
+author: sericks007
+ms.author: sericks
+manager: tapanm-msft
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+
+---
+
+# Requirements for cards
+
+[!INCLUDE[cards_preview_notice](includes/preview-include.md)]
+
+This article contains information on requirements for cards to show up and work as expected.
+
+## Environment requirements
+
+Cards are available in environments with Dataverse.
+
+The table below shows the environment regions cards are supported in.
+
+| Environment region | Supported in region |
+|--------------|:---:|
+| United States | Yes |
+| Europe | Yes |
+| Asia | Yes |
+| Brazil | Yes |
+| Australia | Yes |
+| Japan | Yes |
+| India | Yes |
+| Canada | Yes |
+| United Kingdom | Yes |
+| Germany | No |
+| Switzerland | No |
+| United Arab Emirates | No |
+| South Africa | No |
+| Korea | No |
+| Norway | No |
+| Sovereign-cloud regions | No |
+
+## Supported platforms for authoring cards
+
+Cards has the same [system requirements as Power Apps](../limits-and-config.md) for authoring cards.
+
+## Supported platforms for sending cards
+
+Cards can be sent to [Microsoft Teams](/send-a-card/send-card-in-teams.md) in desktop, mobile, or web clients.

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

@@ -1,14 +1,15 @@
 ---
 title: Card designer overview (preview)
 description: Learn about the card designer.
-ms.date: 09/20/2022
+ms.date: 11/17/2022
 ms.topic: overview
-author: iaanw
-ms.author: iawilt
-manager: shellyha
+author: sericks007
+ms.author: sericks
+manager: tapanm-MSFT
 ms.reviewer: 
 ms.custom: 
 ms.collection: 
+
 ---
 
 # Card designer overview (preview)
@@ -83,7 +84,7 @@ You can also enter Power Fx expressions in some properties, creating low-code so
 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. [See details](/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, see [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

@@ -1,14 +1,15 @@
 ---
 title: Power Fx and cards overview (preview)
 description: Learn about Power FX and how it's used to add business logic in cards for Microsoft Power Apps.
-ms.date: 09/20/2022
+ms.date: 11/17/2022
 ms.topic: overview
-author: iaanw
-ms.author: iawilt
-manager: shellyha
+author: sericks007
+ms.author: sericks
+manager: tapanm-MSFT
 ms.reviewer: 
 ms.custom: 
 ms.collection: 
+
 ---
 
 # Power Fx and cards overview (preview)
@@ -28,11 +29,63 @@ The [Power Fx documentation](/power-platform/power-fx/overview) is the main sour
 
 ## Known limitations of using Power Fx in cards
 
-The following Power Fx formulas don't work in cards or work with limitations:
+The following table lists the Power Fx formulas that don't work in cards, or have limitations. All other functions are fully supported.
 
-- Device sensor formulas (**Acceleration**, **App**, **Compass**, **Connection**, and **Location**) don't work.
-- **SaveData**, **LoadData**, and **ClearData** don't work.
-- Form-related formulas (**EditForm**, **NewForm**, **SubmitForm**, **ResetForm**, and **ViewForm**) don't work.
-- **Update** and **UpdateIf** don't work.
-- **Collect**, **Patch**, and **Remove** work with variables and Dataverse tables only.
-- **Set** requires the variable to exist and the variable type to match what you're trying to set it to.
+| Power Fx formula | Supported in cards | 
+|---------|:---:|
+| [Set](/power-platform/power-fx/reference/function-set) | Yes<br><br>Requires the variable to exist and the variable type to match what you're trying to set it to.|
+| [Collect](/power-platform/power-fx/reference/function-clear-collect-clearcollect#collect) | Yes<br><br>Requires the variable to exist and the variable type to match what you're trying to set it to. |
+| [Defaults](/power-platform/power-fx/reference/function-defaults) | No <br><br> Use [Collect](/power-platform/power-fx/reference/function-clear-collect-clearcollect#collect) instead, for example, instead of `Patch(account, Defaults(account), {"Account Name": "Example Account"})` use `Collect(account, {"Account Name": "Example Account"})`. |
+| [User()](/power-platform/power-fx/reference/function-user) | No <br><br>Instead use **Viewer**, which has a subset of information about the user viewing the card. |
+| [Clear](/power-platform/power-fx/reference/function-clear-collect-clearcollect#clear) | No |  
+| [ClearCollect](/power-platform/power-fx/reference/function-clear-collect-clearcollect#clearcollect) | No | 
+| [Update](/power-platform/power-fx/reference/function-update-updateif#update-function) | No | 
+| [UpdateIf](/power-platform/power-fx/reference/function-update-updateif#updateif-function) | No | 
+| Device sensor formulas ([Acceleration, App, Compass, Connection, and Location](/power-platform/power-fx/reference/signals)) | No | 
+| [SaveData, LoadData, and ClearData](/power-platform/power-fx/reference/function-savedata-loaddata) | No | 
+| Form-related formulas ([EditForm, NewForm, SubmitForm, ResetForm, and ViewForm](/power-platform/power-fx/reference/function-form)) | No | 
+| AddColumns | No |  
+| Concurrent | No | 
+| DropColumns | No | 
+| EncodeUrl | No | 
+| IsEmpty | No | 
+| IsMatch | No | 
+| IsType | No | 
+| JSON | No | 
+| Match | No | 
+| PlainText | No | 
+| RemoveIf | No | 
+| SortByColumns | No | 
+| Update | No | 
+| UpdateIf | No | 
+| AsType | No | 
+| Distinct | No | 
+| exactin | No | 
+| GroupBy | No | 
+| in | No | 
+| RenameColumns | No | 
+| Search | No | 
+| ShowColumns | No | 
+| UTCNow | No | 
+| UTCToday | No | 
+| Validate | No | 
+| Weekday | No | 
+| As | No | 
+| Calendar | No | 
+| Choices | No | 
+| Clock | No | 
+| ColorFade | No | 
+| ColorValue | No | 
+| Errors | No | 
+| HashTags | No | 
+| ISOWeekNum | No | 
+| Language | No | 
+| MatchAll | No | 
+| Refresh | No | 
+| RGBA | No | 
+| WeekNum | No | 
+| Notify | No | 
+| Select | No | 
+| SetProperty | No | 
+| Download | No | 
+| SetFocus | No | 

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

@@ -1,14 +1,15 @@
 ---
 title: Add variables to a card (preview)
 description: Learn how to add variables to your cards for Microsoft Power Apps.
-ms.date: 09/20/2022
+ms.date: 11/17/2022
 ms.topic: how-to
-author: iaanw
-ms.author: iawilt
-manager: shellyha
+author: sericks007
+ms.author: sericks
+manager: tapanm-MSFT
 ms.reviewer: 
 ms.custom: 
 ms.collection: 
+
 ---
 
 # Add variables to a card (preview)
@@ -46,6 +47,23 @@ As an example, you've created a card that counts how many times the user presses
 
 1. Select **Save**.
 
+### Using the default value for tables and records
+
+The default value is used to set the structure for table and record variables. There are two ways to set the default value of a record or table variable:
+
+- Using a Power Fx expression
+- Using JSON
+
+You can toggle between whether you are using Power Fx or JSON using the icon on the right.
+
+:::image type="content" source="../../media/variables/default-value.png" alt-text="Screenshot of the how to toggle between JSON and Power Fx for setting the variable default value.":::
+
+Using a Power Fx expression is helpful when you want the variable to store data from a data source, like Dataverse. For example, if you wanted a record that held a specific row from the **Account** table, you could set the default value to `First(account)`.
+
+Using JSON is helpful when you are using the variable to store custom data. For example, if you wanted to collect a list of people's names, you could set the default value to `[{"First Name": "John", "Last Name": "Doe"}]`.
+
+Variables are strongly typed and so setting the default value locks the variable into those types.
+
 ### Edit and delete variables
 
 To edit or delete a variable, select the ellipsis (**...**) to the right of the variable, and then select **Edit** or **Delete**.
@@ -54,8 +72,12 @@ To edit or delete a variable, select the ellipsis (**...**) to the right of the
 
 ## Use variables in cards
 
-There are various ways to use variables in cards. [Learn about working with variables in Power Apps](/powerapps-docs/maker/canvas-apps/working-with-variables.md).
+There are various ways to use variables in cards. [Learn about working with variables in Power Apps](../../../maker/canvas-apps/working-with-variables.md).
 
 A common use for variables is in Power Fx expressions. Refer to the variable by name in your formula. For an example, go to the [simple card tutorial](../../tutorials/hello-world-card.md). Your variables are recognized in the formula bar as well.
 
 :::image type="content" source="../../media/variables/formula-bar-example.png" alt-text="Screenshot of an automatically filled variable name in the card designer formula bar.":::
+
+### Updating the value of a variable
+
+Variables can be updated using the [**Set**](/power-platform/power-fx/reference/function-set) function, excluding table variables which are added to using the [**Collect**](/power-platform/power-fx/reference/function-clear-collect-clearcollect) function.

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

@@ -0,0 +1,60 @@
+---
+title: Manage cards
+description: This article will help you use security roles to manage cards and explains how to delete a record.
+ms.date: 11/17/2022
+ms.topic: overview
+author: sericks007
+ms.author: sericks
+manager: tapanm-MSFT
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+
+---
+
+# Manage cards
+
+[!INCLUDE[cards_preview_notice](../includes/preview-include.md)]
+
+This article will help you use security roles to manage cards and explains how to delete a record.
+
+## Manage cards with security roles
+
+This section shows you how to manage cards using security roles.
+
+### Change who can create cards
+
+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.
+
+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.
+
+### Disable cards for an environment
+
+The Cards for Power Apps service uses the security role called **Cards Role** to communicate with Dataverse. By removing permissions for the **Cards Role** in an environment to create, read, or update the **Card** table, no one will be able to use cards within that environment.
+
+### Cards security roles
+
+- **Cards Basic Role** can be used to grant a user access to view, create, and use cards in that environment. 
+
+   Other security roles can be modified to view, create, and use cards by changing security role access to the **Card** table in Dataverse.
+
+- **Cards Role** is used internally by the Cards for Power Apps service to communicate with Dataverse.
+
+## Delete a card
+
+This section shows you how to delete a card.
+
+### Delete a card as the owner
+
+1. Sign in to Power Apps.
+1. Select **Cards** from the left pane.
+1. Select the card to be deleted.
+1. Select **Delete** in the command bar.
+
+   :::image type="content" source="../media/manage-cards/delete-a-card.PNG" alt-text="Screenshot of 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.

powerapps-docs/cards/media/manage-cards/delete-a-card.PNG

@@ -31,7 +31,7 @@ Following the steps below will change the default label and text box column of t
 
 3. In the form editor, double-click the column where you want to add a code component, such as the **Budget Amount** column on the opportunity main form. You can also create a custom column.
 
-4. On the **Field Properties** page, select the **Controls** tab, and then select **Add Control**.
+4. Select the Controls tab on the **Field Properties** page, and then select **Add Control**.
 
 5. On the Add Control page, select the component that you want, such as the **Linear Slider** component, and then select **Add**.
 
@@ -97,4 +97,4 @@ To add a code component like dataset component or simple table component to a gr
 [Power Apps component framework overview](overview.md)
 
 
-[!INCLUDE[footer-include](../../includes/footer-banner.md)]
+[!INCLUDE[footer-include](../../includes/footer-banner.md)]

powerapps-docs/cards/media/variables/default-value.png

@@ -84,6 +84,8 @@
       href: query-throttling.md
     - name: Query Hierarchical data
       href: query-hierarchical-data.md
+    - name: Use file column data
+      href: file-column-data.md
     - name: Audit data changes
       items:
         - name: Overview