Skip to content

Commit 78f033d

Browse files
committed
Merge branch 'main' into adrianorth-patch-4
2 parents 35af3ea + c56506f commit 78f033d

40 files changed

+655
-303
lines changed

.openpublishing.build.ps1

Lines changed: 0 additions & 17 deletions
This file was deleted.

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9211,6 +9211,11 @@
92119211
"redirect_document_id": "false"
92129212
},
92139213
{
9214+
"source_path": "powerapps-docs/maker/canvas-apps/connections/connection-azure-sqldatabase.md",
9215+
"redirect_url": "/power-apps/maker/canvas-apps/connections/sql-connection-overview",
9216+
"redirect_document_id": "false"
9217+
},
9218+
{
92149219
"source_path": "powerapps-docs/learning-catalog/administrator.md",
92159220
"redirect_url": "/training/browse/?expanded=power-platform&products=power-apps",
92169221
"redirect_document_id": "false"

powerapps-docs/maker/TOC.yml

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -354,10 +354,14 @@
354354
href: canvas-apps/connections/connection-sharepoint-online.md
355355
- name: SQL Server
356356
items:
357-
- name: Connect to SQL Server from Power Apps
358-
href: canvas-apps/connections/connection-azure-sqldatabase.md
359-
- name: Use SQL Server securely with Power Apps
357+
- name: Connect to SQL Server overview
358+
href: canvas-apps/connections/sql-connection-overview.md
359+
- name: Connect to SQL Server securely
360360
href: canvas-apps/connections/sql-server-security.md
361+
- name: Access data
362+
href: canvas-apps/connections/sql-connection-access-data.md
363+
- name: View results
364+
href: canvas-apps/connections/sql-connection-view-results.md
361365
- name: Twitter
362366
href: canvas-apps/connections/connection-twitter.md
363367
- name: Add a connection
@@ -673,9 +677,7 @@
673677
- name: Change screen size and orientation
674678
href: ./canvas-apps/set-aspect-ratio-portrait-landscape.md
675679
- name: Create responsive layout
676-
href: ./canvas-apps/create-responsive-layout.md
677-
- name: Understand app functionality through code view (preview)
678-
href: ./canvas-apps/code-view.md
680+
href: ./canvas-apps/create-responsive-layout.md
679681
- name: Configure app functionality
680682
items:
681683
- name: Get started with formulas
@@ -1144,7 +1146,7 @@
11441146
href: ./canvas-apps/accessibility-checker.md
11451147
- name: Accessibility limitations
11461148
href: ./canvas-apps/accessible-apps-limitations.md
1147-
- name: Send notifications from an app
1149+
- name: Send notifications from an app
11481150
href: ./canvas-apps/add-notifications.md
11491151
- name: Disconnect Git version control to edit canvas apps
11501152
href: ./canvas-apps/git-version-control.md
@@ -1298,6 +1300,14 @@
12981300
href: ./common/wrap/faq.yml
12991301
- name: For developers
13001302
items:
1303+
- name: Working with Source Code
1304+
items:
1305+
- name: Code View (preview)
1306+
href: ./canvas-apps/code-view.md
1307+
- name: View source code files for canvas apps (preview)
1308+
href: ./canvas-apps/power-apps-yaml.md
1309+
- name: Use Git version control to edit canvas apps (experimental)
1310+
href: ./canvas-apps/git-version-control.md
13011311
- name: Canvas apps for enterprise developers, partners, and ISVs
13021312
href: ./canvas-apps/dev-enterprise-intro.md
13031313
- name: Build and certify custom connectors

powerapps-docs/maker/canvas-apps/add-data-connection.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Your [next step](#next-steps) after this article is to display and manage data f
3838
1. To create a new connection, search for or select a connector such as SharePoint.
3939
1. Select **Add a connection** to both create the connection and add it to your app.
4040

41-
Some connectors, such as **Office 365 Outlook**, require no additional steps, and you can show data from them immediately. Other connectors prompt you to provide credentials, specify a particular set of data, or perform other steps. For example, [SharePoint](connections/connection-sharepoint-online.md) and [SQL Server](connections/connection-azure-sqldatabase.md) require additional information before you can use them. With [Dataverse](connections/connection-common-data-service.md), you can change the environment before you select a table.
41+
Some connectors, such as **Office 365 Outlook**, require no additional steps, and you can show data from them immediately. Other connectors prompt you to provide credentials, specify a particular set of data, or perform other steps. For example, [SharePoint](connections/connection-sharepoint-online.md) and [SQL Server](connections/sql-connection-overview.md) require additional information before you can use them. With [Dataverse](connections/connection-common-data-service.md), you can change the environment before you select a table.
4242

4343
## Identify or change a data source
4444
If you're updating an app, you might need to identify or change the source of data that appears in a gallery, a form, or another control. For example, you might need to identify a data source as you update an app that someone else created or that you created long ago.

powerapps-docs/maker/canvas-apps/add-manage-connections.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ In addition to creating and managing connections in [powerapps.com](https://make
7272
For example, these connectors require additional information before you can use them.
7373

7474
* [SharePoint](connections/connection-sharepoint-online.md)
75-
* [SQL Server](connections/connection-azure-sqldatabase.md)
75+
* [SQL Server](connections/sql-connection-overview.md)
7676

7777
The new connector appears under **Connections**, and you can [add it to an app](add-data-connection.md).
7878

powerapps-docs/maker/canvas-apps/ai-formulas-formulabar.md

Lines changed: 46 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Use Copilot to create and edit Power Fx formulas in Power Apps
33
description: Learn how to use Copilot, an AI feature in Power Apps, to create and edit Power Fx formulas in the formula bar from natural language or code comments.
44
author: warrenbryant-msft
55
ms.author: warrenbryant
6-
ms.date: 10/21/2024
6+
ms.date: 11/6/2024
77
ms.topic: conceptual
88
ms.reviewer: mkaur
99
ms.subservice: canvas-maker
@@ -25,6 +25,7 @@ ms.custom:
2525

2626
Copilot is an AI feature in Power Apps Studio that helps you create and modify Power Fx formulas quickly. You can use Copilot in the formula bar to explain Power Fx formulas in natural language or generate Power Fx formulas from natural language or code comments.
2727

28+
2829
## Prerequisites
2930

3031
Copilot must be enabled for your environment and tenant. For more information, see [Enable or disable Copilot (preview) in Power Apps](ai-overview.md#disable-copilot-in-power-apps).
@@ -42,17 +43,17 @@ Use Copilot in the formula bar to understand what a formula is doing in plain la
4243

4344
1. Select a control and its corresponding property.
4445

45-
1. On the formula bar, select the **Copilot functionality menu** > **Explain this formula**.
46+
1. On the formula bar, select the **Copilot functionality menu** > **Explain this formula**, or select a subset of a formula and then select the **Copilot functionality menu** > **Explain this Selection** to explain only that part.
4647

47-
:::image type="content" source="media/copilot/ufb-explain-copilot.png" alt-text="Screenshot of the Copilot functionality menu showing the Explain this formula item.":::
48+
:::image type="content" source="media/copilot/ufb-copilot-dropdown.png" alt-text="Screenshot of the Copilot functionality menu showing the Explain this formula item.":::
4849

49-
Copilot provides an explanation of the formula that you can copy and insert as a code comment or share with other makers who are working on the same app.
50+
Copilot provides an explanation of the formula that you can copy and insert as a code comment or share with other makers who are working on the same app. When explaining a selection, Copilot may also provide additional context if it is important for the explanation.
5051

5152
:::image type="content" source="media/copilot/ufb-explanation-copilot.png" alt-text="Screenshot of Copilot's explanation of a formula.":::
5253

5354
### Known limitations of explaining formulas
5455

55-
- The maximum length of a formula explanation is 5,000 characters.
56+
- The maximum length for a formula explanation is 5,000 characters. If the formula exceeds this limit, use a partial explanation to ensure it works.
5657
- Copilot only recognizes default properties in Power Apps.
5758
- Copilot doesn't recognize user-defined functions.
5859

@@ -84,13 +85,51 @@ You can keep the comments used for generating Power Fx formulas in the formula b
8485
8586
### Known limitations of generating formulas from code comments
8687

88+
- Copilot works on that singular control and property, and it won't make changes to other controls or properties to achieve the desired outcome.
89+
- Copilot doesn't take existing formula text into account.
8790
- Copilot only recognizes default properties in Power Apps.
8891
- Copilot doesn't recognize user-defined functions.
8992
- Code comments only work with general Power Fx functions, and not Power Apps-specific functions such as `Navigate()`.
9093
- The advanced panel doesn't trigger suggestions.
9194
- Existing formulas for the property aren't included in the suggestion.
9295

9396

97+
## Create a formula (preview)
98+
99+
[This section is prerelease documentation and is subject to change.]
100+
101+
From the Copilot button in the formula bar, you can now generate a formula from natural language from a discrete request.
102+
103+
### Prerequisites
104+
105+
Before you can use Copilot to create a formula from a discrete request in your canvas app, you need to turn on **Copilot for formula** in the app settings in [Power Apps](https://make.powerapps.com/).
106+
107+
1. Open your [canvas app for editing](edit-app.md) in Power Apps Studio. On the command bar, select **Settings** > **Updates**.
108+
1. On the **Preview** tab, find and turn on the **Copilot for formulas** setting.
109+
110+
### Use Copilot to create a formula from a discrete request
111+
112+
1. Select a control and its corresponding property.
113+
114+
1. On the formula bar, select the **Copilot functionality menu** > **Create a formula**.
115+
116+
:::image type="content" source="media/copilot/ufb-copilot-dropdown.png" alt-text="Screenshot of the Copilot functionality menu showing the Create a formula item.":::
117+
118+
The Copilot menu opens inline when the formula bar is expanded, or below the formula bar if it's collapsed.
119+
120+
1. In the Copilot text box, type your request, such as *show today's day of the week*.
121+
122+
:::image type="content" source="media/copilot/ufb-create-input.png" alt-text="Screenshot of the Ceate a Formula functionality showing a sample input.":::
123+
124+
1. Copilot will attempt to create a formula. Select **Accept** to insert the formula in the same position as the Copilot interface, or update and resumbit your request.
125+
126+
:::image type="content" source="media/copilot/ufb-create-formula.png" alt-text="Screenshot of the Ceate a Formula functionality showing recommended formula.":::
127+
128+
> [!NOTE]
129+
> The same limitations apply for creating a formulas from a discrete request as [generating formulas from code comments](ai-formulas-formulabar.md#known-limitations-of-generating-formulas-from-code-comments).
130+
131+
132+
94133
## Responsible AI
95134

96135
Understand the choices you have when working with AI. Learn more in [FAQ about using AI responsibly in Power Apps](../common/responsible-ai-overview.md). Review the [Power Fx Copilot FAQ](../common/faqs-copilot-powerfx.md) for questions about this feature specifically.
@@ -101,7 +140,7 @@ The following table lists the languages available for the formula bar copilot fe
101140

102141
| **Name** | **Language Code** | **Functionality Supported** |
103142
|----------|-------------------|-----------------------------|
104-
| English | en-US | Explain a formula, Comment generated formulas |
143+
| English | en-US | Explain a formula, Comment generated formulas, Create a formula|
105144
| Chinese (simplified) - China | zh-Hans | Explain a formula, Comment generated formulas |
106145
| Czech - Czech Republic | cs-CZ | Explain a formula, Comment generated formulas |
107146
| Danish - Denmark | da-DK | Explain a formula, Comment generated formulas |
@@ -121,3 +160,4 @@ The following table lists the languages available for the formula bar copilot fe
121160
| Swedish - Sweden | sv-SE | Explain a formula, Comment generated formulas |
122161
| Thai - Thailand | th-TH | Explain a formula, Comment generated formulas |
123162
| Turkish - Türkiye | tr-TR | Explain a formula, Comment generated formulas |
163+

powerapps-docs/maker/canvas-apps/common-performance-issue-resolutions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@ Developer tools for most browsers allow you to profile memory. It helps you visu
106106

107107
## Performance considerations for the SQL Server connector
108108

109-
You can use the [SQL Server connector](connections/connection-azure-sqldatabase.md) for Power Apps to connect to SQL Server on-premises or Azure SQL Database. This section describes common performance-related problems and resolutions for using this connector for a canvas app. More information: [Connect to SQL Server from Power Apps](connections/connection-azure-sqldatabase.md)
109+
You can use the [SQL Server connector](connections/sql-connection-overview.md) for Power Apps to connect to SQL Server on-premises or Azure SQL Database. This section describes common performance-related problems and resolutions for using this connector for a canvas app.
110110

111111
> [!NOTE]
112112
> Though this section references the SQL Server connector for performance issues and resolutions, most of the recommendations also apply to using any database type—such as MySQL or PostgreSQL—as the data source.

0 commit comments

Comments
 (0)