Merge branch 'main' into QueryExpression

Author: JimDaly

powerapps-docs/developer/data-platform/how-dataverse-sql-differs-from-transact-sql.md

@@ -92,7 +92,6 @@ More information: [Transact-SQL statements](/sql/t-sql/statements/statements)
   - PIVOT and UNPIVOT
   - [GROUP BY](#select-group-by)/Having
 - General
-  - IF THEN ELSE
   - DECLARE variable
 
 ### [Not supported](#tab/not-supported)
@@ -111,6 +110,7 @@ More information: [Transact-SQL statements](/sql/t-sql/statements/statements)
   - Without unique column name and alias
 - General
   - WHILE LOOP
+  - IF THEN ELSE
 
 ---
 

powerapps-docs/maker/TOC.yml

@@ -296,6 +296,8 @@
         href: ./canvas-apps/ai-conversations-create-app.md
       - name: Continue editing your app with Copilot (preview)
         href: ./canvas-apps/ai-edit-app.md
+      - name: Use field suggestions by Copilot
+        href: ./canvas-apps/ai-field-suggestions.md  
     - name: Create an app using data
       items:
       - name: From Microsoft Dataverse
@@ -520,6 +522,8 @@
               href: ./canvas-apps/controls/modern-controls/modern-control-slider.md
             - name: Tabs or tab list
               href: ./canvas-apps/controls/modern-controls/modern-control-tabs-or-tabs-list.md
+            - name: Avatar (preview)
+              href: ./canvas-apps/controls/modern-controls/modern-control-avatar.md  
             - name: Badge (preview)
               href: ./canvas-apps/controls/modern-controls/modern-controls-badge.md
             - name: Checkbox (preview)
@@ -2231,6 +2235,8 @@
         href: ./data-platform/azure-synapse-link-troubleshooting-guide.md
       - name: Receive Azure Synapse Link for Dataverse notifications
         href: ./data-platform/azure-synapse-link-notifications.md
+      - name: Transtion from legacy data generation services
+        href: ./data-platform/azure-synapse-link-transition-from-FnO.md
       - name: FAQ about Azure Synapse Link
         href: ./data-platform/export-data-lake-faq.yml
       - name: Application Lifecycle Management
@@ -2581,6 +2587,10 @@
     href: ./common/faq-timeline-highlights-with-copilot.md
   - name: FAQ about using Copilot with Power Fx
     href: ./common/faqs-copilot-powerfx.md
+  - name: FAQ about field suggestions by Copilot
+    href: ./common/faq-field-suggestions.md  
+  - name: FAQ about filtering, sorting, and searching canvas galleries with Copilot
+    href: ./common/faq-filter-with-copilot.md
 - name: Resources
   items:
   - name: Blog

powerapps-docs/maker/canvas-apps/add-ai-copilot.md

@@ -31,6 +31,8 @@ The Copilot control is a next-generation AI assistant that can be integrated in
 > - This capability is powered by [Azure OpenAI Service](/azure/cognitive-services/openai/overview).
 > - This capability  may be subject to usage limits or capacity throttling.
 > - Copilot control isn't supported and won't work for environments that have customer-managed key (CMK) or have lockbox.
+> - Your environment must be in the United States region.
+> - Your account must have English (United States) as the browser language.
 
 ## Step 1 - Enable Copilot for your environment
 

powerapps-docs/maker/canvas-apps/ai-field-suggestions.md

@@ -0,0 +1,52 @@
+---
+title: How to use field suggestions by Copilot in Power Apps Studio
+description: Use field suggestions by Copilot in Power Apps Studio.
+author: norliu
+ms.topic: conceptual
+ms.custom: canvas
+ms.collection: 
+    - bap-ai-copilot
+    - get started
+ms.reviewer: mkaur
+ms.date: 5/7/2024
+ms.subservice: canvas-maker
+ms.author: norliu
+search.audienceType: 
+  - maker
+contributors:
+  - mduelae
+  - norliu
+---
+
+# Use field suggestions by Copilot
+
+Use field suggestions by Copilot to select the best fields to display when you link a data source to a control in a canvas app. Instead of using the default fields that Power Apps selects, makers can view up to 10 suggestions from Copilot. The field suggestions are based on the data schema and the context of the app. An app maker can review the suggestions and make adjustments as needed, saving time and improving the quality of the app.
+
+## Prerequisites
+
+- Prerequisites for Copilot in Power Apps features: [Copilot in Power Apps overview (preview)](ai-overview.md)
+- See if this feature is available in your region: [Product availability report](https://releaseplans.microsoft.com/en-US/availability-reports/?report=productgeoreport)
+- Learn how to turn on Copilots in your region: [Turn on copilots and generative AI features](/power-platform/admin/geographical-availability-copilot)
+
+## Use field suggestions
+
+Field suggestions by Copilot work when you bind a data source to one of the following controls: 
+
+- Gallery
+- Form (modern)
+- Table (modern)
+- Edit form (classic)
+- Display  form (classic)
+- Data table (classic)
+
+Supported data sources:
+
+- Dataverse
+- Structured query language (SQL)
+- SharePoint list
+
+When you select a data source for a control, Copilot analyzes the data schema and recommends up to 10 fields that are relevant and meaningful for your app. If you have more than 10 required fields, Copilot merges the AI suggestions together with the required fields so you don't get an error when you submit a form. You can view the suggestions in the **Fields** pane and preview how it looks in your app. You can also adjust the orders, remove fields, and add more fields from the data source. When you're done, apply the changes and view the results in your app.
+
+
+## See also
+- [FAQs for field suggestions by Copilot](../common/faq-field-suggestions.md)

powerapps-docs/maker/canvas-apps/ai-overview.md

@@ -5,7 +5,7 @@ author: mduelae
 ms.topic: conceptual
 ms.custom: canvas
 ms.reviewer: 
-ms.date: 05/3/2024
+ms.date: 05/15/2024
 ms.subservice: canvas-maker
 ms.author: tapanm
 search.audienceType: 
@@ -33,6 +33,7 @@ Learn how to use Copilot features in Power Apps.
 - [Add Copilot control to a canvas app (preview)](add-ai-copilot.md)
 - [Leverage Azure OpenAI Service in AI Builder (preview)](/ai-builder/prebuilt-azure-openai)
 - [Create Power Fx formulas with Copilot](ai-formulas-formulabar.md)
+- [Use field suggestions by Copilot](ai-field-suggestions.md)
 
 **Model-driven apps**
 

powerapps-docs/maker/canvas-apps/controls/modern-controls/modern-control-avatar.md

@@ -0,0 +1,90 @@
+---
+title: Avatar modern control in Power Apps
+description: Learn about the details, properties, and examples of the avatar modern control in Power Apps.
+author: jasongre
+
+ms.topic: reference
+ms.component: canvas
+ms.date: 05/20/2023
+ms.subservice: canvas-maker
+ms.author: jasongre
+
+
+ms.reviewer: mkaur
+search.audienceType: 
+  - maker
+contributors:
+  - jasongre
+     
+---
+# Avatar modern control in Power Apps (preview)
+
+[This article is prerelease documentation and is subject to change.]
+
+A control that shows a graphic representation of a user, team, or entity.  
+
+## Description
+
+Use the avatar control to visually represent a user, team, or entity. This control supports both image and initials formats and allows a small badge to be included to help convey status. The key properties for this control are **Name** and **Image**.  
+
+## General
+
+**Name** - The name of the person or entity. Name is used to determine the initials displayed when there's no image and is also used for accessibility. 
+
+**Image** – The visual representation for the person or entity.
+
+**Badge** – A small visual decoration added to convey status of the person or entity. 
+
+**Visible** - Whether a control appears or is hidden.
+
+## Size and position 
+
+**[X](../properties-size-___location.md)** – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).
+
+**[Y](../properties-size-___location.md)** – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).
+
+**Width** - The distance between a control's left and right edges. 
+
+**Height** - The distance between a control's top and bottom edges. 
+
+## Style and theme
+
+**Shape** - Whether the avatar appears with a circular or square shape. 
+
+**Appearance** – An avatar can have portions of itself styled for greater emphasis or to be subtle. 
+
+The following options are available:
+
+- **Brand**: Uses the modern theme to style the avatar. The Color palette property can be used to override this color scheme. 
+- **Neutral**: Uses a grayscale for the initials background to provide a subtle appearance.
+- **Colorful**: Users a color from a predefined set of colors, based on a hash of the provided Name. 
+
+**BasePaletteColor** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color. If the value is null or zero, then the color is driven by the selected Fluent theme.
+
+**Font** - The name of the family of fonts in which text appears.
+
+**FontSize** - The font size of the text that appears on a control. If the value is null or zero, then the font size is driven by selected Fluent theme.
+
+**FontColor** - The color of text in a control. 
+
+**FontWeight** - The weight of the text in a control: **Bold**, **Lighter**, **Normal**, or **Semibold**. 
+
+**FontItalic** - Whether the text in a control is italic. 
+
+**FontUnderline** - Whether a line appears under the text that appears on a control. 
+
+**FontStrikethrough** - Whether a line appears through the text that appears on a control. 
+
+## Additional properties
+
+**Out of office** - Adjusts the Badge icon to show its corresponding "out of office" variant.  
+
+
+
+
+
+
+
+
+
+

powerapps-docs/maker/canvas-apps/controls/modern-controls/modern-controls-reference.md

@@ -6,7 +6,7 @@ author: yogeshgupta698
 ms.topic: reference
 ms.custom: canvas
 ms.reviewer: mkaur-msft
-ms.date: 03/22/2023
+ms.date: 05/22/2024
 ms.subservice: canvas-maker
 ms.author: yogupt
 search.audienceType:
@@ -25,6 +25,8 @@ Configure the behavior of a modern control by setting one of its properties. Eac
 
 ## Modern controls
 
+**[Avatar (preview)](modern-control-avatar.md)** – A control that shows a graphic representation of a user, team, or entity.
+
 **[Badge (preview)](modern-controls-badge.md)** – A badge is a visual decoration for UI elements.
 
 **[Button](modern-control-button.md)** – Interact with the app by clicking or tapping.

powerapps-docs/maker/canvas-apps/controls/modern-controls/modern-theming.md

@@ -44,6 +44,7 @@ There's several out-of-the-box themes available to style your app. You can also
     -  **Theme name**: The theme name must be unique.
     -  **Font**: Choose the default font that the controls in the app use will use when the theme is applied.
     -  **Seed color**: Select the color you want to base your theme on, or manually enter the Hex or RGB representation of the color. The system generates a 16-slot palette that is optimized for accessibility.
+    -  **Hue/Vibrancy**: Adjust the generation palette, especially the lighter colors, with the **Hue** and **Vibrancy** sliders. The **Hue** impacts the color shade, and **vibrancy** impacts the muteness or brightness of the palette.  
 4. Optionally, look at the static preview of your new theme. You can interact with the sample controls to see how your theme is applied to the rest state and various interaction states.    
 5. Select **Create**.
 

powerapps-docs/maker/canvas-apps/share-app.md

@@ -17,7 +17,7 @@ contributors:
 ---
 # Share a canvas app with your organization
 
-After you build a canvas app that addresses a business need, specify which users in your organization can run the app and who can modify and even re-share it. Specify each user by name, or specify a security group in Microsoft Entra ID. If everyone would benefit from your app, specify that your entire organization can run it.
+After you build a canvas app that addresses a business need, specify which users in your organization can run the app and who can modify and even re-share it. Specify each user by name, or specify a security group in Microsoft Entra ID.
 
 > [!IMPORTANT]
 > For a shared app to function as you expect, you must also manage permissions for the data source or sources on which the app is based, such as [Microsoft Dataverse](#dataverse) or [Excel](share-app-data.md). You might also need to share [other resources](share-app-resources.md) on which the app depends, such as flows, gateways, or connections.
@@ -54,10 +54,6 @@ Before you share an app, you must [save it](save-publish-app.md) (not locally) a
 
 1. Specify by name or alias the users or security groups in Microsoft Entra ID with whom you want to share the app.
 
-    - To allow your entire organization to run the app (but not modify or share it), enter **Everyone** in the sharing panel. Users will be able to find this app by setting the apps list filter to "Org apps".
-
-        ![Share with everyone.](./media/share-app/everyone.png "Share with everyone")
-
     - You can share an app with a list of aliases, friendly names, or a combination of those (for example, **Meghan Holmes <[email protected]>**) if the items are separated by semicolons. If several people have the same name but different aliases, the first person found will be added to the list. A tooltip appears if a name or alias already has permission or can't be resolved.
 
         ![Share with an individual user.](./media/share-app/individual-user.png "Share with an individual user")

powerapps-docs/maker/common/faq-draft-with-copilot.md

@@ -1,7 +1,7 @@
 ---
-title: FAQs about drafting well-written input text with Copilot
-description: These FAQs provide information about the AI technology used to draft well-written input text with Copilot, along with key considerations and details about how AI is used, how it was tested and evaluated, and any specific limitations.
-ms.date: 12/21/2023
+title: FAQ about drafting well-written input text with Copilot
+description: This FAQ provides information about the AI technology used to draft well-written input text with Copilot, along with key considerations and details about how AI is used, how it was tested and evaluated, and any specific limitations.
+ms.date: 05/22/2024
 ms.custom: 
   - responsible-ai-faqs
 ms.topic: article
@@ -12,9 +12,9 @@ ms.collection:
     - bap-ai-copilot 
 ---
 
-# FAQs about drafting well-written input text with Copilot
+# FAQ about drafting well-written input text with Copilot
 
-These frequently asked questions (FAQs) describe the AI impact of drafting well-written input text with Copilot in Power Apps.
+These frequently asked questions (FAQ) describe the AI impact of drafting well-written input text with Copilot in Power Apps.
 
 ##  What is Draft with Copilot?