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.

Certains scénarios de développement nécessitent l’utilisation du Kit de développement logiciel (SDK) Dataverse pour .NET. Lorsque vous écrivez du code personnalisé pour étendre les fonctionnalités de Dataverse, par exemple lorsque vous créez des plug-ins et des activités de flux de travail personnalisées, vous devez générer votre code à l’aide du Kit de développement logiciel (SDK) .NET Framework et Dataverse.

Obtenir les assemblys du Kit de développement logiciel (SDK)

Utilisez les assemblys du SDK pour .NET pour les applications pilotées par .NET Framework ou .NET Core. Pour le développement avec .NET Framework uniquement, procurez-vous les assemblys du SDK dans le package NuGet Microsoft.CrmSdk.CoreAssemblies. Pour le développement avec .NET Framework ou .NET Core, obtenez les assemblies du SDK dans le package NuGet Microsoft.PowerPlatform.Dataverse.Client.

Après avoir ajouté le package NuGet à 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 Organisation et Découverte.

Interagir avec le service d’organisation

Cette section aborde certains concepts clés relatifs à l’utilisation de classes sdk fournies pour se connecter aux services web et effectuer des opérations.

Établir 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 Kit de développement logiciel (SDK) inclut deux implémentations de cette interface : CrmServiceClient et ServiceClient. Pour le développement d’applications, utilisez la ServiceClient classe qui prend en charge les nouvelles technologies d’authentification (MSAL) et propose 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 voyez des exemples de code dans cette documentation à l’aide de l’une de ces classes, et il est assez facile de convertir du code qui utilise CrmServiceClient pour l’utiliser ServiceClient.

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

Opérations de service web

Dans le Kit de développement logiciel (SDK) Dataverse pour .NET, vous lancez des opérations de service web en envoyant des messages ou des demandes de message 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

Microsoft introduit le point de terminaison de service d’organisation, appelé point de terminaison SOAP, 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 Microsoft le supprime. Microsoft également annoncé qu'ils mettent à jour le Kit de développement logiciel (SDK) pour .NET assemblys afin qu'ils continuent de fonctionner une fois le point de terminaison supprimé. 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. La clé 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. Pour plus d’informations, consultez Transition d’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