Merge pull request #9223 from MicrosoftDocs/main

pushing to live

Author: mduelae

powerapps-docs/maker/TOC.yml

@@ -460,6 +460,8 @@
             href: ./canvas-apps/use-line-pie-bar-chart.md
           - name: Add multimedia
             href: ./canvas-apps/add-images-pictures-audio-video.md
+          - name:  Use Copilot answer control (preview)
+            href: ./canvas-apps/copilot-answer-control-overview.md
           - name: "Add mixed reality controls"
             items:
             - name: Mixed reality controls
@@ -540,6 +542,8 @@
               href: ./canvas-apps/controls/modern-controls/modern-controls-badge.md
             - name: Checkbox (preview)
               href: ./canvas-apps/controls/modern-controls/modern-control-checkbox.md
+            - name: Copilot answer (preview) 
+              href: ./canvas-apps/controls/modern-controls/modern-control-copilot-answer.md
             - name: Date picker (preview)
               href: ./canvas-apps/controls/modern-controls/modern-controls-date-picker.md
             - name: Dropdown (preview)

powerapps-docs/maker/canvas-apps/connections/connection-azure-sqldatabase.md

@@ -47,37 +47,41 @@ You can directly call SQL Server stored procedures from Power Fx by turning on t
 
 1. Go to **Settings** > **Upcoming features** > **Preview**.
 1. Search for _stored procedures_.
-1. Turn on the preview switch as shown.
+1. Turn on the preview switch as shown.  (You will need to save and reopen the app.)
 
 :::image type="content" source="media/connection-azure-sqldatabase/previewflag-call-sp-direct.png" alt-text="Screenshot that shows the SQL Server stored procedures toggle set to On.":::
 
-When you add a SQL Server connection to your app, you can now add tables and views or stored procedures.
+When you add a SQL Server connection to your app, you can now add tables and views or stored procedures. This feature also works with secure implicit connections.
 
 :::image type="content" source="media/connection-azure-sqldatabase/tables-views-stored-proc-selector.png" alt-text="Screenshot that shows lists of tables, views, and stored procedures available to be added to your app.":::
 
 If you don't immediately see your stored procedure, it's faster to search for it.
 
 Once you select a stored procedure, a child node appears and you can designate the stored procedure as **Safe to use for galleries and tables**. If you check this option, you can assign your stored procedure as an **Items** property for galleries for tables to use in your app.
 
-Enable this option only if:
+Enable this option **only if**:
 
-1. There are no side effects to calling this procedure on demand, multiple times, whenever Power Apps refreshes the control. When used with an **Items** property of a gallery or table, Power Apps calls the stored procedure whenever the system determines a refresh is needed. You can't control when the stored procedure is called.
-2. The stored procedure returns less than the delegable limit (500/2000) of records. When a table or view is assigned to an **Items** property, Power Apps can control the paging and bring in 100 records at a time, when it needs it. Stored procedures are different and might be pageable through an argument to the stored procedure. But Power Apps can't bring in pages automatically like it can for tables and views. The author must configure pageability.
+1. There are **no side effects** to calling this procedure on demand, multiple times, whenever Power Apps refreshes the control. When used with an **Items** property of a gallery or table, Power Apps calls the stored procedure whenever the system determines a refresh is needed. You can't control when the stored procedure is called.
+2. The amount of data you return in the stored procedure is **modest**. Action calls, such as stored procedures, do not have a limit on the number of rows retrieved. They are not automatically paged in 100 record increments like tabular data sources (tables or views.) So, if the stored procedure returns a lot of data (many thousands of records) then your app may slow down or crash. For performance reasons you should bring in less than 2000 records.
 
 ### Example
 
 When you add a stored procedure, you might see more than one data source in your project.
 
 :::image type="content" source="media/connection-azure-sqldatabase/sqlserver-datasources.png" alt-text="Screenshot that shows SQL data sources.":::
 
-Prefix the stored procedure name with the name of connector associated with it. For example, _DataCardValue3_1.Text_ is from the _DataCard_ connector.
+To use a stored procedure in Power Apps, first prefix the stored procedure name with the name of connector associated with it and the name the stored procedure. 'Paruntimedb.dbonewlibrarybook' in the example illustrates this pattern. Note also that when Power Apps brings the stored procedure in, it concatenates the full name. So, 'dbo.newlibrarybook' becomes 'dbonewlibrarybook'.  
 
-Label the values, for example using a number, as necessary since you're reading from a text value in Power Apps.
+Remember to convert values appropriately as you pass them into your stored procedure as necessary since you're reading from a text value in Power Apps. For example, if you are updating an integer in SQL you must convert the text in the field using 'Value()'.
 
 ![Calling stored procedures directly.](media/connection-azure-sqldatabase/calling-sp-directly.png "Calling stored procedures directly.")
 
 > [!TIP]
-> To use a stored procedure in an **Item** property for a gallery or table, use the stored procedure name where you'd use the table name.
+> To use a stored procedure in an **Item** property for a gallery or table, use the stored procedure name where you'd use the table name. Views do not have primary keys so you will need to supply a key value for record specific operations. You can access the stored procedure after you declare it safe for the UI. Reference the data source name and the the name of the stored procedure followed by 'ResultSets'. You can access multiple results by indexing through list of tables returned.
+>
+```powerapps-dot
+Paruntimedb.dbospshowalllibrarybooks().ResultSets.Table1
+```
 
 ## Known issues
 

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

@@ -0,0 +1,54 @@
+---
+title: Copilot answer modern control in Power Apps
+description: Learn about the details, properties, and examples of the Copilot answer modern control in Power Apps.
+author: yogeshgupta698
+
+ms.topic: reference
+ms.component: canvas
+ms.date: 2/14/2024
+ms.subservice: canvas-maker
+ms.author: yogupt
+ms.reviewer: mkaur
+search.audienceType: 
+  - maker
+contributors:
+  - mduelae
+  - yogeshgupta698
+  
+---
+# Copilot answer modern control in Power Apps (preview)
+
+[This article is pre-release document and is subject to change.]
+
+A control that makers can use to add predefined questions that end users can use to get generated answers.
+
+## Description
+
+Makers can use the Copilot answer control to set predefined questions that end users can use to get generative answers with a single click. The control is optimized for mobile users and is powered by Microsoft Copilot.
+
+## Key properties
+
+**Data source (Items)** – The Copilot answer control only supports Dataverse as the data source. The answer to the question comes from the Dataverse table that you select.
+
+**Views** – A user can select any of the views that are available in the data source.  
+
+**Fields** - Default list of fields available for the table. Users can select **Edit** to see the list of fields. They can also add or modify the fields based on their requirements.  
+
+**Title** – A label that is displayed at the top of the Copilot answer control.  
+
+**Question for Copilot** – This is the question a maker asks the Copilot answer control. The question is used as the prompt to generate a response that is displayed by the answer control that's based on the selected **Data source** property.
+
+
+## Additional properties
+
+**Show answer** – Should the Copilot answer control answer a question when the user clicks on the ‘Arrow’ icon (After sending) or as soon as the control loads when the question is defined in the properties window (Immediate).
+
+**DisplayMode** – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).
+
+**Position** - Whether a control appears or is hidden.
+
+**[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).
+
+**[Size](../properties-text.md)** – The size of the control on the canvas

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

@@ -31,6 +31,8 @@ Configure the behavior of a modern control by setting one of its properties. Eac
 
 **[Checkbox](modern-control-checkbox.md)** - Select or clear an option to specify **true** or **false**.
 
+**[Copilot answer (preview)](modern-control-copilot-answer.md)** - A control that makers can use to add predefined questions that end users can use to get generated answers.
+
 **[Date picker](modern-controls-date-picker.md)** - A control that the user can select to specify a date.
 
 **[Dropdown](modern-control-dropdown.md)** – Select a value from the list of items.

powerapps-docs/maker/canvas-apps/copilot-answer-control-overview.md

@@ -0,0 +1,70 @@
+---
+title: Overivew of Copilot answer control for canvas apps
+description: Use the Copilot answer control for canvas app.
+author: mduelae
+ms.topic: conceptual
+ms.custom: canvas
+ms.collection: 
+    - bap-ai-copilot
+    - get started
+ms.reviewer: mkaur
+ms.date: 2/13/2024
+ms.subservice: canvas-maker
+ms.author: arijitba
+search.audienceType: 
+  - maker
+contributors:
+  - mduelae
+---
+
+#  Use Copilot answer control for canvas apps (preview)
+
+[This article is prerelease documentation and is subject to change.]
+
+Makers can use the Copilot answer control to set predefined questions that end users can use to get AI-generated information with a single click. The control is powered by Microsoft Copilot and is designed for mobile users to provide them with immediate answers to frequently asked questions.
+
+:::image type="content" source="media/answer-control/answer-control-shown-on-mobile.png" alt-text="Answers shown on mobile":::
+
+## Enable Copilot answer control for your environment
+
+To use the Copilot answer control in a canvas app, an admin must first turn on the feature, **Allow canvas editors to insert the Copilot answer component, which allows users to receive an AI-powered answer to a predefined data query** in their environment. 
+
+This setting can be found in the [Power Platform admin center](https://admin.powerplatform.microsoft.com) by going to **Environments** > [select an environment] > **Settings** > **Product** > **Features**. For more information, see [Manage feature settings](/power-platform/admin/settings-features#copilot-preview).
+
+:::image type="content" source="media/answer-control/answer-control-enable-by-admin.jpg" alt-text="Turn on Copilot answer control on Power Platform admin center":::
+
+## Add Copilot answer control
+
+With your [canvas app open for editing](edit-app.md) in Power Apps Studio:
+
+1. On the command bar, select **Insert** and then select one of the following options:
+   
+    - **Modern** > **Copilot answer (preview)**
+    - **Classic** > **Copilot answer (preview)**
+      
+    :::image type="content" source="media/answer-control/answer-control-insert.png" alt-text="Insert answer control":::
+
+1. When the **Copilot answer (preview)** control is added to the canvas app, select a data source from the pane. Copilot only supports Dataverse tables.
+
+   :::image type="content" source="media/answer-control/answer-control-select-data-type.png" alt-text="Select data source":::
+
+1. On the control properties pane, select the **Properties** tab.
+
+1. In the properties, enter the **Title**, **Questions for Copilot**, and **Show answer** for the question. You can also edit other control properties as needed.
+
+   :::image type="content" source="media/answer-control/answer-control-properties.png" alt-text="Answer control properties":::
+
+1. When you're done, [save and publish](save-publish-app.md) your app.
+
+## Use Copilot answer control
+
+End users can regenerate responses and provide feedback on the quality of responses.
+
+Follow these steps to see answers generated by the Copilot answer control:
+
+1. Open a canvas app on Power Apps mobile and navigate to the Copilot answer control in your app.
+1. On the Copilot answer control select, **Send**.
+
+    :::image type="content" source="media/answer-control/answer-control-send.png" alt-text="Use Copilot answer control on mobile":::
+
+

powerapps-docs/maker/canvas-apps/gateway-reference.md

@@ -43,6 +43,9 @@ There are four main steps for using a gateway.
 3. [Add gateway admins](/data-integration/gateway/service-gateway-manage) who can also manage and administer other network requirements.
 4. [Troubleshoot](/data-integration/gateway/service-gateway-tshoot) the gateway in case of errors.
 
+## End user accessing via a gateway
+An end user will use the credentials for the gateway that the Power Apps author used to create the gateway. End users will see a connection in the consent dialog but it will be with the credentials provided by the Power Apps author. 
+
 ## Next steps
 
 - [Install the on-premises data gateway](/data-integration/gateway/service-gateway-install)