Skip to content

Commit 62b9295

Browse files
authored
Merge pull request MicrosoftDocs#4493 from MicrosoftDocs/master
taking changes to live
2 parents 975bfd7 + 4a240e4 commit 62b9295

File tree

11 files changed

+107
-51
lines changed

11 files changed

+107
-51
lines changed

powerapps-docs/developer/data-platform/webapi/retrieve-and-execute-predefined-queries.md

Lines changed: 33 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Retrieve and execute predefined queries (Microsoft Dataverse)| Microsoft Docs"
33
description: "Microsoft Dataverse provides a way for administrators to create system views that are available to all users. Read how you can compose a predefined query and use FetchXML to create a query string to retrieve table data."
44
ms.custom: ""
5-
ms.date: 04/29/2021
5+
ms.date: 05/07/2021
66
ms.service: powerapps
77
ms.suite: ""
88
ms.tgt_pltfrm: ""
@@ -24,10 +24,33 @@ search.app:
2424

2525
# Retrieve and execute predefined queries
2626

27-
[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
28-
2927
Microsoft Dataverse provides a way for administrators to create system views that are available to all users. Individual users can save the Advanced Find queries for re-use in the application. Both of these represent predefined queries you can retrieve and execute using the Web API. You can also compose a query using FetchXml and use that to retrieve data.
3028

29+
> [!NOTE]
30+
> Unlike queries using the OData syntax, data returned from pre-defined queries or fetchXml will not return properties with `null` values. When the value is `null`, the property will not be included in the results.
31+
32+
When a query is returned using OData syntax, a record will include a property with a `null` value like so:
33+
34+
```json
35+
{
36+
"@odata.etag": "W/\"46849433\"",
37+
"name": "Contoso, Ltd. (sample)",
38+
"accountnumber": null,
39+
"accountid": "7a4814f9-b0b8-ea11-a812-000d3a122b89"
40+
}
41+
```
42+
43+
When retrieved using a pre-defined query or with FetchXml, the same record will not include the `accountnumber` property because it is `null`, like so:
44+
45+
```json
46+
{
47+
"@odata.etag": "W/\"46849433\"",
48+
"name": "Contoso, Ltd. (sample)",
49+
"accountid": "7a4814f9-b0b8-ea11-a812-000d3a122b89"
50+
}
51+
```
52+
53+
3154
<a name="bkmk_predefinedQueries"></a>
3255

3356
## Predefined queries
@@ -78,22 +101,23 @@ You can pass URL encoded FetchXML as a query to the entity set corresponding to
78101
<entity name='account'>
79102
<attribute name='accountid'/>
80103
<attribute name='name'/>
104+
<attribute name='accountnumber'/>
81105
</entity>
82106
</fetch>
83107
```
84108

85109
The URL encoded value of this FetchXML is as shown here.
86110

87111
```text
88-
%3Cfetch%20mapping='logical'%3E%3Centity%20name='account'%3E%3Cattribute%20name='accountid'/%3E%3Cattribute%20name='name'/%3E%3C/entity%3E%3C/fetch%3E
112+
%3Cfetch%20mapping%3D%27logical%27%3E%3Centity%20name%3D%27account%27%3E%3Cattribute%20name%3D%27accountid%27%2F%3E%3Cattribute%20name%3D%27name%27%2F%3E%3Cattribute%20name%3D%27accountnumber%27%2F%3E%3C%2Fentity%3E%3C%2Ffetch%3E
89113
```
90114

91115
Most programming languages include a function to URL encode a string. For example, in JavaScript you use the [encodeURI](https://www.ecma-international.org/ecma-262/5.1/) function. You should URL encode any request that you send to any RESTful web service. If you paste a URL into the address bar of your browser it should URL encode the address automatically. The following example shows a GET request using the FetchXML shown previously using the entity set path for accounts.
92116

93117
**Request**
94118

95119
```http
96-
GET [Organization URI]/api/data/v9.0/accounts?fetchXml=%3Cfetch%20mapping='logical'%3E%3Centity%20name='account'%3E%3Cattribute%20name='accountid'/%3E%3Cattribute%20name='name'/%3E%3C/entity%3E%3C/fetch%3E HTTP/1.1
120+
GET [Organization URI]/api/data/v9.0/accounts?fetchXml=%3Cfetch%20mapping%3D%27logical%27%3E%3Centity%20name%3D%27account%27%3E%3Cattribute%20name%3D%27accountid%27%2F%3E%3Cattribute%20name%3D%27name%27%2F%3E%3Cattribute%20name%3D%27accountnumber%27%2F%3E%3C%2Fentity%3E%3C%2Ffetch%3E HTTP/1.1
97121
Accept: application/json
98122
OData-MaxVersion: 4.0
99123
OData-Version: 4.0
@@ -109,7 +133,7 @@ OData-Version: 4.0
109133
{
110134
"@odata.context":"[Organization URI]/api/data/v9.0/$metadata#accounts(accountid,name)","value":[
111135
{
112-
"@odata.etag":"W/\"506678\"","accountid":"89390c24-9c72-e511-80d4-00155d2a68d1","name":"Fourth Coffee (sample)"
136+
"@odata.etag":"W/\"506678\"","accountid":"89390c24-9c72-e511-80d4-00155d2a68d1","name":"Fourth Coffee (sample)", "accountnumber":"1234",
113137
},{
114138
"@odata.etag":"W/\"502172\"","accountid":"8b390c24-9c72-e511-80d4-00155d2a68d1","name":"Litware, Inc. (sample)"
115139
},{
@@ -135,6 +159,9 @@ OData-Version: 4.0
135159
}
136160
```
137161

162+
> [!NOTE]
163+
> Properties with null values will not be included in results returned using FetchXml. In the example above, only the first record returned has an `accountnumber` value.
164+
138165
<a name="bkmk_WebAPIFetchPaging"></a>
139166

140167
### Paging with FetchXML

powerapps-docs/guidance/fusion-dev-ebook/04-using-dataverse-as-data-source.md

Lines changed: 21 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ author: spboyer
55
ms.service: powerapps
66
ms.topic: conceptual
77
ms.custom: ebook
8-
ms.date: 04/26/2021
8+
ms.date: 05/07/2021
99
ms.author: shboyer
1010
ms.reviewer: kvivek
1111

1212
---
1313

1414
# Chapter 4: Using Microsoft Dataverse as the data source
1515

16-
Maria has built a prototype app by using test data held in Excel workbooks. She can now consider how to connect the app to data sources that will provide real-world data. She has heard about Microsoft Dataverse as an option for doing this, however it isn't an option for VanArsdel because it won't work with their legacy systems and databases. Still, she wants to know more about it.
16+
Maria has built a prototype app by using test data held in Excel workbooks. She can now consider how to connect the app to data sources that will provide real-world data. She has heard about Microsoft Dataverse as an option for doing this, and wants to know more about it.
1717

1818
## What is Dataverse?
1919

@@ -47,9 +47,9 @@ Dataverse supports a rich set of data types for columns, ranging from simple tex
4747
4848
You can also define relationships among tables. These relationships can be *many-to-one*, *one-to-many*, or *many-to-many*. In addition, you specify the behavior of the related entities as part of the relationship. The behavior can be:
4949

50-
- **Referential**, with or without restricted delete. Restricted delete prevents a row in a related table from being removed if it's referenced by another row in the same, or a different, table.
51-
- **Parental**, in which any action performed on a row is also applied to any rows that it references.
52-
- **Custom**, which enables you to specify how referenced rows are affected by an action performed on the referencing row.
50+
- **Referential**, with or without restricted delete. Restricted delete prevents a row in a related table from being removed if it's referenced by another row in the same, or a different, table.
51+
- **Parental**, in which any action performed on a row is also applied to any rows that it references.
52+
- **Custom**, which enables you to specify how referenced rows are affected by an action performed on the referencing row.
5353

5454
The following example shows how to add a one-to-many relationship from the Account table to a custom table named SalesLT Customer. The behavior prevents a customer from being deleted if it's referenced by a row in the Account table.
5555

@@ -67,13 +67,13 @@ You use business rules to define validations and automate the flow of control wh
6767

6868
The business rules designer supports the following actions:
6969

70-
- Set column values.
71-
- Clear column values.
72-
- Set column requirement levels.
73-
- Show or hide columns (for model-driven apps only).
74-
- Enable or disable columns (for model-driven apps only).
75-
- Validate data and show error messages.
76-
- Create business recommendations based on business intelligence (for model-driven apps only).
70+
- Set column values.
71+
- Clear column values.
72+
- Set column requirement levels.
73+
- Show or hide columns (for model-driven apps only).
74+
- Enable or disable columns (for model-driven apps only).
75+
- Validate data and show error messages.
76+
- Create business recommendations based on business intelligence (for model-driven apps only).
7777

7878
> [!NOTE]
7979
> [Business rules](/powerapps/maker/data-platform/data-platform-create-business-rule) are best suited to model-driven apps. Not all business rule actions are supported by canvas apps.
@@ -92,11 +92,17 @@ In addition to storing the data structure and logic associated with a business e
9292

9393
![Defining a chart](media/image81.png)
9494

95-
## Why didn't VanArsdel use Dataverse?
95+
## Maria's decision to use Dataverse
9696

97-
Dataverse is an excellent choice of repository for many situations. You should seriously consider it for Power Apps development based on new systems and services, especially if you're creating model-driven apps.
97+
Dataverse is an excellent choice of repository for many situations. You should seriously consider it for Power Apps development based on new systems and services and adding new functionality to existing applications, especially if you're creating model-driven apps.
9898

99-
However, VanArsdel's current operations are heavily dependent on existing legacy systems and databases. For the time being, VanArsdel wants to focus on getting the apps out into the field rather than spend time migrating to Dataverse. Kiana and Maria, the professional and citizen developers, want to integrate their existing systems and processes into a Power Apps solution for Caleb, the field technician, as quickly as possible. They also want to minimize disruption to the critical operations performed by the receptionist Malik and avoid compromising the security and IT operations managed by Preeti. To achieve this, they'll create a Web API around their existing systems and connect to this Web API from Power Apps. They can then integrate the Web API into their canvas app. The following chapters walk through this process.
99+
However, in the application that Maria is building, the data already exists in a legacy database. A web API exists that connects to that database to retrieve and modify data and it's deployed in Azure App Service. Those legacy solutions are proven to work and Kiana and her high-code development team are very comfortable supporting those solutions going forward.
100+
101+
An advantage of fusion development teams and Dataverse is fusion development teams allow members to be their most productive in tools that they already know and are most comfortable with. A team does not need to migrate their existing data to Dataverse immediately to build an app using Power Apps. Likewise, when a team is building an application that requires new data, Dataverse makes a ton of sense as an option. It is not uncommon to see an app built using Power Apps to use a combination of legacy data sources and data in Dataverse.
102+
103+
When Maria starts to add new functionality to her app, for example having the field technicians add customer visit notes, she expects to use Dataverse to store that data.
104+
105+
So, for the time being Maria will connect the web API Kiana's team has already developed to her app to obtain the data needed. The following chapters will walk through that process.
100106

101107
> [!div class="step-by-step"]
102108
> [Previous](03-building-low-code-prototype.md)

powerapps-docs/maker/canvas-apps/controls/control-power-bi-tile.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ The parameter will filter a value in the dataset of the report where the tile or
5858
- Only the `eq` operator is supported.
5959
- Field type must be string.
6060
- Filtering is only available on pinned visualization tiles. It's not supported for pinned reports.
61+
- R and Python script visuals cannot be filtered.
6162

6263
You can use computed fields in the Power BI report to convert other value types to string or combines multiple fields into one.
6364

@@ -116,4 +117,4 @@ The **Power BI tile** is simply a container for Power BI content. Learn how to c
116117
If the Power BI content doesn't have a title, consider adding a heading using a **[Label](control-text-box.md)** control to support screen readers. You can position the label immediately before the Power BI tile.
117118

118119

119-
[!INCLUDE[footer-include](../../../includes/footer-banner.md)]
120+
[!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/maker/dev-community-plan.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,13 @@ If you want to build skills and learn more about Power Apps, Power Automate, and
1515

1616
* Learn to build business apps and workflows with the full functionality of Power Apps and Power Automate.
1717
* Connect to any data source by using our 100+ [out of the box connectors](./canvas-apps/connections-list.md) or by creating your own [custom connectors](./canvas-apps/register-custom-api.md).
18-
* Explore how you can use [the Dataverse](https://docs.microsoft.com/common-data-service/entity-reference/introduction) to build powerful business apps with the common data model and [the SDK](https://aka.ms/eek20s).
18+
* Explore how you can use [Dataverse](/powerapps/maker/data-platform/data-platform-intro) to build powerful business apps with the common data model and the SDK.
1919
* Export the solutions you create in your individual environment, and [publish them on Microsoft AppSource](../developer/data-platform/publish-app-appsource.md) so your customers can test-drive them.
2020

2121
## Who can sign up for the Power Apps Community Plan?
2222
Anyone with a [work or school account](signup-for-powerapps.md#faq) can sign up for the Power Apps Community Plan. But we especially recommend this plan if you:
2323

24-
* Want to build skills and learn more about Power Apps, Power Automate, and the Dataverse.
24+
* Want to build skills and learn more about Power Apps, Power Automate, and Dataverse.
2525
* Are interested in building business apps and workflows to distribute on Microsoft AppSource.
2626

2727
## Where can I sign up for the Power Apps Community Plan?
@@ -44,8 +44,8 @@ With the individual environment, you get the following functionality:
4444
| **Key features** | |
4545
| Create and run apps |Yes. You can create unlimited apps |
4646
| Share apps |No<sup>(1)</sup> |
47-
| Use the Dataverse |Yes |
48-
| Model your data using the Dataverse |Yes|
47+
| Use Dataverse |Yes |
48+
| Model your data using Dataverse |Yes|
4949
| Enterprise-grade administration of the environment and user policies |Yes |
5050
| **Connectivity** | |
5151
| Connect to Office 365, Dynamics 365, and other connectors |Yes |
@@ -54,9 +54,9 @@ With the individual environment, you get the following functionality:
5454
| Access on‐premises data using an on-premises gateway |Yes |
5555
| Create custom connectors to connect to your own systems |Yes. You can create unlimited custom connectors |
5656
| **Common Data Service** | |
57-
| Create and run applications on the Dataverse |Yes |
58-
| Model your data in the Dataverse |Yes |
59-
| Create a database in the Dataverse |Yes |
57+
| Create and run applications on Dataverse |Yes |
58+
| Model your data in Dataverse |Yes |
59+
| Create a database in Dataverse |Yes |
6060
| Create and use dataflows |No |
6161
| **Management**<sup>(3)</sup> | |
6262
| Add co-workers as environment makers and admins |No |
@@ -66,7 +66,7 @@ With the individual environment, you get the following functionality:
6666

6767
<sup>(1)</sup>You can't share resources such as apps, flows, or connections with any other users from your tenant.
6868
<br>
69-
<sup>(2)</sup>Using [premium connectors](https://docs.microsoft.com/connectors/connector-reference/connector-reference-premium-connectors) to connect to the data sources outside Power Apps will require you to have [standalone plans](https://docs.microsoft.com/power-platform/admin/pricing-billing-skus#power-apps-and-power-automate-standalone-plans).
69+
<sup>(2)</sup>Using [premium connectors](/connectors/connector-reference/connector-reference-premium-connectors) to connect to the data sources outside Power Apps will require you to have [standalone plans](/power-platform/admin/pricing-billing-skus#power-apps-and-power-automate-standalone-plans).
7070
<br>
7171
<sup>(3)</sup>You can't add any other user as an environment admin or a maker, or to the database roles from the admin center.
7272

@@ -106,7 +106,7 @@ Yes, you should be able to export the resources from this environment to other e
106106

107107
### Will my Power Apps Community Plan subscription ever expire?
108108

109-
You can use your Power Apps Community Plan subscription perpetually for free. If you are actively using an individual environment, then you won't lose access to any of the resources or functionality in that environment. You may, however, notice a delay when accessing your Dataverse Database for the first time after a long period of inactivity. This delay does not impact the data or entities stored in the Dataverse.
109+
You can use your Power Apps Community Plan subscription perpetually for free. If you are actively using an individual environment, then you won't lose access to any of the resources or functionality in that environment. You may, however, notice a delay when accessing your Dataverse Database for the first time after a long period of inactivity. This delay does not impact the data or entities stored in Dataverse.
110110

111111
### Can I get or create multiple individual environments?
112112

@@ -126,16 +126,16 @@ No, you can only sign up with your [work or school account](signup-for-powerapps
126126

127127
### Can I delete my individual environment?
128128

129-
Tenant-level admins have the permissions needed to delete an individual environment through the user interface. An end user can delete an individual environment through a [Power Apps PowerShell admin cmdlet](https://docs.microsoft.com/power-platform/admin/powerapps-powershell#power-apps-cmdlets-for-administrators-preview).
129+
Tenant-level admins have the permissions needed to delete an individual environment through the user interface. An end user can delete an individual environment through a [Power Apps PowerShell admin cmdlet](/power-platform/admin/powerapps-powershell#power-apps-cmdlets-for-administrators-preview).
130130

131131
```powershell
132132
Remove-AdminPowerAppEnvironment -EnvironmentName <environmentGuid>
133133
```
134134

135135
### Can I reset my developer environment
136136

137-
Resetting a developer environment is not currently supported; however, it can be deleted. The next time the Community Plan licensed user signs into the Power Apps Maker portal a new developer environment will be created. The user can then provision a Common Database Service database in the environment. At present, the only way to remove the Community Plan from a user is for a tenant-level admin to block all "internal" consent plans in the tenant using PowerShell. See [Block trial licenses commands](https://docs.microsoft.com/power-platform/admin/powerapps-powershell#block-trial-licenses-commands)
137+
Resetting a developer environment is not currently supported; however, it can be deleted. The next time the Community Plan licensed user signs into the Power Apps Maker portal a new developer environment will be created. The user can then provision a Common Database Service database in the environment. At present, the only way to remove the Community Plan from a user is for a tenant-level admin to block all "internal" consent plans in the tenant using PowerShell. See [Block trial licenses commands](/power-platform/admin/powerapps-powershell#block-trial-licenses-commands)
138138

139139

140140

141-
[!INCLUDE[footer-include](../includes/footer-banner.md)]
141+
[!INCLUDE[footer-include](../includes/footer-banner.md)]

powerapps-docs/maker/portals/add-text.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,4 +52,4 @@ To add text box:
5252
- [WYSIWYG editor](compose-page.md)
5353

5454

55-
[!INCLUDE[footer-include](../../includes/footer-banner.md)]
55+
[!INCLUDE[footer-include](../../includes/footer-banner.md)]

powerapps-docs/maker/portals/admin/migrate-portal-configuration.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: neerajnandwana-msft
55
ms.service: powerapps
66
ms.topic: conceptual
77
ms.custom:
8-
ms.date: 04/27/2021
8+
ms.date: 05/07/2021
99
ms.author: nenandw
1010
ms.reviewer: tapanm
1111
contributors:
@@ -30,9 +30,11 @@ Schema files are available for the following portal types:
3030

3131
- **Portals created in an environment with Dataverse**
3232
- [Custom portal (Blank portal)](https://go.microsoft.com/fwlink/p/?linkid=2110477)
33+
- [Custom portal (Blank portal)](https://go.microsoft.com/fwlink/p/?linkid=2162831) (for version [9.2.2103.x](../versions/package-version-9.2.2103.md))
3334

3435
- **Portals created in an environment containing customer engagement apps (such as Dynamics 365 Sales and Dynamics 365 Customer Service)**
3536
- [Custom portal (Blank portal)](https://go.microsoft.com/fwlink/p/?linkid=2019804)
37+
- [Custom portal (Blank portal)](https://go.microsoft.com/fwlink/p/?linkid=2162733) (for version [9.2.2103.x](../versions/package-version-9.2.2103.md))
3638
- [Community portal](https://go.microsoft.com/fwlink/p/?linkid=2019704)
3739
- [Customer Self-Service portal](https://go.microsoft.com/fwlink/p/?linkid=2019705)
3840
- [Partner portal](https://go.microsoft.com/fwlink/p/?linkid=2019803)

0 commit comments

Comments
 (0)