Skip to content

Commit 79b4397

Browse files
committed
Merge branch 'master' into portals-1805092
2 parents d516f91 + 25cf2ed commit 79b4397

File tree

478 files changed

+6874
-1505
lines changed

Some content is hidden

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

478 files changed

+6874
-1505
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1854,12 +1854,7 @@
18541854
"source_path": "powerapps-docs/maker/maker/canvas-apps/webinars-listing.md",
18551855
"redirect_url": "https://powerusers.microsoft.com/t5/Samples-Learning-and-Videos/ct-p/PA_Comm_Galleries",
18561856
"redirect_document_id": "false"
1857-
},
1858-
{
1859-
"source_path": "powerapps-docs/developer/common-data-service/index.md",
1860-
"redirect_url": "/powerapps/developer/common-data-service/overview",
1861-
"redirect_document_id": "false"
1862-
},
1857+
},
18631858
{
18641859
"source_path": "powerapps-docs/developer/common-data-service/org-service/index.md",
18651860
"redirect_url": "/powerapps/developer/common-data-service/org-service/overview",
@@ -1900,11 +1895,6 @@
19001895
"redirect_url": "/powerapps/developer/common-data-service/index",
19011896
"redirect_document_id": "false"
19021897
},
1903-
{
1904-
"source_path": "powerapps-docs/developer/model-driven-apps/index.md",
1905-
"redirect_url": "/powerapps/developer/model-driven-apps/overview",
1906-
"redirect_document_id": "false"
1907-
},
19081898
{
19091899
"source_path": "powerapps-docs/maker/canvas-apps/working-with-experimental.md",
19101900
"redirect_url": "working-with-experimental-preview",
@@ -1913,17 +1903,12 @@
19131903
{
19141904
"source_path": "powerapps-docs/maker/common-data-service/entity-relationship-behavior.md",
19151905
"redirect_url": "create-edit-entity-relationships#entity-relationship-behavior",
1916-
"redirect_document_id": "false"
1917-
},
1918-
{
1919-
"source_path": "powerapps-docs/maker/common-data-service/index.md",
1920-
"redirect_url": "/powerapps/maker/common-data-service/data-platform-intro",
1921-
"redirect_document_id": "false"
1906+
"redirect_document_id": false
19221907
},
19231908
{
1924-
"source_path": "powerapps-docs/maker/model-driven-apps/index.md",
1925-
"redirect_url": "/powerapps/maker/model-driven-apps/model-driven-app-overview",
1926-
"redirect_document_id": "false"
1909+
"source_path": "powerapps-docs/maker/canvas-apps/embed-teams-app.md",
1910+
"redirect_url": "/powerapps/teams/embed-teams-app",
1911+
"redirect_document_id": false
19271912
}
19281913
]
19291914
}

clear_filter.png

73.1 KB
Loading

powerapps-docs/chart_on_form.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: "View charts on a form page in model-driven apps| MicrosoftDocs"
3+
description: Use interative dashboards to filter data in Power Apps
4+
author: mduelae
5+
manager: kvivek
6+
ms.service: powerapps
7+
ms.component: pa-user
8+
ms.topic: conceptual
9+
ms.date: 9/2/2020
10+
ms.author: mduelae
11+
ms.custom: ""
12+
ms.reviewer: ""
13+
ms.assetid:
14+
search.audienceType:
15+
- enduser
16+
search.app:
17+
- PowerApps
18+
- D365CE
19+
---
20+
# View charts on a form page
21+
22+
Use interactive dashboards to see workload information and take action. The charts on a interactive dashboard serves as a simple filtering source. You can select different data points on a chart to filter data based on the filter criteria.
23+
Interactive dashboards are system dashboards that only an admin can create. To learn more on how to create and configure interactive dashboards, see [Create and configure model-driven app interactive experience dashboards](https://docs.microsoft.com/powerapps/maker/model-driven-apps/configure-interactive-experience-dashboards).
24+
25+
Interactive dashboards come in two forms: multi-stream and single-stream. In addition, multi-stream dashboards can be home page or entity-specific dashboards. The multi-stream dashboards display data in real time over multiple data streams.
26+
27+
28+
> [!div class="mx-imgBorder"]
29+
> ![Multi-stream interactive dashboard](media/interactive_dashboard.png "Multi-stream interactive dashboard")

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
- name: Common Data Service
2-
href: ../../maker/common-data-service/data-platform-intro.md
3-
- name: Developer overview
1+
- name: Common Data Service developer guide
2+
href: index.yml
3+
- name: Overview
44
href: overview.md
55
- name: Get started
66
href: get-started-cds-developers.md

powerapps-docs/developer/common-data-service/api-limits.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -333,7 +333,7 @@ If your application is currently using the low-level <xref:Microsoft.Xrm.Sdk.Cli
333333

334334
More information:
335335

336-
- [Build Windows client applications using the XRM tools](/xrm-tooling/build-windows-client-applications-xrm-tools).
336+
- [Build Windows client applications using the XRM tools](xrm-tooling/build-windows-client-applications-xrm-tools.md).
337337
- [Deprecation of Office365 authentication type and OrganizationServiceProxy class for connecting to Common Data Service](/power-platform/important-changes-coming#deprecation-of-office365-authentication-type-and-organizationserviceproxy-class-for-connecting-to-common-data-service)
338338

339339
### Use Task Parallel Library with CrmServiceClient

powerapps-docs/developer/common-data-service/create-auto-number-attributes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ The sequential segment is generated by SQL and hence uniqueness is guaranteed by
3232
> [!NOTE]
3333
>You can modify an existing format text attribute to be an auto-number format.
3434
35-
When you add the auto-number attribute as a field to a form, the auto-number attribute field behaves as read-only in the form, and end-users cannot edit the field. The value is set only after you save the entity. You can see auto-number attribute as any other field value in views, grids and so on.
35+
In the legacy web client, when adding a control on a form bound to an auto-number attribute, the control is disabled automatically and behaves as read-only in the form where end-users cannot edit the control. In the Unified Interface, controls bound to an auto-number attribute need to explicitly be set as disabled. If you do not set the initial attribute value on the form, the value is set only after you save the entity. Auto-numbering can be applied to attribute field values in views, grids and so on.
3636

3737
### Examples
3838
The following examples show how to create a new auto-number attribute named **new\_SerialNumber** for a custom entity named **new\_Widget** which will have a value that looks like this: **WID-00001-AB7LSFG-20170913070240**.
Lines changed: 163 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,163 @@
1+
### YamlMime:Landing
2+
3+
title: Common Data Service developer documentation
4+
summary: Learn how to write applications and web pages that can access Common Data Service business data, extend the functionality of the platform through plug-ins and workflow, or interface your business data to external systems.
5+
6+
metadata:
7+
title: Common Data Service developer documentation
8+
description: Provides access to highlighted areas within the Common Data Service developer documentation
9+
services: service
10+
ms.service: powerapps
11+
ms.subservice: subservice
12+
ms.topic: landing-page
13+
ms.collection: collection
14+
author: phecke
15+
ms.author: pehecke
16+
ms.date: 09/08/2020
17+
18+
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
19+
20+
landingContent:
21+
22+
# Card
23+
- title: Get started
24+
linkLists:
25+
- linkListType: overview
26+
links:
27+
- text: Developer overview
28+
url: overview.md
29+
- text: "Developers: Get started"
30+
url: get-started-CDS-developers.md
31+
- linkListType: learn
32+
links:
33+
- text: Introduction to Common Data Service for developers
34+
url: https://docs.microsoft.com/learn/modules/intro-cds-developers-power-platform/
35+
36+
37+
# Card
38+
- title: Work with data
39+
linkLists:
40+
- linkListType: overview
41+
links:
42+
- text: Work with data using code
43+
url: work-with-data-cds.md
44+
- text: Types and operations (Web API)
45+
url: /powerapps/developer/common-data-service/webapi/web-api-types-operations
46+
- text: Entity operations (Organization service)
47+
url: /powerapps/developer/common-data-service/org-service/entity-operations
48+
- text: Use FetchXML to query data
49+
url: /powerapps/developer/common-data-service/use-fetchxml-construct-query
50+
- text: Use SQL to query data
51+
url: /powerapps/developer/common-data-service/cds-sql-query
52+
53+
# Card
54+
- title: Integrate external data
55+
linkLists:
56+
- linkListType: overview
57+
links:
58+
- text: Azure integration
59+
url: /powerapps/developer/common-data-service/azure-integration
60+
- text: Webhooks
61+
url: /powerapps/developer/common-data-service/use-webhooks
62+
- text: Synchronize data with external system
63+
url: /powerapps/developer/common-data-service/data-synchronization
64+
- text: Import data
65+
url: /powerapps/developer/common-data-service/import-data
66+
- text: Data Export Service
67+
url: /powerapps/developer/common-data-service/data-export-service
68+
69+
70+
# Card
71+
- title: Apply business logic
72+
linkLists:
73+
- linkListType: concept
74+
links:
75+
- text: Event framework
76+
url: /powerapps/developer/common-data-service/event-framework
77+
- linkListType: overview
78+
links:
79+
- text: Plug-ins
80+
url: /powerapps/developer/common-data-service/plug-ins
81+
- text: Workflow extensions
82+
url: /powerapps/developer/common-data-service/workflow/workflow-extensions
83+
- linkListType: tutorial
84+
links:
85+
- text: Write and register a plug-in
86+
url: /powerapps/developer/common-data-service/tutorial-write-plug-in
87+
88+
# Card
89+
- title: Deploy and publish
90+
linkLists:
91+
- linkListType: overview
92+
links:
93+
- text: Solution concepts
94+
url: /powerapps/developer/common-data-service/introduction-solutions
95+
- text: ALM for developers
96+
url: https://docs.microsoft.com/power-platform/alm/alm-for-developers
97+
- linkListType: sample
98+
links:
99+
- text: Work with solutions using the SDK APIs
100+
url: /power-platform/alm/solution-api
101+
- linkListType: how-to-guide
102+
links:
103+
- text: Publish your app on AppSource
104+
url: /powerapps/developer/common-data-service/publish-app-appsource
105+
106+
# Card
107+
- title: Create client applications
108+
linkLists:
109+
- linkListType: overview
110+
links:
111+
- text: Authentication and the web services
112+
url: authentication.md
113+
- text: Build web applications using Server-to-Server (S2S) authentication
114+
url: build-web-applications-server-server-s2s-authentication.md
115+
- text: Use OAuth with CORS to connect an SPA
116+
url: /powerapps/developer/common-data-service/oauth-cross-origin-resource-sharing-connect-single-page-application
117+
- text: Build Windows client applications using the XRM tools
118+
url: xrm-tooling/build-windows-client-applications-xrm-tools.md
119+
- linkListType: tutorial
120+
links:
121+
- text: Register an app with Azure Active Directory
122+
url: walkthrough-register-app-azure-active-directory.md
123+
124+
# Card
125+
- title: Tools and resources
126+
linkLists:
127+
- linkListType: overview
128+
links:
129+
- text: View the developer resources page
130+
url: /powerapps/developer/common-data-service/view-download-developer-resources
131+
- text: Developer tools
132+
url: /powerapps/developer/common-data-service/developer-tools
133+
- text: Microsoft Power Apps CLI
134+
url: /powerapps/developer/common-data-service/powerapps-cli
135+
- text: Community tools
136+
url: /powerapps/developer/common-data-service/community-tools
137+
138+
# Card
139+
- title: Entity and API reference
140+
linkLists:
141+
- linkListType: reference
142+
links:
143+
- text: Entity reference
144+
url: reference/about-entity-reference.md
145+
- text: SDK API class libraries
146+
url: https://docs.microsoft.com/dotnet/api/?view=dynamics-general-ce-9
147+
- text: Web API
148+
url: /dynamics365/customer-engagement/web-api/about?view=dynamics-ce-odata-9
149+
- text: XRM Tooling API Reference
150+
url: https://docs.microsoft.com/dotnet/api/?view=dynamics-xrmtooling-ce-9
151+
152+
153+
# Card
154+
- title: Related resources
155+
linkLists:
156+
- linkListType: overview
157+
links:
158+
- text: Canvas apps Developer Guide
159+
url: ../../maker/canvas-apps/dev-enterprise-intro.md
160+
- text: Model-driven apps Developer Guide
161+
url: ../model-driven-apps/index.yml
162+
- text: Power Apps component framework
163+
url: ../component-framework/overview.md

powerapps-docs/developer/common-data-service/org-service/use-executeAsync.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,14 +17,16 @@ search.app:
1717
---
1818
# Use ExecuteAsync to execute messages asynchronously
1919

20-
Except for two, all data operations using the SDK assembly request classes are synchronous.
20+
Except for three, all data operations using the SDK assembly request classes are synchronous.
2121

2222
Importing a solution is one operation which can require considerable resources, so there is an option to execute this operation asynchronously using the <xref:Microsoft.Xrm.Sdk.Messages.ExecuteAsyncRequest> request class. The <xref:Microsoft.Crm.Sdk.Messages.DeleteAndPromoteRequest> request class performs similar resource intensive operations.
2323

2424
Importing a solution asynchronously improves system performance by postponing message execution until some later time when the server load may be less. Interactive users do not have to wait for the target message to execute before they can continue. This is especially useful when importing solutions which may take a few minutes or more to execute.
25+
26+
Merging records with a large number of related activities or other entity types can also take a long time to update all the related records, so executing these in the background can improve the user experience.
2527

2628
> [!NOTE]
27-
> <xref:Microsoft.Crm.Sdk.Messages.ImportSolutionRequest> and <xref:Microsoft.Crm.Sdk.Messages.DeleteAndPromoteRequest> are the only request classes that can be used with the `ExecuteAsync` message.
29+
> <xref:Microsoft.Crm.Sdk.Messages.ImportSolutionRequest>, <xref:Microsoft.Crm.Sdk.Messages.DeleteAndPromoteRequest>, and <xref:Microsoft.Crm.Sdk.Messages.MergeRequest> are the only request classes that can be used with <xref:Microsoft.Xrm.Sdk.Messages.ExecuteAsyncRequest>.
2830
2931
Use the <xref:Microsoft.Xrm.Sdk.Messages.ExecuteAsyncRequest> request class to execute a message asynchronously. You configure the request and pass the request instance as an argument to <xref:Microsoft.Xrm.Sdk.IOrganizationService>.<xref:Microsoft.Xrm.Sdk.IOrganizationService.Execute*>. <xref:Microsoft.Xrm.Sdk.Messages.ExecuteAsyncResponse> returns with the ID of the asynchronous job. You can (optionally) query the job using the ID to find out its current state.
3032

@@ -64,4 +66,4 @@ You can then poll the [AsyncOperation](../reference/entities/asyncoperation.md)
6466
[Execute multiple requests using the Organization service](execute-multiple-requests.md)
6567

6668

67-
69+

powerapps-docs/developer/common-data-service/org-service/use-messages.md

Lines changed: 31 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
title: "Use messages with the Organization service (Common Data Service) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
33
description: "Understand how messages are used to invoke operations using the organization service." # 115-145 characters including spaces. This abstract displays in the search result.
44
ms.custom: ""
5-
ms.date: 10/31/2018
5+
ms.date: 09/11/2020
66
ms.reviewer: "pehecke"
77
ms.service: powerapps
88
ms.topic: "article"
99
author: "JimDaly" # GitHub ID
10-
ms.author: "jdaly" # MSFT alias of Microsoft employees only
11-
manager: "ryjones" # MSFT alias of manager or PM counterpart
10+
ms.author: "pehecke" # MSFT alias of Microsoft employees only
11+
manager: "sunilg" # MSFT alias of manager or PM counterpart
1212
search.audienceType:
1313
- developer
1414
search.app:
@@ -87,7 +87,8 @@ You can pass optional parameters in messages using the <xref:Microsoft.Xrm.Sdk.O
8787
|Parameter|Description|Messages|
8888
|-----------------|-----------------|--------------|
8989
|`SolutionUniqueName`|A `String` that specifies the unique name of the solution to which the operation applies. More information: [Dependency tracking for solution components](../dependency-tracking-solution-components.md).|<xref:Microsoft.Crm.Sdk.Messages.AddPrivilegesRoleRequest> <br /> <xref:Microsoft.Xrm.Sdk.Messages.CreateRequest> <br /> <xref:Microsoft.Xrm.Sdk.Messages.DeleteRequest> <br /> <xref:Microsoft.Crm.Sdk.Messages.MakeAvailableToOrganizationTemplateRequest> <br /> <xref:Microsoft.Xrm.Sdk.Messages.UpdateRequest>|
90-
|`SuppressDuplicateDetection`|A `Boolean` used to disable duplicate detection on a create or update operation. More information: [Use SuppressDuplicateDetection parameter to throw errors when you create or update record](detect-duplicate-data.md#use-suppressduplicatedetection-parameter-to-throw-errors-when-you-create-or-update-record) .|<xref:Microsoft.Xrm.Sdk.Messages.CreateRequest> <br /> <xref:Microsoft.Xrm.Sdk.Messages.UpdateRequest>|
90+
|`SuppressDuplicateDetection`|A `Boolean` used to disable duplicate detection on a create or update operation. More information: [Use SuppressDuplicateDetection parameter to throw errors when you create or update record](detect-duplicate-data.md#use-suppressduplicatedetection-parameter-to-throw-errors-when-you-create-or-update-record) .|<xref:Microsoft.Xrm.Sdk.Messages.CreateRequest> <br /> <xref:Microsoft.Xrm.Sdk.Messages.UpdateRequest>|
91+
|`tag`|A value to include within the `ExecutionContext` `SharedVariables` collection. |Any message that can have a plug-in step registered. More information: [Add a Shared Variable from the Organization Service](#add-a-shared-variable-from-the-organization-service)|
9192

9293
The following sample shows how to pass an optional parameter:
9394

@@ -100,6 +101,32 @@ req["SuppressDuplicateDetection"] = true;
100101
CreateResponse response = (CreateResponse)svc.Execute(req);
101102
```
102103

104+
### Add a Shared Variable from the Organization Service
105+
106+
You can set a string value that will be available to plug-ins within the ExecutionContext in the `SharedVariables` collection. More information: [Shared variables](../understand-the-data-context.md#shared-variables)
107+
108+
```csharp
109+
var account = new Entity("account");
110+
account["name"] = "Contoso";
111+
112+
var request = new CreateRequest() { Target = account };
113+
request["tag"] = "This is a value passed.";
114+
115+
var response = (CreateResponse)svc.Execute(request);
116+
```
117+
118+
119+
Will result in the following value within the `SharedVariables` collection when sent using a webhook.
120+
121+
```json
122+
{
123+
"key": "tag",
124+
"value": "This is a value passed."
125+
}
126+
```
127+
128+
This can also be done using the Web API: [Add a Shared Variable from the Web API](../webapi/compose-http-requests-handle-errors.md#add-a-shared-variable-from-the-web-api)
129+
103130
### See also
104131

105132
[Entity Operations using the Organization service](entity-operations.md)<br />

0 commit comments

Comments
 (0)