Utiliser le SDK pour .NET

Le SDK pour .NET permet d’accéder aux données commerciales, aux définitions de tables de données (métadonnées) et aux opérations de données prises en charge par la plate-forme Dataverse.

Il existe certains scénarios de développement dans lesquels le SDK pour .NET Dataverse doit être utilisé. Lors de la rédaction d’un code personnalisé pour étendre les fonctionnalités de Dataverse, comme lors de la création de plug-ins et d’activités de workflow personnalisées, vous devez générer le code en utilisant .NET Framework et le SDK Dataverse.

Récupération des assemblys du SDK

Utilisez les assemblys du SDK pour .NET pour les applications pilotées par .NET Framework ou .NET Core. Pour le développement .NET Framework uniquement, les assemblys du SDK sont disponibles dans le package Microsoft.CrmSdk.CoreAssembliesMicrosoft.CrmSdk.CoreAssemblies NuGet. Pour le développement .NET Framework ou .NET Core, les assemblys du SDK sont disponibles dans le package Microsoft.PowerPlatform.Dataverse.Client NuGet.

Une fois le package NuGet ajouté à votre projet Visual Studio, vous avez accès aux espaces de noms et aux classes qui permettent à votre application d’interagir avec les services web d’organisation et de découverte.

Interaction avec le service d’organisation

Dans cette section, nous abordons certains concepts clés sur l’utilisation des classes SDK fournies pour se connecter aux services web et effectuer des opérations.

Établissement d’une connexion de service web

L’interface IOrganizationService fournit une connexion au service d’organisation, ce qui permet aux applications d’utiliser les données commerciales et les définitions de table et de colonne. Le SDK contient deux implémentations de cette interface : CrmServiceClient et ServiceClient. Pour le développement de nouvelles applications, vous devez utiliser la classe ServiceClient qui prend en charge les technologies d’authentification (MSAL) plus récentes et qui a quelques fonctionnalités supplémentaires qui ne sont pas disponibles dans CrmServiceClient. Cependant, les deux classes de client sont pour la plupart identiques du point de vue de l’API. Vous verrez des exemples de code dans cette documentation qui utilisent l’une de ces classes, et il est assez facile de convertir le code qui utilise CrmServiceClient pour utiliser ServiceClient.

Plus d’informations : Transition des applications vers Dataverse ServiceClient, Interface IOrganizationService

Opérations de service web

Dans le SDK pour .NET Dataverse, les opérations du service web sont initiées par l’envoi de messages ou de demandes de messages au service. Chaque message a un nom qui indique l’objet du message, et le nom de la classe de demande correspondante est basé sur ce nom de message. Par exemple, pour créer une ligne de données dans une table, remplissez une demande de création avec les données et demandez au client de service d’envoyer (exécuter) cette requête au service d’organisation. L’opération est « create » et la demande de message est nommée CreateRequest. Lorsque vous exécutez une demande, le service renvoie un objet de classe de réponse (par exemple CreateResponse) qui contient un statut d’exécution et des données de résultats. Ce modèle est le même pour les autres opérations prises en charge par le service.

Examinez les classes de demande de message et de réponse disponibles dans les espaces de noms Microsoft.Xrm.Sdk.Messages et Microsoft.Crm.Sdk.Messages.

À propos de l’ancien point de terminaison SOAP

Le point de terminaison de service d’organisation, connu sous le nom de point de terminaison SOAP, a été introduit en 2011. Ce point de terminaison est obsolète. Cela signifie qu’il continue de fonctionner et d’être pris en charge jusqu’à ce que nous le supprimions. Nous avons également annoncé que nous mettrons à jour les assemblys du SDK pour .NET afin qu'ils continuent de fonctionner après la suppression du point de terminaison. Cela signifie que le Kit de développement logiciel (SDK) mis à jour pour les assemblys .NET sera disponible avant la suppression du point de terminaison. Bientôt, à un moment donné, les développeurs devront mettre à jour leur code pour utiliser ces nouveaux assemblys. Ce qu’il faut retenir, c’est que les développeurs accèdent au service d’organisation à l’aide du Kit de développement logiciel (SDK) pour .NET et ignorent le point de terminaison et son protocole. Plus d’informations : Transition des applications vers Dataverse ServiceClient

Étant donné que l’API Web utilise un point de terminaison différent, elle n’est pas affectée par cette obsolescence de point de terminaison SOAP 2011.

Étapes suivantes

Écrivons du code ! Démarrage rapide : exemple de SDK pour .NET (C#)

Voir aussi

Découvrir les organisations d’utilisateur
Utiliser des plug-ins pour étendre les processus d’entreprise
Extensions de workflow