Skip to content

Commit ebaa298

Browse files
authored
Merge branch 'main' into matp-pub-repo-4908
2 parents 8b0cf2b + aefcba5 commit ebaa298

33 files changed

+334
-142
lines changed

powerapps-docs/limits-and-config.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: lancedMicrosoft
55
ms.topic: conceptual
66
ms.custom: canvas
77
ms.reviewer: mkaur
8-
ms.date: 09/28/2023
8+
ms.date: 11/08/2023
99
ms.subservice: canvas-maker
1010
ms.author: gregli
1111
search.audienceType:
@@ -17,6 +17,7 @@ contributors:
1717
- amchern
1818
ms.contributors:
1919
- arijitba
20+
- norliu
2021
---
2122
# System requirements, limits, and configuration values for Power Apps
2223

@@ -103,7 +104,7 @@ This list identifies all services to which Power Apps communicates and their usa
103104
| localhost | http | Power Apps Mobile|
104105
| 127.0.0.1 | http <br><br>You may need to explicitly list the port (5040 and up) for localhost/127.0.0.1.| Power Apps Mobile|
105106
| ecs.office.com | https | Retrieve feature flags for Power Apps |
106-
| augloop.office.com<br>\*.augloop.office.com | ws | Power Apps Studio Copilot |
107+
| augloop.office.com<br>\*.augloop.office.com | WSS | Power Apps Studio Copilot |
107108
| config.edge.skype.com | https | Retrieve feature flags for Power Apps (backup)|
108109
| api.powerplatform.com<br>\*.api.powerplatform.com | https | Required for Power Platform API connectivity used internally by Microsoft products, and Power Platform [programmability and extensibility](/power-platform/admin/programmability-extensibility-overview).|
109110
| *.sharepointonline.com| https | Retrieve assets for presenting the header that appears at the top of app playing experiences |

powerapps-docs/maker/TOC.yml

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -508,43 +508,45 @@
508508
href: ./canvas-apps/show-images-text-gallery-sort-filter.md
509509
- name: Use modern themes (preview)
510510
href: ./canvas-apps/controls/modern-controls/modern-theming.md
511-
- name: Modern control reference (preview)
511+
- name: Modern control reference
512512
items:
513513
- name: Overview
514514
href: ./canvas-apps/controls/modern-controls/overview-modern-controls.md
515515
- name: List of modern controls and properties
516516
href: ./canvas-apps/controls/modern-controls/modern-controls-reference.md
517517
- name: Limitations of modern controls
518518
href: ./canvas-apps/controls/modern-controls/limitations-modern-controls.md
519-
- name: Badge
520-
href: ./canvas-apps/controls/modern-controls/modern-controls-badge.md
521519
- name: Button
522520
href: ./canvas-apps/controls/modern-controls/modern-control-button.md
523-
- name: Checkbox
521+
- name: Link
522+
href: ./canvas-apps/controls/modern-controls/modern-control-link.md
523+
- name: Progress bar
524+
href: ./canvas-apps/controls/modern-controls/modern-control-progress-bar.md
525+
- name: Slider
526+
href: ./canvas-apps/controls/modern-controls/modern-control-slider.md
527+
- name: Tabs or tab list
528+
href: ./canvas-apps/controls/modern-controls/modern-control-tabs-or-tabs-list.md
529+
- name: Badge (preview)
530+
href: ./canvas-apps/controls/modern-controls/modern-controls-badge.md
531+
- name: Checkbox (preview)
524532
href: ./canvas-apps/controls/modern-controls/modern-control-checkbox.md
525-
- name: Date picker
533+
- name: Date picker (preview)
526534
href: ./canvas-apps/controls/modern-controls/modern-controls-date-picker.md
527-
- name: Dropdown
535+
- name: Dropdown (preview)
528536
href: ./canvas-apps/controls/modern-controls/modern-control-dropdown.md
529-
- name: Header
537+
- name: Header (preview)
530538
href: ./canvas-apps/controls/modern-controls/modern-controls-header.md
531-
- name: Info button
539+
- name: Info button (preview)
532540
href: ./canvas-apps/controls/modern-controls/modern-control-info-button.md
533-
- name: Link
534-
href: ./canvas-apps/controls/modern-controls/modern-control-link.md
535-
- name: Progress bar
536-
href: ./canvas-apps/controls/modern-controls/modern-control-progress-bar.md
537-
- name: Radio group
541+
- name: Radio group (preview)
538542
href: ./canvas-apps/controls/modern-controls/modern-controls-radio-group.md
539-
- name: Spinner
543+
- name: Spinner (preview)
540544
href: ./canvas-apps/controls/modern-controls/modern-control-spinner.md
541-
- name: Table
545+
- name: Table (preview)
542546
href: ./canvas-apps/controls/modern-controls/modern-control-table.md
543-
- name: Tabs or tab list
544-
href: ./canvas-apps/controls/modern-controls/modern-control-tabs-or-tabs-list.md
545-
- name: Text
547+
- name: Text (preview)
546548
href: ./canvas-apps/controls/modern-controls/modern-control-text.md
547-
- name: Text input
549+
- name: Text input (preview)
548550
href: ./canvas-apps/controls/modern-controls/modern-control-text-input.md
549551
- name: Control reference
550552
items:

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

Lines changed: 37 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Add Copilot control to a canvas app
3-
description: Add copilot AI control to your canvas app.
2+
title: Add Copilot control for canvas app users
3+
description: Add Copilot AI control for apps users to your canvas app.
44
author: mduelae
55
ms.topic: conceptual
66
ms.custom: canvas
@@ -15,88 +15,95 @@ contributors:
1515
- mduelae
1616
---
1717

18-
# Add Copilot control to a canvas app (preview)
18+
# Add Copilot Control to a canvas app (preview)
1919

2020
[This article is prerelease documentation and is subject to change.]
2121

22-
The Copilot control is a next-generation AI assistant that makers can add to their apps for end-users. This is an AI-powered experience for app users to get insights about the data in their apps through conversation in natural language. Makers can add this control to any app and choose what data it can answer questions about.
22+
The Copilot control is a next-generation AI assistant that makers can add to their canvas apps for end-users. This is an AI-powered experience for app users to get insights about the data in their apps through conversation in natural language. Makers can add this control to any canvas app and choose what data it can answer questions about.
2323

2424
> [!IMPORTANT]
2525
> - To use this capability your environment must be in the US region.
2626
> - Preview features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
2727
> - For more information, go to our [preview terms](https://go.microsoft.com/fwlink/?linkid=2189520).
28-
> - This capability is powered by [ Azure OpenAI Service](/azure/cognitive-services/openai/overview).
28+
> - This capability is powered by [Azure OpenAI Service](/azure/cognitive-services/openai/overview).
2929
> - This capability may be subject to usage limits or capacity throttling.
3030
> - Copilot control isn't supported and won't work for environments that have customer-managed key (CMK) or have lockbox.
3131
32-
## Prerequisites
32+
## Step 1 - Enable Copilot for your environment
3333

34-
- Follow the prerequisites for AI features: [AI Copilot overview (preview)](ai-overview.md).
34+
In order for end users to use the Copilot chat experience in a canvas app, an admin must first turn on the feature, **Allow users to analyze data using an AI-powered chat experience in canvas and model-driven apps (preview)** in their environment. For more information, see [Manage feature settings](/power-platform/admin/settings-features#copilot-preview).
3535

36+
> [!div class="mx-imgBorder"]
37+
> ![Set Copilot feature ON for the envrironment](media/copilot/Copilot_for_apps_users_ON.png)
3638
37-
## Enable Copilot control for your app
39+
When the feature setting is turned on, a maker can then enable **Copilot component** from the app settings in Power Apps Studio and then add the Copilot control to the app, allowing end users to use the AI-powered chat experience.
3840

39-
With your [canvas app open for editing](edit-app.md):
41+
42+
43+
## Step 2 - Enable Copilot component for a canvas app
44+
45+
Open your [canvas app open for editing](edit-app.md) in Power Apps Studio:
4046

4147
1. On the command bar, select **Settings** > **Upcoming features**.
4248
2. From the **Preview** tab, set the toggle for **Copilot component** to **On**.
4349

4450
> [!div class="mx-imgBorder"]
4551
> ![Turn on Copilot control.](media/copilot/copilot-1.png)
4652
47-
## Add the Copilot control
53+
## Step 3 - Add Copilot control to your canvas app
4854

49-
With your [canvas app open for editing](edit-app.md):
55+
Add the **Copilot (preview)** control to your canvas app enabling end users to gain insights about the data in their apps through the chat experience.
5056

51-
1. On the app authoring menu, select **Insert**.
52-
2. Expand the **Input** menu and select **Copilot (preview)** to add this control.
57+
With your [canvas app open for editing](edit-app.md) in Power Apps Studio:
58+
59+
1. On the app authoring menu, select **Insert** and select **Copilot (preview)** to add this control.
5360

5461
> [!div class="mx-imgBorder"]
5562
> ![Add the copilot control.](media/copilot/Copilot-Insert-menu.png)
5663
57-
## Choose data
58-
59-
1. When the Copilot control is added, select a data source from the pane.
64+
### Choose data for Copilot
6065

61-
> [!NOTE]
62-
> Currently, the Copilot control can only answer questions for smaller datasets. The only exception to the dataset limit is when Dataverse is selected as the data source. To configure the table and its columns for use in Copilot, see [Configure tables to use Copilot](../data-platform/table-settings-for-copilot.md).
66+
1. When the Copilot control is added to the canvas app, select a data source from the pane. Copilot can only provide data insights on a single Dataverse table when an end user asks a question.
6367

6468
> [!div class="mx-imgBorder"]
6569
> ![Select a data source.](media/copilot/copilot-3.png)
6670
6771
Or, from the control **Properties** tab, select **Data source (Items)** and choose a Dataverse table for your data source.
68-
> [!div class="mx-imgBorder"]
69-
> ![Select fields or views.](media/copilot/copilot-choose-data-properties.png)
72+
73+
> [!TIP]
74+
> You can connect any Dataverse table in your environment as a data source for Copilot, regardless of whether the table is added to your canvas app or not.
75+
76+
2. Select the specific **Fields** and/or **View** that the Copilot control answers questions for.
7077

78+
3. To configure the selected table and its columns for use in Copilot, see [Configure tables to use Copilot](../data-platform/table-settings-for-copilot.md).
7179

72-
3. Select the specific **Fields** and/or **View** that the Copilot control will answer questions for.
80+
> [!NOTE]
81+
> Copilot can only answer questions for smaller datasets in a canvas app. The only exception to the dataset limit is when a Dataverse table is selected as the data source.
7382
7483

75-
## Configure the control (optional)
84+
### Configure the Copilot control (optional)
7685

77-
In addition to choosing the data source, you can also configure the following properties:
86+
In addition to choosing the data source for Copilot, you can also configure the following Copilot properties in a canvas app:
7887

7988
- **Title**: Replaces the control's default title of **Have a question about this app? Ask Copilot**, and can be replaced with a more appropriate title that reflects the assistance that the Copilot control can provide to app users.
8089

8190
- **Introductory message**: Replaces the control's default introductory message of **Copilot can answer questions about the data in this app, and help you navigate. It's always learning from your feedback**. The current description of the Copilot control can be enhanced to provide a more specific explanation of how it benefits app users.
8291

83-
- **Data summary**: Helps Copilot control give better responses to questions from app users. We recommend a brief 2-3 lines describing what the app is and what sort of questions this Copilot control will answer. This property doesn't impact the control's UI.
92+
- **Data summary**: Helps Copilot control give better responses to questions from app users. We recommend a brief 2-3 lines that describe what the app is and which types questions the Copilot control will answer. This property doesn't impact the control's UI.
8493

85-
- **Placeholder text**: Replaces the control's default placeholder text in the text input box **Ask a question about the data in this app, or tell me what you're looking for**. We recommend for you to provide a concise message to app users, explaining what types of questions can be addressed by the Copilot control.
94+
- **Placeholder text**: Replaces the control's default placeholder text in the text input box **Ask a question about the data in this app, or tell me what you're looking for**. We recommend that you provide a concise message to app users, explaining what types of questions the Copilot control can address.
8695

8796
> [!div class="mx-imgBorder"]
8897
> ![Configure the control.](media/copilot/updated-copilot-properties.png)
8998
9099

91100
## Provide feedback
92101

93-
- To improve Copilot control, makers can submit feedback using the **Like** (thumbs up) or **Dislike** (thumbs down) button on the Copilot control properties pane. Once you select a response, enter your feedback and then select **Submit**.
94-
95-
- App users can provide feedback by selecting **Like** (thumbs up) or **Dislike** (thumbs down) button for each response that Copilot provides. Optionally, can also enter additional feedback in the text box and then select **Submit**.
102+
App users and makers can provide feedback by selecting **Like** (thumbs up) or **Dislike** (thumbs down) button for each response that Copilot provides. Optionally, app users can also enter additional feedback in the text box and then select **Submit**.
96103

97-
### Disable feedback
104+
### Disable feedback for app users
98105

99-
Admins can disable the option to provide feedback to Microsoft.
106+
Admins can disable the option for apps users to provide feedback to Microsoft from the Copilot chat experience.
100107

101108
1. Sign in to [Power Apps](https://make.powerapps.com).
102109
2. On the [left navigation pane](intro-maker-portal.md#1--left-navigation-pane), select **Tables** > **Organization**.

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

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,12 @@
22
title: Limitations of modern controls in canvas apps
33
description: Learn about limitations and known issue of modern controls in canvas apps.
44
author: yogeshgupta698
5-
65
ms.topic: reference
76
ms.custom: canvas
87
ms.reviewer: mkaur-msft
98
ms.date: 03/22/2023
109
ms.subservice: canvas-maker
1110
ms.author: yogupt
12-
13-
1411
search.audienceType:
1512
- maker
1613
contributors:
@@ -19,29 +16,24 @@ contributors:
1916
---
2017

2118
# Limitations of modern controls in canvas apps (preview)
19+
2220
[This article is pre-release document and is subject to change.]
2321

2422
In this article, learn about the general limitations of the modern controls used in canvas apps.
2523

26-
1. If you add items through an array such as PowerFx bar or advance properties. Then, you'll need to additionally select the **Value** field from the properties panel.
27-
28-
> [!div class="mx-imgBorder"]
29-
> ![List in items](media/array-list.png)
30-
31-
> [!div class="mx-imgBorder"]
32-
> ![Enable value field](media/select-value-field.png)
33-
34-
2. While updating properties of controls in property panel, some of the property value updates in format of:
24+
1. While updating properties of controls in property panel, some of the property value updates in format of:
3525

3626
`PowerApps.CoreControls.<Control name>.<Property name>` `.<Value>`
3727

38-
This is a valid format, or you can update to value only. Both approaches will work for configuration of the control.
28+
This is a valid format, or you can update to value only. Both approaches work for configuration of the control.
3929

40-
3. The property sets for new controls are different than property sets of original controls. Not all scenarios are supported on new controls. We're consistently trying to make improvements for new scenarios.
30+
2. The property sets for new controls are different than property sets of original controls. Not all scenarios are supported on new controls. We're consistently trying to make improvements for new scenarios.
4131

42-
4. The modern controls don’t have support for properties that show up in command bar. Currently we only support property value updated through the property panel.
32+
3. The modern controls don’t have support for properties that show up in command bar. Currently we only support property value updated through the property panel.
4333

44-
5. All app checker rules such as accessibility and formulas, currently don’t run on modern controls. We'll try to offer support as the feature develops.
34+
4. Not all app checker rules such as accessibility and formulas run on modern controls currently. We offer support when the feature matures.
35+
36+
5. Test Studio and Test engine compatibility with modern controls is under development and modern controls aren't fully supported on these tools.
4537

4638

4739

Loading

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

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,7 @@ contributors:
1818
- yogeshgupta698
1919

2020
---
21-
# Button modern control in Power Apps (preview)
22-
23-
[This article is pre-release document and is subject to change.]
21+
# Button modern control in Power Apps
2422

2523
A control that the user can select to interact with the app.
2624

@@ -32,20 +30,31 @@ With the modern button you can set a button to be primary or secondary. Configur
3230

3331
**[Text](../properties-core.md)** – Text that appears on a component.
3432

35-
**Base palette color** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color.
33+
**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 selected Fluent theme.
3634

37-
**Type** – Primary and Secondary. Primary emphasizes the button as a primary action. Secondary gives emphasis to the button in such a way that it indicates a secondary action.
35+
**Appearance** – A button can have its content and borders styled for greater emphasis or to be subtle. Below are the options available:
36+
* Primary: Emphasizes the button as a primary action.
37+
* Secondary: Gives emphasis to the button in such a way that it indicates a secondary action.
38+
* Outline: Removes background styling.
39+
* Subtle: Minimizes emphasis to blend into the background until hovered or focused.
40+
* Transparent: Removes background and border styling.
3841

39-
**Display mode** – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).
42+
**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.
4043

4144
## Additional properties
42-
**Accessible label** – Label for screen readers.
45+
**AccessibleLabel** – Label for screen readers.
46+
47+
**DisplayMode** – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).
48+
49+
**Visible** - Whether a control appears or is hidden.
4350

4451
**[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).
4552

4653
**[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).
4754

48-
**[Size](../properties-text.md)** – The size of the control on the canvas.
55+
**[Size](../properties-text.md)** – The size of the control on the canvas
56+
57+
4958

5059

5160

0 commit comments

Comments
 (0)