Microsoft.PowerPlatform.Dataverse.Client
0.4.6
Prefix Reserved
See the version list below for details.
dotnet add package Microsoft.PowerPlatform.Dataverse.Client --version 0.4.6
NuGet\Install-Package Microsoft.PowerPlatform.Dataverse.Client -Version 0.4.6
<PackageReference Include="Microsoft.PowerPlatform.Dataverse.Client" Version="0.4.6" />
paket add Microsoft.PowerPlatform.Dataverse.Client --version 0.4.6
#r "nuget: Microsoft.PowerPlatform.Dataverse.Client, 0.4.6"
// Install Microsoft.PowerPlatform.Dataverse.Client as a Cake Addin #addin nuget:?package=Microsoft.PowerPlatform.Dataverse.Client&version=0.4.6 // Install Microsoft.PowerPlatform.Dataverse.Client as a Cake Tool #tool nuget:?package=Microsoft.PowerPlatform.Dataverse.Client&version=0.4.6
This package contains the preview of the .net core Dataverse ServiceClient. Used to connect to Microsoft Dataverse. This Package has been authored by the Microsoft Dataverse SDK team.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp3.0 is compatible. netcoreapp3.1 is compatible. |
.NET Framework | net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 is compatible. net48 is compatible. net481 was computed. |
-
.NETCoreApp 3.0
- Microsoft.Extensions.DependencyInjection (>= 3.1.8)
- Microsoft.Extensions.Http (>= 3.1.8)
- Microsoft.Extensions.Logging (>= 3.1.8)
- Microsoft.Identity.Client (>= 4.25.0)
- Microsoft.Rest.ClientRuntime (>= 2.3.20)
- Microsoft.VisualBasic (>= 10.3.0)
- Newtonsoft.Json (>= 10.0.3)
- System.Collections (>= 4.3.0)
- System.Configuration.ConfigurationManager (>= 4.7.0)
- System.Globalization (>= 4.3.0)
- System.Linq (>= 4.3.0)
- System.Linq.Expressions (>= 4.3.0)
- System.Private.DataContractSerialization (>= 4.3.0)
- System.Reflection (>= 4.3.0)
- System.Reflection.Extensions (>= 4.3.0)
- System.Reflection.TypeExtensions (>= 4.7.0)
- System.Runtime.Caching (>= 4.7.0)
- System.Runtime.Serialization.Primitives (>= 4.3.0)
- System.Runtime.Serialization.Xml (>= 4.3.0)
- System.Security.Cryptography.Algorithms (>= 4.3.1)
- System.Security.Cryptography.ProtectedData (>= 4.7.0)
- System.Security.Permissions (>= 4.7.0)
- System.ServiceModel.Duplex (>= 4.7.0)
- System.ServiceModel.Http (>= 4.7.0)
- System.ServiceModel.Primitives (>= 4.7.0)
-
.NETCoreApp 3.1
- Microsoft.Extensions.DependencyInjection (>= 3.1.8)
- Microsoft.Extensions.Http (>= 3.1.8)
- Microsoft.Extensions.Logging (>= 3.1.8)
- Microsoft.Identity.Client (>= 4.25.0)
- Microsoft.Rest.ClientRuntime (>= 2.3.20)
- Microsoft.VisualBasic (>= 10.3.0)
- Newtonsoft.Json (>= 10.0.3)
- System.Collections (>= 4.3.0)
- System.Configuration.ConfigurationManager (>= 4.7.0)
- System.Globalization (>= 4.3.0)
- System.Linq (>= 4.3.0)
- System.Linq.Expressions (>= 4.3.0)
- System.Private.DataContractSerialization (>= 4.3.0)
- System.Reflection (>= 4.3.0)
- System.Reflection.Extensions (>= 4.3.0)
- System.Reflection.TypeExtensions (>= 4.7.0)
- System.Runtime.Caching (>= 4.7.0)
- System.Runtime.Serialization.Primitives (>= 4.3.0)
- System.Runtime.Serialization.Xml (>= 4.3.0)
- System.Security.Cryptography.Algorithms (>= 4.3.1)
- System.Security.Cryptography.ProtectedData (>= 4.7.0)
- System.Security.Permissions (>= 4.7.0)
- System.ServiceModel.Duplex (>= 4.7.0)
- System.ServiceModel.Http (>= 4.7.0)
- System.ServiceModel.Primitives (>= 4.7.0)
-
.NETFramework 4.6.2
- Microsoft.Extensions.DependencyInjection (>= 3.1.8)
- Microsoft.Extensions.Http (>= 3.1.8)
- Microsoft.Extensions.Logging (>= 3.1.8)
- Microsoft.Identity.Client (>= 4.25.0)
- Microsoft.Rest.ClientRuntime (>= 2.3.20)
- Newtonsoft.Json (>= 10.0.3)
-
.NETFramework 4.7.2
- Microsoft.Extensions.DependencyInjection (>= 3.1.8)
- Microsoft.Extensions.Http (>= 3.1.8)
- Microsoft.Extensions.Logging (>= 3.1.8)
- Microsoft.Identity.Client (>= 4.25.0)
- Microsoft.Rest.ClientRuntime (>= 2.3.20)
- Newtonsoft.Json (>= 10.0.3)
-
.NETFramework 4.8
- Microsoft.Extensions.DependencyInjection (>= 3.1.8)
- Microsoft.Extensions.Http (>= 3.1.8)
- Microsoft.Extensions.Logging (>= 3.1.8)
- Microsoft.Identity.Client (>= 4.25.0)
- Microsoft.Rest.ClientRuntime (>= 2.3.20)
- Newtonsoft.Json (>= 10.0.3)
NuGet packages (94)
Showing the top 5 NuGet packages that depend on Microsoft.PowerPlatform.Dataverse.Client:
Package | Downloads |
---|---|
Microsoft.PowerPlatform.Dataverse.Client.Dynamics
This package contains a set of Dynamics 365 specific extensions, used with the Dataverse ServiceClient. This Package has been authored by the Microsoft Dataverse SDK team. |
|
Rystem.RepositoryFramework.Infrastructure.Dynamics.Dataverse
Rystem.RepositoryFramework allows you to use correctly concepts like repository pattern, CQRS and DDD. You have interfaces for your domains, auto-generated api, auto-generated HttpClient to simplify connection "api to front-end", a functionality for auto-population in memory of your models, a functionality to simulate exceptions and waiting time from external sources to improve your implementation/business test and load test. |
|
Microsoft.Dynamics.Sdk.Messages
This package contains the preview of the .net core Dynamics Messages Assembly. Used to issue commands to Dynamics Applications Installed on Microsoft Dataverse. This Package has been authored by the Microsoft Dataverse SDK team. |
|
FakeXrmEasy.Abstractions.v9
FakeXrmEasy is the open source test automation framework for .net core and the Power Platform / Dataverse. This is an abstractions package containing only interfaces. |
|
FakeXrmEasy.Core.v9
FakeXrmEasy is the open source test automation framework for .net core and the Power Platform. This is the core package containing a configurable middleware, crud operators, and query translation between FetchXml, QueryExpression, CRM LINQ, and QueryByAttribute. |
GitHub repositories (4)
Showing the top 4 popular GitHub repositories that depend on Microsoft.PowerPlatform.Dataverse.Client:
Repository | Stars |
---|---|
microsoft/PowerApps-Samples
Sample code for Power Apps, including Dataverse, model-driven apps, canvas apps, Power Apps component framework, portals, and AI Builder.
|
|
Avanade/Liquid-Application-Framework
Liquid Application Framework documentation, useful links and sample project
|
|
microsoft/PowerPlatform-DataverseServiceClient
Code Replica for Microsoft.PowerPlatform.Dataverse.Client and supporting nuget packages.
|
|
neronotte/Greg.Xrm.Command
Command Line utility for Dataverse
|
Version | Downloads | Last updated |
---|---|---|
1.2.2 | 82,248 | 11/7/2024 |
1.1.32 | 529,531 | 8/10/2024 |
1.1.27 | 169,177 | 7/10/2024 |
1.1.22 | 251,100 | 4/25/2024 |
1.1.17 | 430,134 | 1/8/2024 |
1.1.16 | 215,604 | 11/8/2023 |
1.1.14 | 359,293 | 8/24/2023 |
1.1.12 | 164,911 | 7/14/2023 |
1.1.9 | 164,711 | 6/8/2023 |
1.0.39 | 806,810 | 3/13/2023 |
1.0.26 | 484,373 | 11/4/2022 |
1.0.23 | 102,774 | 10/10/2022 |
1.0.9 | 278,759 | 7/19/2022 |
1.0.4 | 40,535 | 7/7/2022 |
1.0.1 | 383,906 | 6/13/2022 |
0.6.6 | 138,839 | 4/25/2022 |
0.6.1 | 203,238 | 3/9/2022 |
0.5.17 | 223,581 | 1/7/2022 |
0.5.10 | 194,625 | 10/22/2021 |
0.5.7 | 79,937 | 10/15/2021 |
0.5.5 | 20,465 | 10/5/2021 |
0.5.4 | 2,020 | 10/4/2021 |
0.5.2 | 42,241 | 9/24/2021 |
0.4.21 | 84,242 | 8/17/2021 |
0.4.20 | 21,680 | 7/30/2021 |
0.4.19 | 9,053 | 7/27/2021 |
0.4.12 | 132,882 | 4/28/2021 |
0.4.11 | 33,448 | 4/13/2021 |
0.4.6 | 20,654 | 3/25/2021 |
0.4.4 | 22,077 | 3/8/2021 |
0.4.3 | 39,961 | 3/5/2021 |
Notice:
This package is in a public ALPHA release.
This package is intended to work with .net full framework 4.6.2, 4.7.2 and 4.8, .net core 3.0, 3.1 and 5.0
We have not stabilized on NameSpace or Class names with this package as of yet and things will change as we move though the preview.
General Documentation is the same as CrmServiceClient and can be found here:
https://docs.microsoft.com/en-us/dotnet/api/microsoft.xrm.tooling.connector.crmserviceclient?view=dynamics-xrmtooling-ce-9
Connection String Docs can be found here:
https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/xrm-tooling/use-connection-strings-xrm-tooling-connect
Note: that only OAuth, Certificate, ClientSecret Authentication types are supported at this time.
0.4.6:
Exposing ILogger support on all constructors and Static API commands.
0.4.4:
Added support for related entity create as part of general "create" operation.
Updated Async Operations to return task's for async methods that were returning void's
Updated DataverseOperationException to include HttpOperationResponse, where it exists.
Fixed issue with Cloned Connections not refreshing their tokens on token expiration
Updated Logger to remove string builder property
Added Initial code for ILogger implementation. (Not exposed as of yet but coming soon)
Corrected an issue when using the Entity myEnt = new Entity(string, guid) not properly setting the primary id.
0.4.1:
Supersedes Microsoft.PowerPlatform.Cds.Client, Previous nuget has been retired.
***** MAJOR Breaking Changes *****
Complete renaming of CdsServiceClient for Dataverse naming.
Major differences:
Namespace: Microsoft.PowerPlatform.Cds.Client => Microsoft.PowerPlatform.Dataverse.Client
CdsServiceClient is now ServiceClient
All methods in CdsServiceClient that had Cds in the name have been updated to remove cds Name
Exception's have been updated to
CdsConnectionException => DataverseConnectionException
CdsOperationException => DataverseOperationException
0.3.10-Alpha:
Initial async implementation of SDK Client. - note this is a WORK IN PROGRESS and may not work as expected under all circumstances.
Please report bugs or behaviors issues in the normal way
Fixes and issue with exceptions being thrown by code that is supposed to log exceptions.
Corrected issue with DateOnly data types when using CUD events.
Included additions to logging when failures occur during connection string based login. - credit to GIT:@nicknow for the suggestion of fix.
0.3.6-Alpha:
Fixed an issue where Activity Party types were not being properly processed
Fixed an issue where the incorrect format was used for Data only types.
Fixed an issue where BypassPluginExecution property on request was not being understood properly by the server.
0.3.1-Alpha
***** Breaking Changes *****
MSAL Port completed.
Auth processes have been ported to MSAL.
UserID/PW flows are now enabled on .net core for login where possible ( per AAD security rules and host OS)
Auth flow Logging capture is still under development.
Authentication constructors are now updated to remove some ADAL.net patterns
Removed Token Cache path from constructors and ignore on connection string at this time
Token Cache handle support will be revisited, however if you have a pressing need, we recommend you use the external token management constructor in the mean time and self manage that.
For now, only MSAL In-Memory support will be provided for token cache
Refactored to support Shared HTTPClientFactory for WebAPI connections to cut down on some noise for folks that are doing repeated logins.
Refactored code a bit to help with clarity on various functional areas.
Renamed/Refactored Discovery methods to as Async methods.
0.2.31-Alpha:
Rerouted all Upsert Request to use OrganizationService API.
Added new InMemory Logging Options to support returning Logs captured either as Array of Tuples or a string list.
Added new public property for OrganizationDetail Information called "OrganizationDetail" for the currently connected environment.
Added new enum for ImportSolution additional property options called "ImportSolutionProperties" - this contains valid options for additional properties for the ImportSolution handler
Fixed an issue with telemetry for the client that was using incorrect format for useragent content
Updated Core CDS Sdk assemblies
0.2.24-Alpha:
Fixed an issue with .Clone not correctly supporting adding telemetry handlers to cloned connections
0.2.23-Alpha:
Adding Switzerland Geo to Regions List.
Added support for Alternate key use on entity references as part of Create Update Delete Operations running over the webAPI.
Added concurrency support to Create Update Delete Operations running over the webAPI.
0.2.17-Alpha:
***BREAKING CHANGE***
Renamed Exception CdsConnectionException to CdsClientConnectionException. No other change to the Exception
***
Improved handling of cached connection retrieval failures from memory when an invalid object is returned.
Fixed a bug where a WebAPI navigation property did not match with its metadata descriptor.
Fixed Retry delay issue when making calls to the CDS WebAPI – thanks to GIT user stvonolf for the catch of this issue.
Added new Exception, CdsClientOperationException - this will be used when an exception is raised via the CDSClient when CDSClient is using WebAPI.
Added IntelliSense Doc Support
Added support for bypassing custom Plug-in Execution during SDK Operation.
This is a special use capability that requires a specialized permission in the CDS infrastructure to use.
Currently this is only permitted for use by users that have the System Administrator Security Role.
0.2.16-Alpha:
Fixed issue when CUD via WebAPI when entity contains a entity reference that is a polymorphic reference. ( IE customer data type )
0.2.15-Alpha:
Corrected a bug in Org request to WebAPI operation when attempting to set fields to null values.
Added initial support for in memory log capture support.
0.2.14-Alpha:
Update to internal support libraries
0.2.8-Alpha:
Fixed an issue with sovereign cloud discovery reference data that would prevent a future login control from picking the correct global discovery server.
0.2.7-Alpha:
Fixed missing ConfigureAwait on ADAL Authority acquire flow.
Added some additional logging to understand what version of ADAL is being used.
Fixed an issue with translation of Money types to WebAPI requests.
0.2.5-Alpha:
Fixed Authority property data loss post clone process
Added temp logic to run upsert requests that have anything other than string keys via the Native OrgAPI vs webAPI, this is a workaround for an open issue with the webAPI where it does not support none string key's on upsert(patch) requests that result in a create operation.
Rerouted CdsServiceClient Helpers to use WebAPI path for CUD requests.
0.2.2-Alpha:
Several updates to Create / Update / Delete operations to move the underlying features over to use the WebAPI.
Please report any bugs that you run into with this. This has been "mostly" tested with our current test suite, however we have not full tested all data type translation at this point.
0.2.1-Alpha:
BREAKING CHANGE!!!
Altering Nuget Version to 3 digit semantic version
Namespace change from Microsoft.Powerplatform.xxxx to Microsoft.PowerPlatform.xxxx
Fixed an error with setting CallerId when ClientSecret Auth type is used.
Thanks for all the bug reports on this and repro's that really helped us run it down.
0.0.1.11-Alpha:
Fixed a number of discovery related issue that were broken during the port.
Added new forms of DiscoveryGlobalOrganziations to allow for a token function to be passed to enabled this for use in WebSites and functions where it makes sense.
Updated several sovereign GEO's configs to reflect use of Global discovery for those GEOs
Fixed a bug in LinQ create methods that would appear on non-windows deployments.
This would manifest as a missing method exception when trying to create a sequential guid.
0.0.1.9-Alpha:
Fixes a bug in using ExecuteCdsWebRequest that blocked connections using clientSecretAuth types.
0.0.1.8-Alpha:
Removed IOverrideAuthHookWrapper and property and replaced with a new constructor form.
This capability was replaced with a new constructor that accepts a function pointer as a parameter to the constructor.
This user provided function takes the form of string FunctionName (string InstanceUri), When called, the current instance URI will be
passed in and the function is expected to return an access token for access to that instance.
This form allows an given instance of the CdsServiceClient to be associated with a Auth Processor vs having the auth processor at the process level.
Fixed a bug reported in .clone in .net core builds. When cloning a connection in .net core, the system would think you were using an invalid auth type.
Known issues:
None at this time.. Please report any issues on the GitHub Issues site.
0.0.1.7-Alpha
Fixed a Nuget Package dependency issue in Microsoft.Dynamics.Sdk.Messages
0.0.1.6-Alpha
Intial Alpha release of Microsoft.Cds.Client.CdsServiceClient
WARNING: This is an ALPHA release.
This library is a rename and renamespace of the Microsoft.Xrm.Tooling.Connector.CrmSeriviceClient.
If you are familiar with the CrmServiceClient, By Renaming each occurrence of Crm to Cds, you should find that API's match up.
Major changes from CrmServiceClient:
This library does not support User Interactive or User Password Auth flows in .net core.
This library does not support AD or ADFS login to OnPremise,
to use against an onPrem instance of CDS, your instance must be configured with
ADFS + OAuth and the application ID you wish to use registered.
This library removes several Dynamics specific helper methods from CrmServiceClient.
this additional methods can be found by include the nuget package Microsoft.Cds.Client.Dynamics