Skip to content

Commit a7c3ab9

Browse files
authored
Live publish
2 parents e8e1f45 + c049208 commit a7c3ab9

File tree

46 files changed

+357
-338
lines changed

Some content is hidden

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

46 files changed

+357
-338
lines changed

powerapps-docs/developer/data-platform/xrm-tooling/build-windows-client-applications-xrm-tools.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,6 @@ search.app:
2323
---
2424
# Build Windows client applications using the XRM tools
2525

26-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
27-
2826
XRM tooling is a set of APIs built on top of the Microsoft Dataverse assembly APIs (Organization service and Discovery service) that provide support for building Windows client applications for Dataverse. It provides the following capabilities:
2927

3028
- Supports all the authentication modes to sign in to Dataverse instance.

powerapps-docs/developer/data-platform/xrm-tooling/configure-tracing-xrm-tooling.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,6 @@ search.app:
2323
---
2424
# Configure tracing for XRM tooling
2525

26-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
27-
2826
You can enable tracing to record data related to process milestones across all components of XRM tooling, such as operation calls, warnings, exceptions, and other significant events. This information can be used for troubleshooting operational and performance issues in your Windows client applications. Tracing in XRM tooling is built on top of [System.Diagnostics.Tracing](/dotnet/api/system.diagnostics.tracing). To enable tracing for an assembly or component, for example Microsoft.Xrm.Tooling.Connector, you must define the following three things for each component in your code or in the application configuration file (*\<AppName>*.exe.config):
2927

3028
- A trace source

powerapps-docs/developer/data-platform/xrm-tooling/sample-quick-start-xrm-tooling-api.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: "Sample: Quick start for XRM Tooling API (Microsoft Dataverse)| Microsoft Docs"
3-
description: ""
3+
description: "This code sample demonstrates how to connect to a Microsoft Dataverse environment by using the XRM Tooling APIs, and then perform basic create, update, retrieve, and delete operations on a table"
44
ms.custom: ""
5-
ms.date: 03/27/2019
5+
ms.date: 04/12/2021
66
ms.reviewer: "pehecke"
77
ms.service: powerapps
88
ms.suite: ""
@@ -23,9 +23,9 @@ search.app:
2323
---
2424
# Sample: Quick start for XRM Tooling API
2525

26-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
26+
[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
2727

28-
The QuickStart sample is a .NET Framework managed code sample that shows how to connect to a Microsoft Dataverse instance by using the XRM Tooling APIs, and perform basic create, update, retrieve, and delete operations on an entity. For more information about XRM Tooling, see [Build windows client applications using the XRM tools](build-windows-client-applications-xrm-tools.md).
28+
The QuickStart sample is a .NET Framework managed code sample that shows how to connect to a Microsoft Dataverse instance by using the XRM Tooling APIs, and perform basic create, update, retrieve, and delete operations on a table. For more information about XRM Tooling, see [Build windows client applications using the XRM tools](build-windows-client-applications-xrm-tools.md).
2929

3030
Download the sample: [Work with XRM Tooling API](https://github.com/microsoft/PowerApps-Samples/tree/master/cds/Xrm%20Tooling/Quick%20start%20for%20XRM%20Tooling%20API)
3131

@@ -40,7 +40,7 @@ Download the sample: [Work with XRM Tooling API](https://github.com/microsoft/Po
4040

4141
- The sample code is built using the **WPF Application for CRM** SDK template that provides a common login control with built-in support for authentication and credential caching and reuse. For more information about the common login control and how to use the SDK template in Visual Studio, see [Use the XRM Tooling common login control](use-xrm-tooling-common-login-control-client-applications.md).
4242
- No helper code is used to establish a connection to Dataverse.
43-
- After connecting to Dataverse, the sample performs basic create, update, retrieve, and delete operations on an account entity.
43+
- After connecting to Dataverse, the sample performs basic create, update, retrieve, and delete operations on an account table.
4444
- Stores user credentials in a configuration file (`Default_QuickStartXRMToolingWPFClient.exe.config`) in the `c:\Users\`*`<username>`*`\AppData\Roaming\Microsoft\QuickStartXRMToolingWPFClient` folder when the sample is run for the first time, and thereafter prompts the user to either use the stored or specify new credentials at runtime to sign in to Dataverse.
4545
- Generates the following log files, if any issue occurs, to aid troubleshooting:
4646
- Login_ErrorLog.log: To report sign-in errors. This file is available at `C:\Users\`*`<username>`*`\AppData\Roaming\Microsoft\QuickStartXRMToolingWPFClient`.

powerapps-docs/developer/data-platform/xrm-tooling/sample-simplified-connection-quick-start.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: "Sample: Simplified connection quick start (Developer Guide for Microsoft Dataverse) | MicrosoftDocs"
3-
description: "This sample shows you how to connect to the Microsoft Dataverse web services using the CrmServiceClient and perform basic create, update, retrieve, and delete operations on an entity. "
3+
description: "This sample shows you how to connect to the Microsoft Dataverse web services using the CrmServiceClient and perform basic create, update, retrieve, and delete operations on a table. "
44
ms.custom:
5-
ms.date: 03/27/2019
5+
ms.date: 04/12/2021
66
author: Nkrb
77
ms.service: powerapps
88
ms.suite:
@@ -22,9 +22,9 @@ search.app:
2222
---
2323
# Sample: Simplified connection quick start using Microsoft Dataverse
2424

25-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
25+
[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
2626

27-
This sample shows how to connect to the Dataverse web services using the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient> and perform basic create, update, retrieve, and delete operations on an entity. For more information about the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient>, see [Use CrmServiceClient constructors to connect to Dataverse](use-crmserviceclient-constructors-connect.md).
27+
This sample shows how to connect to the Dataverse web services using the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient> and perform basic create, update, retrieve, and delete operations on a table. For more information about the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient>, see [Use CrmServiceClient constructors to connect to Dataverse](use-crmserviceclient-constructors-connect.md).
2828

2929
## Requirements
3030

@@ -34,13 +34,13 @@ You must modify the `app.config` file with connection information for your Datav
3434

3535
## Demonstrates
3636

37-
This sample authenticates the user with the Dataverse web services by using the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient> and methods. After obtaining a reference to the Organization web service, the sample performs basic create, update, retrieve, and delete operations on an `account` entity. The sample also handles common exceptions. No helper code is used to establish a connection to the Organization web service.
37+
This sample authenticates the user with the Dataverse web services by using the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient> and methods. After obtaining a reference to the Organization web service, the sample performs basic create, update, retrieve, and delete operations on an `account` table. The sample also handles common exceptions. No helper code is used to establish a connection to the Organization web service.
3838

3939
In addition, this sample supports `OAuth` authentication and advanced connection diagnostics. For more information on using diagnostics, see [Configure tracing for XRM Tooling](configure-tracing-xrm-tooling.md).
4040

4141
## Example
4242

43-
The following shows a sample `app.config file`. To use this, remove the comment characters “<!- -” at the beginning of the \<add … /> line and the “- ->” at the end on the line for the line that is relevant to your server and organization. Next, modify the attribute values as appropriate for your configuration.
43+
The following shows a sample `app.config file`. To use this, remove the comment characters “<!- -” at the beginning of the \<add … /> line and the “- ->” at the end on the line for the line that is relevant to your server and organization. Next, modify the data values as appropriate for your configuration.
4444

4545
```xml
4646
<?xml version="1.0" encoding="utf-8"?>

powerapps-docs/developer/data-platform/xrm-tooling/sample-tpl-crmserviceclient.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Sample: Task Parallel Library with CrmServiceClient (Microsoft Dataverse)| Microsoft Docs"
33
description: "Task Parallel Library (TPL) makes developers more productive by simplifying the process of adding parallelism and concurrency to applications. This sample demonstrates using this with CrmServiceClient"
44
ms.custom: ""
5-
ms.date: 04/20/2020
5+
ms.date: 04/12/2021
66
ms.reviewer: "pehecke"
77
ms.service: powerapps
88
ms.suite: ""
@@ -21,7 +21,7 @@ search.app:
2121
---
2222
# Sample: Task Parallel Library with CrmServiceClient
2323

24-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
24+
[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
2525

2626
Task Parallel Library (TPL) makes developers more productive by simplifying the process of adding parallelism and concurrency to applications.
2727

@@ -43,9 +43,9 @@ More information: [Service Protection API Limits](../api-limits.md)
4343

4444
The [CrmServiceClient.Clone Method](/dotnet/api/microsoft.xrm.tooling.connector.crmserviceclient.clone) enables TPL to use the client with multiple threads.
4545

46-
This simple sample will generate a number of account entity records using the [System.Threading.Tasks.Parallel.ForEach Method](/dotnet/api/system.threading.tasks.parallel.foreach).
46+
This simple sample will generate a number of account table records using the [System.Threading.Tasks.Parallel.ForEach Method](/dotnet/api/system.threading.tasks.parallel.foreach).
4747

48-
Then it will use that technique again to delete the entities created.
48+
Then it will use that technique again to delete the tables created.
4949

5050
**NOTE**:
5151
> By default, this sample will create only 10 records, which is not enough to hit the service protection api limit errors. If you raise the `numberOfRecords` variable value to 10000, you can use Fiddler to observe how some of the requests will be rejected and re-tried.
@@ -278,5 +278,4 @@ private static void DeleteEntities(CrmServiceClient svc, List<EntityReference> e
278278

279279
[Task Parallel Library (TPL)](/dotnet/standard/parallel-programming/task-parallel-library-tpl)
280280

281-
282281
[!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/developer/data-platform/xrm-tooling/use-connection-strings-xrm-tooling-connect.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,6 @@ search.app:
1717
---
1818
# Use connection strings in XRM tooling to connect to Microsoft Dataverse
1919

20-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
21-
2220
With Dataverse, XRM tooling enables you to connect to your Dataverse environment by using connection strings. This is similar to the concept of connection strings used with **SQL Server**. Connection strings have native support in configuration files, including the ability to encrypt the configuration sections for maximum security. This enables you to configure Dataverse connections at deployment time, and not hard code in your application to connect to your Dataverse environment.
2321

2422

powerapps-docs/developer/data-platform/xrm-tooling/use-crmserviceclient-constructors-connect.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,15 +23,12 @@ search.app:
2323
---
2424
# Use CrmServiceClient constructors to connect to Microsoft Dataverse
2525

26-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
27-
2826
Use the various constructors to create an instance of the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient> class to connect to Dataverse. More information: [CrmServiceClient Constructors](/dotnet/api/microsoft.xrm.tooling.connector.crmserviceclient.-ctor)
2927

3028
The [connection string](/dotnet/api/microsoft.xrm.tooling.connector.crmserviceclient.-ctor?view=dynamics-xrmtooling-ce-9#Microsoft_Xrm_Tooling_Connector_CrmServiceClient__ctor_System_String_) constructor is the most easy, convenient way to get an instance of the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient> class. More information: [Use connection strings in XRM tooling to connect to Dataverse](use-connection-strings-xrm-tooling-connect.md)
3129

3230
## See also
3331

34-
[Use XRM Tooling Windows PowerShell Cmdlets to connect to Dataverse](use-powershell-cmdlets-xrm-tooling-connect.md)
35-
32+
[Use XRM Tooling Windows PowerShell Cmdlets to connect to Dataverse](use-powershell-cmdlets-xrm-tooling-connect.md)
3633

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

powerapps-docs/developer/data-platform/xrm-tooling/use-messages-executecrmorganizationrequest-method.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Use messages with the ExecuteCrmOrganizationRequest method (Microsoft Dataverse)| Microsoft Docs"
33
description: "Learn how to use messages with the ExecuteCrmOrganizationRequest method. The samples demonstrate how to execute CreateRequest and RetrieveMultipleRequest message using the CrmServiceClient.String) method."
44
ms.custom: ""
5-
ms.date: 03/27/2019
5+
ms.date: 04/12/2021
66
ms.reviewer: "pehecke"
77
ms.service: powerapps
88
ms.suite: ""
@@ -23,7 +23,7 @@ search.app:
2323
---
2424
# Use messages with the ExecuteCrmOrganizationRequest method
2525

26-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
26+
[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
2727

2828
The following code samples demonstrate how you can execute messages using the <xref:Microsoft.Xrm.Tooling.Connector.CrmServiceClient.ExecuteCrmOrganizationRequest*> method.
2929

powerapps-docs/developer/data-platform/xrm-tooling/use-powershell-cmdlets-xrm-tooling-connect.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,6 @@ search.app:
1919
---
2020
# Use PowerShell cmdlets for XRM tooling to connect to Microsoft Dataverse
2121

22-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
23-
2422
XRM tooling provides you with the following **Windows PowerShell** cmdlets that you can use to connect to Dataverse and retrieve organizations that the current user has access to: `Get-CrmConnection` and `Get-CrmOrganizations`.
2523

2624

powerapps-docs/developer/data-platform/xrm-tooling/use-xrm-tooling-common-login-control-client-applications.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,6 @@ search.app:
2323
---
2424
# Use the XRM tooling common login control in your client applications
2525

26-
[!INCLUDE[cc-data-platform-banner](../../../includes/cc-data-platform-banner.md)]
27-
2826
There is a template for Visual Studio that enables you to use the common login control in your client applications. The code for Microsoft Dataverse authentication, credential storage and retrieval, and diagnostic logging is built into the template so that you can quickly leverage these capabilities in your Windows client applications for Dataverse. The common login control is an implementation of the <xref:Microsoft.Xrm.Tooling.CrmConnectControl>, and the control resembles the following image.
2927

3028
![XRM Tooling common login control](../media/crm-sdk-v6-commonlogincontrol.png "XRM Tooling common login control")

0 commit comments

Comments
 (0)