Skip to content

Commit c650569

Browse files
author
Rhana Cassidy
authored
Merge branch 'main' into rjc-preview-updates
2 parents 5bc197a + bce31ac commit c650569

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+359
-189
lines changed

powerapps-docs/developer/component-framework/react-controls-platform-libraries.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ After you build the control, you can package it inside solutions and use it for
6767

6868
## Differences from standard components
6969

70-
Thi section describes the differences between a React component and a standard component.
70+
This section describes the differences between a React component and a standard component.
7171

7272
### ControlManifest.Input.xml
7373

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Indicates that all column values for each row are returned. It is the same as not adding any [attribute elements](../attribute.md). We don't recommend using this element for most cases.
1+
Indicates that all non-null column values for each row are returned. It is the same as not adding any [attribute elements](../attribute.md). We don't recommend using this element for most cases.

powerapps-docs/developer/data-platform/fetchxml/retrieve-data.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Use FetchXml to retrieve data
33
description: Learn how to use the Dataverse SDK for .NET or Web API to send a request to retrieve data using FetchXml
4-
ms.date: 02/29/2024
4+
ms.date: 07/16/2024
55
ms.reviewer: jdaly
66
ms.topic: how-to
77
author: pnghub
@@ -61,7 +61,7 @@ static EntityCollection RetrieveMultipleRequestExample(IOrganizationService serv
6161
Pass your FetchXml query as a URL-encoded string value to the entity set collection using the `fetchXml` query parameter.
6262

6363
> [!NOTE]
64-
> Unlike queries that use the OData syntax, FetchXML queries sent using Web API don't return properties with null values.
64+
> Unlike queries that use the OData syntax, FetchXML queries sent using Web API don't return properties with null values. [Learn more about this behavior](#null-column-values-are-not-returned)
6565
6666
For example, if you want to retrieve data from the [account entity set](xref:Microsoft.Dynamics.CRM.account), you will compose a fetchXml query setting the [entity element](reference/entity.md) `name` parameter to the `account`.
6767

@@ -147,6 +147,12 @@ The length of a URL in a `GET` request [is limited to 32 KB (32,768 characters)]
147147

148148
---
149149

150+
## Null column values are not returned
151+
152+
When a table column contains a null value, or if the column wasn't requested, the record returned won't include the value. There isn't a key to access it or a value to return. The absence of the attribute indicates that it's null. This is the behavior using the SDK for .NET. [Learn more about this behavior](../org-service/entity-operations-query-data.md#null-column-values-are-not-returned)
153+
154+
Columns that are not valid for read always return null values. The definition of these columns have the [AttributeMetadata.IsValidForRead](/dotnet/api/microsoft.xrm.sdk.metadata.attributemetadata.isvalidforread) property set to false.
155+
150156
## Next steps
151157

152158
Learn how to select columns.

powerapps-docs/maker/TOC.yml

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -406,10 +406,12 @@
406406
href: ./canvas-apps/add-configure-controls.md
407407
- name: Add a screen
408408
href: ./canvas-apps/add-screen-context-variables.md
409-
- name: Add a chatbot (preview)
409+
- name: Add a Chatbot control (preview)
410410
href: ./canvas-apps/add-ai-chatbot.md
411-
- name: Add a copilot (preview)
411+
- name: Add a Copilot control (preview)
412412
href: ./canvas-apps/add-ai-copilot.md
413+
- name: Add a custom Copilot (preview)
414+
href: ./canvas-apps/add-custom-copilot.md
413415
- name: Create and edit tables
414416
href: ./canvas-apps/create-edit-tables.md
415417
- name: Work with a gallery
@@ -510,24 +512,30 @@
510512
href: ./canvas-apps/controls/modern-controls/modern-controls-reference.md
511513
- name: Limitations of modern controls
512514
href: ./canvas-apps/controls/modern-controls/limitations-modern-controls.md
515+
- name: Badge
516+
href: ./canvas-apps/controls/modern-controls/modern-controls-badge.md
513517
- name: Button
514518
href: ./canvas-apps/controls/modern-controls/modern-control-button.md
515-
- name: Combobox
516-
href: ./canvas-apps/controls/modern-controls/modern-control-combobox.md
519+
- name: Checkbox
520+
href: ./canvas-apps/controls/modern-controls/modern-control-checkbox.md
517521
- name: Link
518522
href: ./canvas-apps/controls/modern-controls/modern-control-link.md
519523
- name: Progress bar
520524
href: ./canvas-apps/controls/modern-controls/modern-control-progress-bar.md
525+
- name: Radio group
526+
href: ./canvas-apps/controls/modern-controls/modern-controls-radio-group.md
521527
- name: Slider
522528
href: ./canvas-apps/controls/modern-controls/modern-control-slider.md
529+
- name: Spinner
530+
href: ./canvas-apps/controls/modern-controls/modern-control-spinner.md
523531
- name: Tabs or tab list
524532
href: ./canvas-apps/controls/modern-controls/modern-control-tabs-or-tabs-list.md
533+
- name: Toggle
534+
href: ./canvas-apps/controls/modern-controls/modern-control-toggle.md
525535
- name: Avatar (preview)
526536
href: ./canvas-apps/controls/modern-controls/modern-control-avatar.md
527-
- name: Badge (preview)
528-
href: ./canvas-apps/controls/modern-controls/modern-controls-badge.md
529-
- name: Checkbox (preview)
530-
href: ./canvas-apps/controls/modern-controls/modern-control-checkbox.md
537+
- name: Combobox (preview)
538+
href: ./canvas-apps/controls/modern-controls/modern-control-combobox.md
531539
- name: Copilot answer (preview)
532540
href: ./canvas-apps/controls/modern-controls/modern-control-copilot-answer.md
533541
- name: Date picker (preview)
@@ -540,10 +548,6 @@
540548
href: ./canvas-apps/controls/modern-controls/modern-control-info-button.md
541549
- name: Number input (preview)
542550
href: ./canvas-apps/controls/modern-controls/modern-control-number-input.md
543-
- name: Radio group (preview)
544-
href: ./canvas-apps/controls/modern-controls/modern-controls-radio-group.md
545-
- name: Spinner (preview)
546-
href: ./canvas-apps/controls/modern-controls/modern-control-spinner.md
547551
- name: Stream video (preview)
548552
href: ./canvas-apps/controls/modern-controls/new-stream-video-control.md
549553
- name: Table (preview)
@@ -552,8 +556,6 @@
552556
href: ./canvas-apps/controls/modern-controls/modern-control-text.md
553557
- name: Text input (preview)
554558
href: ./canvas-apps/controls/modern-controls/modern-control-text-input.md
555-
- name: Toggle (preview)
556-
href: ./canvas-apps/controls/modern-controls/modern-control-toggle.md
557559
- name: Control reference
558560
items:
559561
- name: List of controls and properties

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Add Chatbot control to your canvas app
2+
title: Add a Chatbot control to your canvas app
33
description: A control that enables embedding of any published Power Virtual Agent (PVA) bot into Power Apps for end-user.
44
author: mduelae
55
ms.topic: conceptual
@@ -8,7 +8,7 @@ ms.collection:
88
- bap-ai-copilot
99
- get started
1010
ms.reviewer:
11-
ms.date: 5/2/2024
11+
ms.date: 7/9/2024
1212
ms.subservice: canvas-maker
1313
ms.author: tapanm
1414
search.audienceType:
@@ -17,11 +17,11 @@ contributors:
1717
- mduelae
1818
---
1919

20-
# Add Chatbot control to a canvas app (preview)
20+
# Add a Chatbot control to a canvas app (preview)
2121

2222
[This article is prerelease documentation and is subject to change.]
2323

24-
Add Chatbot control to your canvas apps and embed a published [Microsoft Copilot Studio](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) chatbot to assist your end-users with various requests—from providing simple answers to common questions to resolving issues requiring complex conversations.
24+
Add a Chatbot control to your canvas apps and embed a published [Microsoft Copilot Studio](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) chatbot to assist your end-users with various requests—from providing simple answers to common questions to resolving issues requiring complex conversations.
2525

2626
The Chabot control is also available in [custom pages for model-driven apps](../model-driven-apps/model-app-page-overview.md). The control also supports Teams authenticated Microsoft Copilot Studio bots. A bot picker lists all bots that are in the same environment as your app.
2727

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Add Copilot control for canvas app users
2+
title: Add a Copilot control for canvas app users
33
description: Add Copilot AI control for apps users to your canvas app.
44
author: mduelae
55
ms.topic: conceptual
@@ -8,7 +8,7 @@ ms.collection:
88
- bap-ai-copilot
99
- get started
1010
ms.reviewer:
11-
ms.date: 4/4/2024
11+
ms.date: 7/9/2024
1212
ms.subservice: canvas-maker
1313
ms.author: tapanm
1414
search.audienceType:
@@ -17,7 +17,7 @@ contributors:
1717
- mduelae
1818
---
1919

20-
# Add Copilot Control to a canvas app (preview)
20+
# Add a Copilot Control to a canvas app (preview)
2121

2222
[This article is prerelease documentation and is subject to change.]
2323

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
title: Add a custom Copilot to a canvas app
3+
description: "Add a custom Copilot to a canvas app in Microsoft Power Apps."
4+
author: mduelae
5+
ms.topic: conceptual
6+
ms.custom: canvas
7+
ms.reviewer:
8+
ms.date: 7/8/2024
9+
ms.subservice: canvas-maker
10+
ms.author: mkaur
11+
search.audienceType:
12+
- maker
13+
contributors:
14+
- mduelae
15+
---
16+
17+
# Add a custom Copilot to a canvas app (preview)
18+
19+
[This article is prerelease documentation and is subject to change.]
20+
21+
Microsoft Copilot Studio empowers makers to create their own custom Copilots with AI. In a few steps, you can add your custom Copilot across all your canvas app screens without modifying your app's design. You can use this feature both on the web and through the Power Apps mobile app.
22+
23+
> [!IMPORTANT]
24+
> - App Copilot for canvas apps is currently rolling out and might not yet be available in your region. App Copilot may be available on [Power Apps mobile](../../mobile/run-powerapps-on-mobile.md) for mobile devices before it becomes available on the web browser during rollout.
25+
> - You must allow data movement across regions, for generative AI features, as a prerequisite to use copilots in Power Apps. This step is important if your organization and your environment are in different regions. For more information, see [Enable copilots and generative AI features](/power-platform/admin/geographical-availability-copilot\#enable-data-movement-across-regions).
26+
> - Preview features aren't meant for production use and might have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
27+
> - For more information, go to our [preview terms](https://go.microsoft.com/fwlink/?linkid=2189520).
28+
29+
## What is the difference between App Copilot in canvas apps and the Copilot control?
30+
31+
**Copilot control** requires makers to update their canvas app to make space for the control and is only available on the web. The control feature supports asking questions about your data or connecting to a new (not existing) custom copilot from Copilot Studio.
32+
33+
**App Copilot** doesn't require updating the canvas app layout. App Copilot is available across web and natively on mobile devices and can connect to pre-existing custom Copilots created in Copilot Studio.
34+
35+
## How to enable App Copilot
36+
37+
### Prerequisites
38+
39+
- Create a custom Copilot in [Copilot Studio](/microsoft-copilot-studio/fundamentals-get-started?tabs=web) and publish it in the same environment as the app.
40+
41+
- Configure the custom Copilot with [user authentication in Microsoft Entra ID](/microsoft-copilot-studio/configuration-authentication-azure-ad).
42+
43+
- [Give makers and users access](/microsoft-copilot-studio/admin-share-bots?tabs=web) to the custom Copilot within the environment.
44+
45+
## Connect your custom Copilot to your canvas app
46+
47+
48+
Open your [canvas app open for editing](edit-app.md) in Power Apps Studio:
49+
50+
1. On the command bar, select **Settings** > **Updates** > **Preview** tab and enable **Copilot from app settings**.
51+
52+
1. You see a **Copilot** tab appear in **Settings**. In the drop-down list, select a custom Copilot that is published and shared in the same environment as your canvas app.
53+
54+
:::image type="content" source="media/add-custom-copilot/copilot-tab.png" alt-text="Screenshot that shows the Copilot tab in Settings and where you can select an app that was shared with you." lightbox="media/add-custom-copilot/copilot-tab.png":::
55+
56+
1. After choosing a copilot, close the settings dialog box and publish the app. App users are able to use App Copilot in the app.
57+
58+
When previewing an app in Power Apps Studio, Copilot is not displayed. To see Copilot in action, you need to save and publish your app, and then open it in Power Apps mobile or the web browser.
59+
60+
> [!TIP]
61+
> Removing the custom Copilot from the app disables the functionality.
62+
63+
## Use App Copilot
64+
65+
- Open your canvas app in a web browser. On the command bar, select **Copilot**.
66+
67+
:::image type="content" source="media/add-custom-copilot/copilot-chat-in-app.png" alt-text="Screenshot that shows the Copilot chat in the app." lightbox="media/add-custom-copilot/copilot-chat-in-app.png":::
68+
69+
- In Power Apps mobile running on iOS or Android devices, select the floating button to access App Copilot. You can move the button around or dismiss it. To use App Copilot after dismissing it, close and reopen the app.
70+
71+
## See Also
72+
73+
[FAQ for Copilot](/microsoft-copilot-studio/faqs-copilot)

powerapps-docs/maker/canvas-apps/ai-edit-app.md

Lines changed: 26 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.collection:
88
- bap-ai-copilot
99
- get started
1010
ms.reviewer:
11-
ms.date: 5/3/2024
11+
ms.date: 7/22/2024
1212
ms.subservice: canvas-maker
1313
ms.author: mkaur
1414
search.audienceType:
@@ -53,9 +53,31 @@ Copilot in Power Apps supports the following commands:
5353
- Text label
5454
- Text input
5555

56-
> [!NOTE]
57-
> - [Modern controls](controls/modern-controls/overview-modern-controls.md) aren't supported.
58-
> - This feature supports English and its variants.
56+
The following table lists the supported languages.
57+
58+
| **Name** | **Language Code** |
59+
|------------------------------------|-------------------|
60+
| English | en-US |
61+
| Chinese (simplified) | zh-Hans |
62+
| Czech | cs-CZ |
63+
| Danish | da-DK |
64+
| Dutch | nl-NL |
65+
| Finnish | fi-FI |
66+
| French | fr-FR |
67+
| German | de-DE |
68+
| Greek | el-GR |
69+
| Italian | it-IT |
70+
| Japanese | ja-JP |
71+
| Korean | ko-KR |
72+
| Norwegian (Bokmål) | nb-NO |
73+
| Polish | pl-PL |
74+
| Portuguese | pt-BR |
75+
| Russian | ru-RU |
76+
| Spanish (Traditional Sort) | es-ES |
77+
| Swedish | sv-SE |
78+
| Thai | th-TH |
79+
| Turkish | tr-TR |
80+
5981

6082
## Sample commands you can try
6183

0 commit comments

Comments
 (0)