Merge branch 'main' into jdaly-main-odatav2-migrate-examples

Author: JimDaly

.openpublishing.redirection.json

@@ -1,5 +1,15 @@
 {
   "redirections": [
+    {
+      "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",

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/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,46 @@
+---
+title: Connectors overview (Preview)
+description: Learn about connectors and how you can use them to expand the capabilities of your cards.
+ms.date: 09/20/2022
+ms.topic: article
+author: iaanw
+ms.author: iawilt
+manager: shellyha
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+---
+
+# Connectors (Preview)
+
+[!INCLUDE[cards_preview_notice](../../includes/preview-include.md)]
+
+Connectors are an important part of Power Apps, allowing your card to talk to other apps, data, and devices in the cloud.
+
+For more information on Connectors in Power Platform, see [Connectors overview](/connectors/connectors).
+
+## Prerequisites
+
+- A [Power Apps](https://powerapps.microsoft.com/) account.
+- A card to add connectors to. For an example, see the [simple card tutorial](../../tutorials/hello-world-card.md).
+- Familiarity with the [Card Designer](../../make-a-card/designer-overview.md).
+
+## Access connectors in cards
+
+To access connectors in card:
+
+1. Go to [Power Apps](https://make.test.powerapps.com/) and select **Cards (preview)**.
+1. On the left, select **Cards** and select the card you want to test add a connector to.
+1. On the left, select **Data**. Then select **+ Add data**.
+
+    :::image type="content" source="../../media/connector-intro/add-data-___location.png" alt-text="Screenshot of + Add data menu" border="true":::
+
+    You'll then be able to add a data source and see all available connectors.
+
+## Types of connectors
+
+Only connections to Dataverse are currently available. You can connect to Dataverse tables for creating, reading, updating, and deleting records.
+
+Learn how to [create a card with data from Dataverse](../../tutorials/dataverse-card.md).
+
+The other connectors are available within the Card Designer, but functionality for them will be added in future updates.

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

@@ -0,0 +1,112 @@
+---
+title: Card Designer overview (Preview)
+description: Learn about the designer and how to create cards using it.
+ms.date: 09/20/2022
+ms.topic: article
+author: iaanw
+ms.author: iawilt
+manager: shellyha
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+---
+
+# Card Designer overview (Preview)
+
+[!INCLUDE[cards_preview_notice](../includes/preview-include.md)]
+
+The Card Designer is where makers and developers can build cards to suit their needs. The designer lets you optimize and automate business user tasks and create actionable scenarios in interactive and easy-to-make cards. The designer builds off of the designer for Adaptive Cards, introducing a few new concepts:
+
+- Power Fx: specify an action to trigger when an element is selected
+- Connectors: bring data into cards (currently only from Dataverse)
+- Variables: store, bind, and reuse data across a card
+- Dataverse: stores each card you create and allows you to retrieve the card at send time
+
+## Find the designer
+
+To get to the designer, take the following steps:
+
+1. Go to [Power Apps](https://make.powerapps.com) and make sure you're in the correct environment.
+
+1. Go to the pane on the left to access all of the card-related views.
+
+   1. To create a new card, select **Cards** then **Create**.
+   1. To see all current cards, select **Cards** then **Cards**
+
+      :::image type="content" source="../media/designer-overview/create-new-card.png" alt-text="Screenshot showing card creation screen." border="true":::
+
+1. Select the **+ Create a card** to start building your own card.
+
+## What's in the designer?
+
+The designer is made up of the following elements:
+
+:::image type="content" source="../media/designer-overview/designer-elements.png" alt-text="Screenshot of Card Designer with elements highlighted." border="true":::
+
+1. Main menu
+1. Tool pane
+1. Card canvas
+1. Property pane
+1. Formula bar
+1. Play button
+
+The sections below describe each of the designer elements.
+
+### Main menu
+
+The main menu lets you switch between the different tools available in the designer. In order, these are:
+
+- Tree View: see the card as a hierarchical outline and view the relationships of the card elements.
+- Insert: main UI for editing and adding card elements.
+- Data: add connectors to your card to use data from external sources.
+- Variables: store, bind, and reuse data across a card.
+
+### Tool pane
+
+When you start making your card, you'll use controls from the Tool pane. There are three categories of controls in the pane:
+
+- Display: Add text and media to cards.
+- Input: Add different types of input boxes to collect information from users.
+- Layout: Add formatting and customize your card's structure.
+
+### Card canvas
+
+The card canvas is where where you build the user interface for your card, using connectors, variables, and elements from the Tool pane.
+
+You can't resize a card in the card canvas view because cards automatically fit themselves to the ___location they're placed into.
+
+### Property pane
+
+The property pane is used to change up specific properties for an element. Each type of element has its own property pane, including the card itself. For most of the drag-and-drop elements, you'll be able to specify things like:
+
+- **Name**: the variable name associated with that element, which you can reference in a Power Fx formula
+- **Label**/**Text**: any text the user will see when they load in the card
+- **Default value**: the initial value of a field
+- **Initially visible**: choose if the element will be visible on load
+
+Certain elements have visual aspects that you can modify. For text labels and input controls, for example, you can customize font, color, spacing, and more.
+
+Each property pane also contains advanced features, which allow you to specify things like:
+
+- **Repeat for every**: provide a trigger for if/when an element should be repeated
+- **Show when**: provide a trigger to show the element
+- **Requires**: make the element dependent on certain features, corresponding with a minimum version
+
+You can also input Power Fx expressions into the properties, utilizing low-code solutions to make your card more powerful.
+
+### Power Fx editor
+
+The formula bar is at the top of the card designer and allows you to write Power Fx expressions. When you select an element on the card, the formula bar lets you select a property of that element from the dropdown that supports a code input and then assists you in writing an expression.
+
+To get started with Power Fx, see [Introduction to Power FX](../make-a-card/power-fx/intro-to-pfx.md). For more information on the specific functions you can use, see the Microsoft documentation for [Formula reference for Power Apps](/powerapps/maker/canvas-apps/formula-reference).
+
+> [!NOTE]
+> Some expressions supported in Power Apps aren't available for cards during preview.
+
+### Play button
+
+Once you've set up your card to your liking, you can preview the card with the **Play** button. This will open your card on the **Play** page in a new tab and allow you to test the card's functionalities. This is also where, if needed, you'll be able to debug and troubleshoot your card. For more information on debugging, see [Debugging cards](../make-a-card/testing/debugging-cards.md).
+
+## Next steps
+
+Now that you've got an overview of designer, [make your first card](../tutorials/hello-world-card.md).

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

@@ -0,0 +1,40 @@
+---
+title: Introduction to Power Fx (Preview)
+description: Learn about Power FX and how it's used in cards to add business logic.
+ms.date: 09/20/2022
+ms.topic: article
+author: iaanw
+ms.author: iawilt
+manager: shellyha
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+---
+
+# Introduction to Power Fx (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 cards. Cards can calculate values, perform other tasks, and respond to user input using [formulas](/power-platform/power-fx/formula-reference) expressed with Power Fx.
+
+For example, a formula might determine what happens when a user selects a button or enters text into a text input. Formulas can also be used to 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 for information about Power Fx. Makers and developers working with cards will find the following articles 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 Power Fx limitations with cards
+
+There are some known limitations with cards and Power Fx. These include:
+
+- All device sensor formulas don't work (**Acceleration**, **App**, **Compass**, **Connection**, and **Location**).
+- **SaveData**, **LoadData**, and **ClearData** don't work.
+- Form-related formulas don't work (**EditForm**, **NewForm**, **SubmitForm**, **ResetForm**, and **ViewForm**).
+- **Collect**, **Patch**, and **Remove** only work for variables and Dataverse tables.
+- **Update** and **UpdateIf** don't work.
+- **Set** requires the type of the variable to match what you are trying to set it to and requires the variable to be already created using the variable creation.

powerapps-docs/cards/make-a-card/screens/use-screens.md

@@ -0,0 +1,54 @@
+---
+title: Use screens (Preview)
+description: Learn how to build with screens.
+ms.date: 09/20/2022
+ms.topic: article
+author: iaanw
+ms.author: iawilt
+manager: shellyha
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+---
+
+# Use screens (Preview)
+
+[!INCLUDE[cards_preview_notice](../../includes/preview-include.md)]
+
+Cards can have multiple screens. Each screen can show a different user interface for specific scenarios. 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.
+
+## Tree view
+
+You can view the screens in your card and change properties of each screen using the tree view in the Card Designer.
+
+   :::image type="content" source="../../media/make-a-card/cards-tree-view.png" alt-text="Screenshot of tree view in Card Designer." border="true":::
+
+## Make a new screen
+
+1. Open the **Tree View** for your card and select **+ New screen**.
+1. Enter a name for your new screen and select **Create** to make it.
+1. Add any controls, data, and variables you want to this screen. After you've added everything you wanted, you can use buttons to call your screen from a card.
+
+## Use a button to show a screen
+
+To show screens from other cards, use the **Show Screen** button.
+
+1. Select **Insert** from the left. Then select **Input** then **Button** to create a new button.
+1. Go to **Type** in the Properties pane on the right. Select the drop-down and change the **Type** to **Show Screen**.
+1. **ShowCard** will appear on the right. Set **Screen** to the screen you want to show and set **Title** to the text to display on your button.
+
+   :::image type="content" source="../../media/make-a-card/show-card-properties.png" alt-text="Screenshot of ShowCard options." border="true":::
+
+    In the example above, this button will show the `NameScreen` screen when a user selects the button titled "Say Goodbye".
+
+    Now, the screen will appear when you test your card and select the button. The example below shows how the screen appears after adding an example button to the [simple card tutorial](../../tutorials/hello-world-card.md) card.
+
+   :::image type="content" source="../../media/make-a-card/screen-example.png" alt-text="Screenshot of an example screen in a card." border="true":::
+
+Repeat this process as many times as needed to create more screens.
+
+## Switch screens with Power Fx formulas
+
+The Power Fx [Back](/power-platform/power-fx/reference/function-navigate#back) and [Navigate](/power-platform/power-fx/reference/function-navigate#navigate) functions let you switch between screens. While **ShowScreen** just shows a screen, these functions can 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).

powerapps-docs/cards/make-a-card/testing/debugging-cards.md

@@ -0,0 +1,97 @@
+---
+title: Test and debug cards (Preview)
+description: Learn how to test and debug your cards using the Play page
+ms.date: 09/20/2022
+ms.topic: article
+author: iaanw
+ms.author: iawilt
+manager: shellyha
+ms.reviewer: 
+ms.custom: 
+ms.collection: 
+---
+
+# Test and debug cards (Preview)
+
+[!INCLUDE[cards_preview_notice](../../includes/preview-include.md)]
+
+Use the **Play** page to see how finished cards will look and act before sending them out to users. It has the tools to test your card and debug any issues.
+
+> [!NOTE]
+> Card instances and their data, which you see on the **Play** page, will only last 48 hours after being created. Select the **Play** button from the Card Designer to get a new instance of that card.
+
+## Prerequisites
+
+- A [Power Apps](https://powerapps.microsoft.com/) account.
+- A card to test. For an example, see the [simple card tutorial](../../tutorials/hello-world-card.md).
+- Familiarity with the [Card Designer](../designer-overview.md).
+
+## Access the **Play** page
+
+To access the Play page:
+
+1. Go to [Power Apps](https://make.test.powerapps.com/) and select **Cards (preview)**.
+1. On the left select **Cards** to see all of your cards. Select the card you want to test and debug.
+1. Select the **Play** button at the top of the page. A new window will appear with the Play page.
+
+   :::image type="content" source="../../media/debugging-cards/play-button-in-designer.png" alt-text="Screenshot of the **Play** button in the Card Designer" border="true":::
+
+## **Play** page components
+
+The **Play** page is made up of the following components:
+
+   :::image type="content" source="../../media/debugging-cards/play-page-elements.png" alt-text="Screenshot of the Play page elements" border="true":::
+
+1. Card title - The title of the card
+1. View mode - Switch between light and dark modes to see how cards looks in different environments.
+1. Card viewer - Interact with and view the card.
+1. Send button - Send the card in Teams with a link.
+1. Debug pane - Displays important debugging information while testing. For more information, see the [debugging](#debug-your-card) section.
+
+## Test your card
+
+Now that you're on the Play page and understand the different elements of it, you can test your card. The example used in this section is from the [simple card tutorial](../../tutorials/hello-world-card.md).
+
+Try interacting with your card. In the example below, the **Say Hello** button is used to fill a variable with the user's text input. Notice how the bot's title changes to the user input.
+
+Before interacting with the card:
+
+:::image type="content" source="../../media/debugging-cards/card-before-interaction.png" alt-text="Screenshot of the card before interacting with it" border="true":::
+
+After interacting with the card:
+
+:::image type="content" source="../../media/debugging-cards/card-after-interaction.png" alt-text="Screenshot of the card after interacting with it" border="true":::
+
+You can also change the **View** button on the **Play** page to switch between light and dark modes. The example below is the same card in dark mode:
+
+:::image type="content" source="../../media/debugging-cards/dark-mode-card.png" alt-text="Screenshot of the card in dark mode" border="true":::
+
+If you encounter issues while testing your card, use the [Debug](#debug-your-card) panel to try and fix them.
+
+## Debug your card
+
+The **Debug** panel lets you ascertain issues with your card and gives suggestions when possible for fixes.
+
+To open the **Debug** panel, select the **Debug** button on the right. There are four elements to the debug panel: **Memory**, **JSON**, **Output**, and **Info**.
+
+### Memory
+
+The **Memory** section lets you see variables stored in memory and how your card is assigning and using them.
+
+The example below shows that the user input stored in `UserAnswer` has the same value as the assigned variable `UserName` used in the card.
+
+:::image type="content" source="../../media/debugging-cards/memory-example.png" alt-text="Screenshot of the Memory section in the Debug panel" border="true":::
+
+If you're encountering issues with memory, check your variable names and any related Power Fx formulas used in your card.
+
+### JSON
+
+The **JSON** section lets you see the JSON representation of your card. This can be helpful for developers working on cards who prefer a code-first approach.
+
+### Output
+
+The **Output** sections lets you see any output from your card. This is only available for cards where output is set up already.
+
+### Info
+
+The **Info** section lets you see information about the card's **Environment ID**, **Card ID**, and **User**.