Merge branch 'main' of https://github.com/MicrosoftDocs/powerapps-docs-pr into mg-timeline-maker

Author: gandhamm

.openpublishing.redirection.json

@@ -1,10 +1,40 @@
 {
   "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",
+      "redirect_document_id": false
+   }, 
+   {
+      "source_path": "powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/getoutput.md",
+      "redirect_url": "getoutputs",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/cards/glossary.md",
+      "redirect_url": "overview",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "powerapps-docs/developer/data-platform/webapi/aad-group-team.md",
+      "redirect_url": "../aad-group-team",
+      "redirect_document_id": false
+    },
     {
       "source_path": "powerapps-docs/developer/data-platform/walkthrough-registering-configuring-simplespa-application-adal-js.md",
       "redirect_url": "quick-start-register-configure-simplespa-application-msal-js",
       "redirect_document_id": false
-    }, 
+    },
     {
       "source_path": "powerapps-docs/maker/data-platform/azure-synapse-link-copy-sql.md",
       "redirect_url": "azure-synapse-link-pipelines",

README.md

@@ -1,12 +1,12 @@
 # Microsoft Power Apps Documentation
 
-This is the GitHub repository for the technical product documentation for **Power Apps**. This documentation is published at [Microsoft Power Apps documentation](https://docs.microsoft.com/powerapps).
+This is the GitHub repository for the technical product documentation for **Power Apps**. This documentation is published at [Microsoft Power Apps documentation](https://learn.microsoft.com/powerapps).
 
 ## How to contribute
 
-Thanks for your interest in [contributing](https://docs.microsoft.com/), home of technical content for Microsoft products and services.
+Thanks for your interest in [contributing](https://learn.microsoft.com/), home of technical content for Microsoft products and services.
 
-To learn how to make contributions to the content in this repository, start with our [Docs contributor guide](https://docs.microsoft.com/contribute). If you are a Microsoft employee, please visit the [internal version](https://aka.ms/contributors-guide) of this guide (only accessible to Microsoft employees).
+To learn how to make contributions to the content in this repository, start with our [Docs contributor guide](https://learn.microsoft.com/contribute). If you are a Microsoft employee, please visit the [internal version](https://aka.ms/contributors-guide) of this guide (only accessible to Microsoft employees).
 
 ## Code of conduct
 

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/includes/preview-include.md

@@ -0,0 +1 @@
+[This article is pre-release documentation and is subject to change.]

powerapps-docs/cards/make-a-card/connectors/connector-intro.md

@@ -0,0 +1,37 @@
+---
+title: Add connectors to a card (preview)
+description: Learn how to add connectors to your cards for Microsoft Power Apps.
+ms.date: 09/20/2022
+ms.topic: how-to
+author: iaanw
+ms.author: iawilt
+manager: shellyha
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+---
+
+# Add connectors to a card (preview)
+
+[!INCLUDE[cards_preview_notice](../../includes/preview-include.md)]
+
+Connectors allow your card to connect to other apps, data sources, and devices in the cloud. Insert, modify, and remove them in the [card designer](../designer-overview.md). [Learn more about connectors in Power Platform](/connectors/connectors).
+
+## Prerequisites
+
+- A [Power Apps](https://powerapps.microsoft.com/) account
+- [A card](../../tutorials/hello-world-card.md)
+
+## Insert a connector
+
+1. Sign in to [Power Apps](https://powerapps.microsoft.com/). Select **Cards (preview)** > **Cards**, and then select a card.
+1. In the left pane of the card designer, select **Data**.
+1. Select **+ Add data**, and then select a data source from the list.
+
+    :::image type="content" source="../../media/connector-intro/add-data-___location.png" alt-text="Screenshot of a list of data sources in the card designer.":::
+
+## Types of connectors
+
+Only connections to Dataverse are currently available. Other connectors are shown in the data source list, but functionality for them will be added in future updates.
+
+You can connect to Dataverse tables to create, read, update, and delete records. [Learn how to create a card with data from Dataverse](../../tutorials/dataverse-card.md).

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

@@ -0,0 +1,95 @@
+---
+title: Card designer overview (preview)
+description: Learn about the card designer.
+ms.date: 11/17/2022
+ms.topic: overview
+author: sericks007
+ms.author: sericks
+manager: tapanm-MSFT
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+
+---
+
+# Card designer overview (preview)
+
+[!INCLUDE[cards_preview_notice](../includes/preview-include.md)]
+
+The Power Apps card designer is the drag-and-drop interface in which you build cards.
+
+1. Sign in to [Power Apps](https://make.powerapps.com) and select your environment.
+
+1. In the left pane, select **Cards (preview)**.
+
+1. To open the card designer, select **Create**, and then select **+ Create a card**.
+
+   :::image type="content" source="../media/designer-overview/create-new-card.png" alt-text="Screenshot showing card creation screen.":::
+
+## The card designer interface
+
+:::image type="content" source="../media/designer-overview/designer-elements.png" alt-text="Screenshot of the Power Apps card designer with elements highlighted.":::
+
+Legend:
+
+1. Main menu
+1. Tool pane
+1. Card canvas
+1. Card
+1. Property pane
+1. Formula bar
+1. Play button
+
+### Main menu
+
+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
+- **Data**: Add connectors to incorporate data from external sources
+- **Variables**: Store and reuse data
+
+### Tool pane
+
+Use the tool pane to add and view card elements like controls, connectors, and variables to your card.
+
+### Card canvas and card
+
+The card canvas is where you build your card by adding connectors, variables, and controls from the tool pane.
+
+> [!NOTE]
+> You can't resize a card in the card canvas. Cards automatically fit themselves to the ___location they're placed in.
+
+### Property pane
+
+Use the property pane to modify an element by editing its properties. Each element, and the card itself, has its own property pane. For most of the drag-and-drop elements, you can specify basic properties:
+
+- **Name**: The name of the element, either the default name or a name you provide. You can refer to an element by name in a Power Fx formula.
+- **Label** or **Text**: Text that's shown on the card
+- **Default value**: The initial value of an element
+- **Initially visible**: Whether the element is visible when the card is opened
+
+Certain elements have visual properties that you can modify. For text labels and input controls, for example, you can customize the font, color, spacing, and more.
+
+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
+
+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).
+
+> [!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).
+
+### Play button
+
+Use the **Play** button to preview, test, and, if needed, [troubleshoot and debug your card](../make-a-card/testing/debugging-cards.md).
+
+## Next steps
+
+[Make your first card](../tutorials/hello-world-card.md).

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

@@ -0,0 +1,91 @@
+---
+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: 11/17/2022
+ms.topic: overview
+author: sericks007
+ms.author: sericks
+manager: tapanm-MSFT
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+
+---
+
+# Power Fx and cards overview (preview)
+
+[!INCLUDE[cards_preview_notice](../../includes/preview-include.md)]
+
+[Power Fx](/power-platform/power-fx/overview) is a low-code programming language available across the Power Platform, including in Power Apps cards. Cards can calculate values, perform tasks, and respond to user input using formulas expressed in Power Fx. Power Fx expressions can also update variables and data sources. Expressions can be combined to create complex formulas that can handle advanced business logic.
+
+## Power Fx documentation
+
+The [Power Fx documentation](/power-platform/power-fx/overview) is the main source of information about Power Fx. When you're working with cards, you'll find the following articles especially helpful:
+
+- [Expression grammar](/power-platform/power-fx/expression-grammar)
+- [Operators](/power-platform/power-fx/operators)
+- [Variables](/power-platform/power-fx/variables)
+- [Formula reference](/power-platform/power-fx/formula-reference)
+
+## 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.
+
+| 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/screens/use-screens.md

@@ -0,0 +1,56 @@
+---
+title: Add screens to a card (preview)
+description: Learn how to add screens to your cards for Microsoft Power Apps.
+ms.date: 09/20/2022
+ms.topic: how-to
+author: iaanw
+ms.author: iawilt
+manager: shellyha
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+---
+
+# Add screens to a card (preview)
+
+[!INCLUDE[cards_preview_notice](../../includes/preview-include.md)]
+
+Cards can have multiple screens, each presenting a different interface for a specific scenario or purpose. For example, a polling card might have a screen to collect user responses and a screen to show the current aggregated poll results. Use buttons to let users switch between screens or use Power Fx formulas for more complex scenarios. Insert, modify, and remove them in the [card designer](../designer-overview.md).
+
+## Prerequisites
+
+- A [Power Apps](https://powerapps.microsoft.com/) account
+- [A card](../../tutorials/hello-world-card.md)
+
+## Tree view
+
+View the screens in your card and the controls you've added to them using the card designer tree view.
+
+   :::image type="content" source="../../media/make-a-card/cards-tree-view.png" alt-text="Screenshot of the tree view in the card designer, showing a card named HelloWorldCard with two screens.":::
+
+## Create a screen
+
+1. Sign in to [Power Apps](https://powerapps.microsoft.com/). Select **Cards (preview)** > **Cards**, and then select a card.
+1. In the left pane of the card designer, select **Tree View**.
+1. Select **+ New screen**.
+1. Enter a name for your screen and select **Create**. Spaces and special characters aren't allowed in screen names.
+1. Add controls, data, and variables to the screen as needed.
+
+## Use a Show Screen button to open a screen
+
+1. In the left pane of the card designer, select **Insert**.
+1. Select **Input** to expand the category, and then select **Button** to add a button to your card.
+1. In the button properties pane, set **Type** to **Show Screen**.
+1. Set **Screen** to the screen you want the button to show, and then set **Title** to the label to display on the button.
+
+This will show a screen directly underneath the existing screen with both being interactive.
+
+   :::image type="content" source="../../media/make-a-card/show-card-properties.png" alt-text="Screenshot of a Show Screen button properties pane in the card designer.":::
+
+## Use a Power Fx expression to open a screen
+
+The Power Fx [Back](/power-platform/power-fx/reference/function-navigate#back) and [Navigate](/power-platform/power-fx/reference/function-navigate#navigate) functions switch between screens.
+
+The Show Screen button opens a screen underneath the existing screen, keeping both screens visible, while the Power Fx Back and Navigate functions change the screen that is visible to the user. The Back and Navigate functions can also be used outside of buttons and are appropriate for more complex screen-switching scenarios.
+
+For more information about Back and Navigate, see the [Power Fx reference documentation syntax](/power-platform/power-fx/reference/function-navigate#syntax), [examples](/power-platform/power-fx/reference/function-navigate#examples), and [step-by-step instructions](/power-platform/power-fx/reference/function-navigate#step-by-step).