Skip to content

Commit c2d142b

Browse files
committed
Updated to current features
1 parent 90a3975 commit c2d142b

File tree

2 files changed

+17
-15
lines changed

2 files changed

+17
-15
lines changed

powerapps-docs/developer/data-platform/download-tools-nuget.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Dataverse development tools (Microsoft Dataverse) | Microsoft Docs"
33
description: "Download and launch the Plug-in Registration, Package Deployment, and other Dataverse development tools."
4-
ms.date: 10/13/2022
4+
ms.date: 12/21/2022
55
ms.reviewer: pehecke
66
ms.topic: article
77
applies_to:
@@ -26,13 +26,15 @@ There are a number of developer tools that are needed for different aspects of M
2626
|Package Deployer (PD)|Deploy packages to Dataverse environments where the packages contain solutions, custom code, HTML files, and more|[Deploy a package](/power-platform/alm/package-deployer-tool#deploy-a-package)|
2727
|Plug-in Registration tool (PRT)|Registers custom code (plug-ins, custom workflow activities), service endpoints, and more|[Register a plug-in](register-plug-in.md)|
2828
|SolutionPackager tool (SP)|A tool that can reversibly decompose a Dataverse compressed solution file into multiple XML files and other files so that these files can be easily managed by a source control system|[SolutionPackager tool](/power-platform/alm/solution-packager-tool?branch=phecke-package-deployer)|
29-
|Code Generation tool (CG)|A command-line code generation tool that generates early-bound (strong-typed) .NET classes that represent the Entity Data Model (EDM) used by Dataverse|[Generate early-bound classes for the Organization service](org-service/generate-early-bound-classes.md)|
29+
|Code Generation tool (CG)|A command-line code generation tool that generates early-bound (strong-typed) .NET Framework classes that represent the Entity Data Model (EDM) used by Dataverse|[Generate early-bound classes for the Organization service](org-service/generate-early-bound-classes.md)|
3030

31-
All the above mentioned tools, with the exception of the Code Generation tool, is described below. The Code Generation tool functionality is planned to be integrated into the Power Platform CLI in a future release. For now, follow the provided Code Generation tool link in the table above for more information on installing and using that tool.
31+
The Code Generation tool functionality has been integrated into the Power Platform CLI. The output of the CLI [modelbuilder](/power-platform/developer/cli/reference/modelbuilder) subcommand supports cross-platform .NET (Core) compilation.
3232

3333
> [!NOTE]
3434
> The CMT, PD, and PRT tools provide a Windows (WPF) user interface and only run on a Microsoft Windows operating system. Also, the `pac tool` command only is available on a Windows install of the CLI.
3535
36+
All the above mentioned tools, with the exception of the Code Generation tool, is described below.
37+
3638
## Download and launch tools using Power Platform CLI
3739

3840
Make sure that you have version 1.19.3 (or newer) of the Power Platform CLI. Now get help on the tools.

powerapps-docs/developer/data-platform/org-service/generate-early-bound-classes.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Generate early-bound classes for the Organization service (Microsoft Dataverse) | Microsoft Docs" # Intent and product brand in a unique string of 43-59 chars including spaces
33
description: "Learn about a command-line code generation tool for use with Microsoft Dataverse. This tool generates early-bound .NET Framework classes that represent the Entity Data Model used by Dataverse." # 115-145 characters including spaces. This abstract displays in the search result.
4-
ms.date: 12/21/2022
4+
ms.date: 12/22/2022
55
author: kkanakas
66
ms.author: kartikka
77
manager: pemikkel
@@ -21,41 +21,41 @@ contributors:
2121

2222
[!INCLUDE[cc-terminology](../includes/cc-terminology.md)]
2323

24-
*CrmSvcUtil* is a command-line code generation tool for use with Microsoft Dataverse. The tool generates early-bound .NET Framework classes that represent the Entity Data Model (EDM) used by Dataverse.
24+
*CrmSvcUtil* is a command-line code generation tool for use with Microsoft Dataverse. The tool generates early-bound .NET Framework classes that represent the Entity Data Model (EDM) used by Dataverse. To generate cross-platform .NET (Core) classes, use the [modelbuilder](/power-platform/developer/cli/reference/modelbuilder) argument of Power Platform CLI.
2525

2626
The code generation tool (CrmSvcUtil.exe) is distributed as part of the [Microsoft.CrmSdk.CoreTools](https://www.nuget.org/packages/Microsoft.CrmSdk.CoreTools) NuGet package. You can download the NuGet package, rename the file's extension .nupkg to .zip, and extract the files. You may also need to unblock the file in the Properties dialog of File Explorer.
2727

2828
> [!NOTE]
29-
> For information about downloading the code generation tool, see [Dataverse development tools](../download-tools-NuGet.md).
29+
> For more information about available tools, including the code generation tool, see [Dataverse development tools](../download-tools-NuGet.md).
3030
3131
## Generate Entity classes
3232

33-
The CrmSvcUtil tool creates a Microsoft Visual C# or Visual Basic .NET output file that contains strongly-typed classes for tables in your organization. This includes custom tables and columns. This output file contains one class derived from <xref:Microsoft.Xrm.Sdk.Entity> for each table, providing early binding and IntelliSense support in Visual Studio to aid you as you write code. The generated classes are partial classes that can be extended with custom business logic in separate files. You can also create extensions to this tool. For more information, see [Create extensions for the Code Generation Tool](extend-code-generation-tool.md).
33+
The CrmSvcUtil tool creates a Microsoft Visual C# or Visual Basic .NET output file that contains strongly-typed classes for tables in your environment. This includes custom tables and columns. This output file contains one class derived from <xref:Microsoft.Xrm.Sdk.Entity> for each table, providing early binding and IntelliSense support in Visual Studio to aid you as you write code. The generated classes are partial classes that can be extended with custom business logic in separate files. You can also write extensions for this tool to customize its functionality. For more information, see [Create extensions for the Code Generation Tool](extend-code-generation-tool.md).
3434

3535
## Generate an OrganizationServiceContext class
3636

3737
The tool can also be used to generate a class derived from the <xref:Microsoft.Xrm.Sdk.Client.OrganizationServiceContext> class that acts as an entity container in the EDM. This service context provides the facilities for tracking changes and managing identities, concurrency, and relationships. This class also exposes a <xref:Microsoft.Xrm.Sdk.Client.OrganizationServiceContext.SaveChanges> method that writes inserts, updates, and deletes table rows in Dataverse. For more information, see [Use OrganizationServiceContext](organizationservicecontext.md).
3838

3939
## Use generated classes
4040

41-
The classes created by the code generation tool are designed to be built into a class library that can be referenced by projects that use Dataverse. After you have generated the class file using the tool, you should add the file to your Visual Studio project. You must also add references to several assemblies that the generated classes are dependent upon.
41+
The classes created by the code generation tool are designed to be built into a class library that can be referenced by projects that use Dataverse. After you have generated the class file(s) using the tool, you should add the file(s) to your Visual Studio project. You must also add references to several assemblies that the generated classes are dependent upon.
4242

4343
The following lists assemblies that must be referenced in your project when you use the generated code file.
4444

4545
- `Microsoft.Crm.Sdk.Proxy.dll`
4646
- `Microsoft.Xrm.Sdk.dll`
4747

48-
These assemblies are part of the [Microsoft.CrmSdk.CoreAssemblies](https://www.nuget.org/packages/Microsoft.CrmSdk.CoreAssemblies/) NuGet package. Use this NuGet packages to add these assemblies to your Visual Studio project.
48+
These assemblies are part of the [Microsoft.CrmSdk.CoreAssemblies](https://www.nuget.org/packages/Microsoft.CrmSdk.CoreAssemblies/) or [Microsoft.PowerPlatform.Dataverse.Client](https://www.nuget.org/packages/Microsoft.PowerPlatform.Dataverse.Client) NuGet package. Use one of these NuGet packages to add the required assemblies to your Visual Studio project.
4949

5050
<a name="bkmk_RuntheCodeGenerationUtility"></a>
5151

5252
## Run the code generation tool
5353

5454
The code generation tool takes several parameters that determine the contents of the file that is created. The parameters can be passed in from the command line when you run the tool or in a .NET-connected application configuration file.
5555

56-
Run the `CrmSvcUtil.exe` tool from the `Tools\CoreTools` folder created when you downloaded the tools using the script described in [Dataverse development tools](../download-tools-NuGet.md). If you run the tool from another folder ___location, make sure that a copy of the `Microsoft.Xrm.Sdk.dll` assembly is in that same folder.
56+
Run the `CrmSvcUtil.exe` application from the folder where it is installed. If you run the tool from another folder ___location, make sure that a copy of the `Microsoft.Xrm.Sdk.dll` assembly is in that same folder.
5757

58-
The following sample shows the format for running the tool from the command line with Dataverse. To use the interactive login, you can simply provide these options:
58+
The following sample shows the format for running the tool from the command line with Dataverse. To use an interactive environment login, you can simply provide these options:
5959

6060
```ms-dos
6161
CrmSvcUtil.exe /interactivelogin ^
@@ -94,8 +94,8 @@ CrmSvcUtil.exe ^
9494
> [!NOTE]
9595
> The examples above uses the carat (`^`) character to break up the list of parameters for readability. You can compose the command parameters with arguments using notepad and then paste it into the command line.
9696
97-
- For the `username` and `password` parameters, type the user name and password that is used to sign in to Dataverse.
98-
- For the `url` parameter, you can look up the correct URL in the web application by selecting **Settings**, navigating to **Customizations**, and then choosing **Developer Resources**. The URL is shown under **Organization Service**.
97+
- For the `username` and `password` parameters, type the user name and password that is used to sign in to your Dataverse environment.
98+
- For the `url` parameter you can look up the correct URL in Power Apps, or in the legacy web application by selecting **Settings**, navigating to **Customizations**, and then choosing **Developer Resources**. The URL is shown under **Organization Service**.
9999

100100
To view the latest supported command-line parameters, use the following command.
101101

@@ -107,7 +107,7 @@ CrmSvcUtil.exe /?
107107

108108
## Parameters
109109

110-
The following table lists the code generation tool parameters and a gives a brief description of their use.
110+
The following table lists the code generation tool parameters at the time when this topic was last updated, and provides a brief description of command parameter use.
111111

112112
|Parameter|Shortcut|Description|
113113
|--|--|--|
@@ -175,7 +175,7 @@ For more information on supported tracing options see [Configure tracing for XRM
175175

176176
## Community tools
177177

178-
**Early Bound Generator** is a tool that XrmToolbox community. Please see the [Developer tools and resources](../developer-tools.md) topic for more community developed tools.
178+
**Early Bound Generator** is a tool from the XrmToolbox community. Please see the [Developer tools and resources](../developer-tools.md) topic for more community developed tools.
179179

180180
> [!NOTE]
181181
> The community tools are not a product of Microsoft and does not extend support to the community tools.

0 commit comments

Comments
 (0)