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 du 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 d’une nouvelle application, utilisez la classe ServiceClient qui prend en charge les nouvelles technologies d’authentification (MSAL) et contient quelques fonctionnalités supplémentaires non disponibles dans CrmServiceClient. Cependant, les deux classes de client sont pour la plupart identiques du point de vue de l’API. Cette documentation contient des exemples de code utilisant l’une ou l’autre de ces classes, et il est assez facile de convertir le code qui utilise CrmServiceClient pour qu’il utilise 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’objectif du message et le nom de la classe de requête correspondant 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. Après l’exécution d’une requête, le service renvoie un objet de classe de réponse (par ex. CreateResponse) qui contient un statut d’exécution et les 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 du service d’organisation, connu sous le nom de point de terminaison SOAP, qui a été introduit en 2011, est déconseillé depuis un certain temps. Cela signifie qu’il continuera à fonctionner et sera pris en charge jusqu’à ce que nous le supprimions. Nous avons également annoncé que nous allons mettre à jour le SDK pour les assemblys .NET afin qu’ils continuent de fonctionner après la suppression du point de terminaison. Autrement dit, le SDK sera mis à jour pour les assemblys .NET disponibles 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. L’essentiel est que les développeurs accèdent au service d’organisation à l’aide du SDK pour .NET et ignorent le point de terminaison et son protocole. Plus d’informations : Transition des applications vers Dataverse ServiceClient

L’API web utilisant un point de terminaison différent, elle n’est pas affectée par cette obsolescence du point de terminaison SOAP de 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

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).