Skip to content

Commit 9b094d8

Browse files
authored
Merge branch 'live' into patch-2
2 parents 2e7c7a9 + f543ee2 commit 9b094d8

File tree

139 files changed

+1651
-402
lines changed

Some content is hidden

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

139 files changed

+1651
-402
lines changed

powerapps-docs/developer/common-data-service/TOC.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@
3333
href: column-comparison.md
3434
- name: FetchXML search item limit
3535
href: quick-find-limit.md
36+
- name: Improve FetchXML request performance
37+
href: fetchxml-performance.md
3638
- name: "Use SQL to query data (Preview)"
3739
href: cds-sql-query.md
3840
- name: Saved Queries
@@ -351,7 +353,7 @@
351353
href: authenticate-dot-net-framework.md
352354
- name: Use OAuth
353355
href: authenticate-oauth.md
354-
- name: Office365 authentication with WS-Trust
356+
- name: Microsoft 365 authentication with WS-Trust
355357
href: authenticate-office365-deprecation.md
356358
- name: "Tutorial: Register an app with Azure Active Directory"
357359
href: walkthrough-register-app-azure-active-directory.md

powerapps-docs/developer/common-data-service/authenticate-dot-net-framework.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ With the `Xrm.Tooling` classes, use the <xref:Microsoft.Xrm.Tooling.Connector>.<
2929
3030
The `Xrm.Tooling` classes provide many benefits including:
3131
- You can define connection information using a connection string.
32-
- Supports both OAuth and Office 365 claims-based authentication.
32+
- Supports both OAuth and Microsoft 365 claims-based authentication.
3333
- Thread safety for actions performed in a multithreaded environment.
3434
- A common Windows Presentation Foundation (WPF) login control for a consistent sign-in experience from your Windows client applications.
3535
- Supports for secure storage of the sign-in credentials and reuse of the stored credentials to automatically sign in after initial sign in.

powerapps-docs/developer/common-data-service/authenticate-office-365-users-cds-web-services.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Authenticate Office 365 users with Common Data Service web services (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
2+
title: "Authenticate Microsoft 365 users with Common Data Service web services (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
33
description: "<Description>" # 115-145 characters including spaces. This abstract displays in the search result.
44
ms.custom: ""
55
ms.date: 10/31/2018
@@ -15,7 +15,7 @@ search.app:
1515
- PowerApps
1616
- D365CE
1717
---
18-
# Authenticate Office 365 users with Common Data Service web services
18+
# Authenticate Microsoft 365 users with Common Data Service web services
1919

2020
<!-- https://docs.microsoft.com/dynamics365/customer-engagement/developer/authenticate-office-365-users-customer-engagement-web-services
2121

powerapps-docs/developer/common-data-service/authenticate-office365-deprecation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Use of Office365 authentication with the WS-Trust security protocol (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
2+
title: "Use of Microsoft 365 authentication with the WS-Trust security protocol (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
33
description: "Describes deprecation of the WS-Trust security protocol and the authentication code changes required in applications."
44
ms.custom: ""
55
ms.date: 02/05/2020
@@ -16,7 +16,7 @@ search.app:
1616
- D365CE
1717
---
1818

19-
# Use of Office365 authentication with the WS-Trust security protocol
19+
# Use of Microsoft 365 authentication with the WS-Trust security protocol
2020

2121
Use of the WS-Trust authentication security protocol when connecting to Common
2222
Data Service is no longer recommended and has been
@@ -85,7 +85,7 @@ Service.
8585
Password=passcode;Url=https://contosotest.crm.dynamics.com;AppId=51f81489-12ee-4a9e-aaae-a2591f45987d;
8686
RedirectUri=app://58145B91-0C36-4500-8554-080854F2AC97;LoginPrompt=Auto"`
8787
88-
This will be your fastest way to update the code. Note that LoginPrompt can be set toneverto simulate the way that the Office 365 behavior worked.
88+
This will be your fastest way to update the code. Note that LoginPrompt can be set toneverto simulate the way that the Microsoft 365 behavior worked.
8989

9090
The AppId and RedirectUri provided above are examples of working application registration values. These values work everywhere our online services are deployed. However, they are provided here as examples and you are encouraged to create your own application registration in Azure Active Directory (AAD) for applications running in your tenant.<p/>
9191

powerapps-docs/developer/common-data-service/authentication.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ How you authenticate depends on the software framework you use and which web ser
2525
If your client application uses the .NET Framework, you have two options:
2626

2727
- OAuth
28-
- Office 365
28+
- Microsoft 365
2929

3030
### OAuth
3131

@@ -39,13 +39,13 @@ OAuth is also required to support:
3939

4040
More information: [Use OAuth with Common Data Service](authenticate-oauth.md)
4141

42-
### Office 365
42+
### Microsoft 365
4343

44-
Office 365 authentication requires using the .NET Framework SDK assemblies with the SOAP web services only.
44+
Microsoft 365 authentication requires using the .NET Framework SDK assemblies with the SOAP web services only.
4545

46-
Using Office 365 authentication does not require that your register your applications as OAuth does. You must simply provide a User Principal Name (UPN) and password for a valid user.
46+
Using Microsoft 365 authentication does not require that your register your applications as OAuth does. You must simply provide a User Principal Name (UPN) and password for a valid user.
4747

48-
More information: [Authentication with .NET Framework applications](authenticate-dot-net-framework.md), [Use of Office365 authentication with the WS-Trust security protocol](authenticate-office365-deprecation.md)
48+
More information: [Authentication with .NET Framework applications](authenticate-dot-net-framework.md), [Use of Microsoft 365 authentication with the WS-Trust security protocol](authenticate-office365-deprecation.md)
4949

5050
## All other software frameworks
5151

powerapps-docs/developer/common-data-service/cds-sql-query.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Use SQL to query data (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
33
description: "Learn how to query Common Data Service entity data using SQL." # 115-145 characters including spaces. This abstract displays in the search result.
44
ms.custom: ""
5-
ms.date: 05/26/2020
5+
ms.date: 09/25/2020
66
ms.reviewer: "pehecke"
77
ms.service: powerapps
88
ms.topic: "article"
@@ -20,8 +20,13 @@ search.app:
2020

2121
[!INCLUDE[cc-beta-prerelease-disclaimer](../../includes/cc-beta-prerelease-disclaimer.md)]
2222

23+
> [!WARNING]
24+
> A problem has been identified with the Tabular Data Stream (TDS) endpoint. This feature is globally disabled, and we are working urgently to address the issue. This topic will be updated when the issue is resolved or when we have more information to share.
25+
2326
A SQL data connection is available on the Common Data Service endpoint. The SQL connection provides read-only access to the entity data of the target Common Data Service environment. This allows you to write and execute SQL queries against the entity data table. Table columns provide the attribute data of the entity. No custom views of the data have been provided.
2427

28+
29+
2530
> [!IMPORTANT]
2631
> - This is a preview feature, and isn't available in all regions.
2732
> - [!INCLUDE[cc_preview_features_definition](../../includes/cc-preview-features-definition.md)]

powerapps-docs/developer/common-data-service/connect-microsoft-office-365.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "Connect with Microsoft Office 365 and Common Data Service (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
3-
description: "The Microsoft Office 365 portal provides a single sign-on experience for Office 365 customers where they can sign in once and access any Office 365 application" # 115-145 characters including spaces. This abstract displays in the search result.
2+
title: "Connect with Microsoft 365 and Common Data Service (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
3+
description: "The Microsoft 365 portal provides a single sign-on experience for Microsoft 365 customers where they can sign in once and access any Microsoft 365 application" # 115-145 characters including spaces. This abstract displays in the search result.
44
ms.custom: ""
55
ms.date: 10/31/2018
66
ms.reviewer: "pehecke"
@@ -15,16 +15,16 @@ search.app:
1515
- PowerApps
1616
- D365CE
1717
---
18-
# Connect with Microsoft Office 365 and Common Data Service
18+
# Connect with Microsoft 365 and Common Data Service
1919

20-
Common Data Service is part of the Office 365 collaboration and productivity tools. The [Microsoft Office 365 portal](https://www.microsoft.com/office365) provides a single sign-on experience for Office 365 customers where they can sign in once and access any Office 365 application, including Common Data Service. In addition, system user accounts in Common Data Service can be provisioned in the [Microsoft Online Services](https://portal.microsoftonline.com/) admin portal.
20+
Common Data Service is part of the Microsoft 365 collaboration and productivity tools. The [Microsoft 365 portal](https://www.microsoft.com/office365) provides a single sign-on experience for Microsoft 365 customers where they can sign in once and access any Microsoft 365 application, including Common Data Service. In addition, system user accounts in Common Data Service can be provisioned in the [Microsoft Online Services](https://portal.microsoftonline.com/) admin portal.
2121

2222
Using federation, applications can connect to Common Data Service using the same system user identities and credentials available in an Azure Active Directory based network. More information: [Single sign-on roadmap](https://technet.microsoft.com/library/hh967643.aspx).
2323

2424
## In This Section
25-
[Common Data Service Integration with Office 365](online-integration-office-365.md)
25+
[Common Data Service Integration with Microsoft 365](online-integration-office-365.md)
2626

27-
[Authenticate Office 365 Users with Common Data Service Web Services](/dynamics365/customer-engagement/developer/authenticate-office-365-users-customer-engagement-web-services)
27+
[Authenticate Microsoft 365 Users with Common Data Service Web Services](/dynamics365/customer-engagement/developer/authenticate-office-365-users-customer-engagement-web-services)
2828

2929
[Sample: Authenticate Users with Common Data Service Web Services](/dynamics365/customer-engagement/developer/sample-authenticate-users-web-services)
3030

Lines changed: 117 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,117 @@
1+
---
2+
title: Improve FetchXML request performance | Microsoft Docs
3+
description: Learn how developers can improve FetchXML request performance when using Common Data Service.
4+
author: NHelgren
5+
manager: annbe
6+
ms.service: powerapps
7+
ms.topic: article
8+
ms.date: 09/28/2020
9+
ms.author: nhelgren
10+
ms.reviewer: "pehecke"
11+
search.audienceType:
12+
- developer
13+
search.app:
14+
- PowerApps
15+
- D365CE
16+
---
17+
18+
# Improve FetchXML request performance
19+
20+
An option available in FetchXML requests called *LateMaterialize* allows you to break up such
21+
requests into smaller more usable segments which can improve the performance of long running FetchXML requests.
22+
23+
> [!NOTE]
24+
> Performance improvements depend on the data distribution for each
25+
> participating entity and linked entity. Late materialization may not always
26+
> provide a performance benefit. It is best used if you are experiencing
27+
> performance issues with your existing fetch request.
28+
29+
Executing a traditional fetch for a given number of the top entity records will pull all
30+
the columns in the select list that meet the filter criteria. Let’s say you are
31+
pulling the top 500 records on an entity that has 100 columns and 100K rows
32+
that meet the filter criteria, this request can cause issues in two ways:
33+
34+
- The 99.5K rows will pull all columns, even though you only need to populate
35+
the select list for 500 rows when returning to the client.
36+
37+
- Query Optimizer can generate an arbitrary order when retrieving the child
38+
columns, resulting in an undesired data order.
39+
40+
Using `LateMaterialize` allows you to create a fetch that will:
41+
42+
- First pull only the primary ID of the top number of records specified.
43+
44+
- Select only the columns of data needed based on the primary IDs that were
45+
retrieved. For example, where only 5 columns are needed for display in the form.
46+
47+
By pulling only the needed data after the primary IDs are collected, the
48+
retrieval is much faster as data that is not needed for the current operation is
49+
excluded.
50+
51+
This is most beneficial when:
52+
53+
- The entity you are querying has one or more links to other entities for column data.
54+
55+
- There are many columns in the entity.
56+
57+
- The entity contains logical attributes.
58+
59+
## Syntax
60+
61+
```xml
62+
<fetch version="1.0" output-format="xml-platform" latematerialize="true"
63+
 mapping="logical" distinct="true">
64+
65+
<entity name="[entity]">​
66+
<attribute name="[attribute]" />
67+
68+
<link-entity name="[entity]" from="[linked entity]" to="[linked entityid]"
69+
link-type="outer" alias="[alias]">​
70+
<attribute name="[name of linked entity column]" />​
71+
</link-entity>
72+
73+
<filter type=[filter type]>​
74+
<condition attribute="[column]" operator="[operator]" value="[value]"/> ​
75+
</filter>​
76+
</entity>
77+
78+
</fetch>
79+
```
80+
81+
## Sample
82+
83+
```XML
84+
<fetch version="1.0" output-format="xml-platform" latematerialize="true"
85+
  mapping="logical" distinct="true">
86+
87+
<entity name="account">​
88+
<attribute name="accountnumber" />​
89+
<attribute name="createdby" />​
90+
<attribute name="ownerid" />​
91+
92+
<link-entity name="account" from="accountid" to="parentaccountid"
93+
link-type="outer" alias="oaccount">​
94+
<attribute name="createdby" />
95+
96+
<link-entity name="account" from="accountid" to="accountid" link-type="outer"
97+
alias="oaccount1">​
98+
<attribute name="createdby" />​
99+
<attribute name="accountid" />​
100+
<attribute name="name" />​
101+
</link-entity>​
102+
</link-entity>​
103+
104+
<link-entity name="account" from="accountid" to="accountid" link-type="outer"
105+
alias="oaccount2"/>
106+
107+
<filter type='and'>​
108+
<condition attribute="statecode" operator="eq" value="2"/> ​
109+
</filter>​
110+
</entity>​
111+
112+
</fetch>
113+
```
114+
115+
### See Also
116+
117+
[Use FetchXML to construct a query](use-fetchxml-construct-query.md)

powerapps-docs/developer/common-data-service/online-integration-office-365.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Integration with Office 365 (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
2+
title: "Integration with Microsoft 365 (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
33
description: "<Description>" # 115-145 characters including spaces. This abstract displays in the search result.
44
ms.custom: ""
55
ms.date: 10/31/2018
@@ -15,7 +15,7 @@ search.app:
1515
- PowerApps
1616
- D365CE
1717
---
18-
# Integration with Office 365
18+
# Integration with Microsoft 365
1919

2020
<!-- https://docs.microsoft.com/dynamics365/customer-engagement/developer/online-integration-office-365
2121
Do we even need this topic?

powerapps-docs/developer/common-data-service/online-management-api/authentication.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ These are the broad steps to authenticate to the Online Management API service.
8484
}
8585
```
8686

87-
You are all set to execute messages against the Online Management API. For a sample code that demonstrates how to retrieve all Common Data Service environments in your Office 365 tenant, see [Quick Start Sample: Retrieve environments in your tenant](sample-quick-start.md)
87+
You are all set to execute messages against the Online Management API. For a sample code that demonstrates how to retrieve all Common Data Service environments in your Microsoft 365 tenant, see [Quick Start Sample: Retrieve environments in your tenant](sample-quick-start.md)
8888

8989

9090
### Related Topics

0 commit comments

Comments
 (0)