Utiliser des données à l’aide de code dans Microsoft Dataverse
Il existe plusieurs manières d’accéder Dataverse aux données à l’aide de code.
- Utilisez le Dataverse SDK pour .NET ou API Web pour récupérer, ajouter et modifier des données.
- Utilisez les données Dataverse de recherche de recherche Dataverse .
- Utilisez le Dataverse Tabular Data Stream (TDS) point de terminaison pour interroger des données avec SQL.
Cet article présente les options dont vous disposez pour travailler avec des Dataverse données à l’aide de code.
Récupérer, ajouter et modifier des données
Dataverse fournit deux façons de récupérer, ajouter et modifier des données : SDK pour .NET et API Web. Sélectionnez celui que convient le mieux à vos besoins, vos compétences et préférences.
Kit de développement logiciel (SDK) pour .NET
Si vous travaillez avec .NET, nous vous recommandons d’utiliser notre SDK pour .NET.
- Utilisez la classe ServiceClient dans le DataverseServiceClient NuGet package si vous disposez d’une application client.
- Utilisez le package Microsoft.CrmSdk.CoreAssemblies NuGet lorsque vous écrivez un plug-in ou un activité de workflow personnalisé.
Le kit de développement logiciel Dataverse pour .NET prend en charge les cibles de génération pour .NET Framework et .NET 6+. Toutefois, les plug-ins et des activités de workflow personnalisées doivent utiliser .NET Framework.
Si vous utilisez notre module PowerShell ou notre contrôle de connexion personnalisé avec une application cliente Windows, utilisez Xrm.Tooling
API Web
L’API Web Dataverse est un point de terminaison RESTful OData v4. Utilisez l’API web pour tout langage de programmation prenant en charge les requêtes HTTP et l’authentification à l’aide d’OAuth 2.0, y compris .NET.
- Découvrir comment utiliser Dataverse l’API web
- Démarrage rapide : API web avec PowerShell et Visual Studio Code
- Démarrage rapide : exemple de l’API web (C#)
Rechercher des données Dataverse
La recherche Dataverse fournit des résultats de recherche rapides et complets sur plusieurs tables, dans une seule liste et triés par pertinence. Il offre également des fonctionnalités permettant de prendre en charge les suggestions et les expériences de saisie semi-automatique dans les applications.
La recherche a un point de terminaison natif et il existe Dataverse messages que vous pouvez utiliser à partir de l’API Web ou du SDK pour .NET.
Découvrir comment rechercher des enregistrements Dataverse
Données de requête avec SQL
Le Power Query Dataverse connecteur utilise le Dataverse Tabular Data Stream (TDS) point de terminaison pour récupérer des données à l’aide Dataverse SQL, un sous-ensemble de Transact-SQL.
Récupération de données à l’aide de SQL Management Studio (SSMS) est une fonctionnalité d’évaluation.
Découvrez comment utiliser SQL pour interroger des données
Limitations de la taille de la charge utile des requêtes et de réponse
La taille maximale de la charge utile pour toute requête envoyée à Dataverse est de 128 Mo. Les requêtes avec des charges utiles supérieures à cette limite reçoivent un code d’état HTTP 413 Charge utile trop grande dans le réponse.
La taille de la réponse renvoyée par Dataverse est limitée à 1 Go. Peu d’API ou de requêtes sont capables de renvoyer autant de données. Si vous vous heurtez à cette limite, vous devez envisager d’autres options pour obtenir les données en plusieurs requêtes plus petites.
Les charges utiles SOAP point de terminaison obsolètes utilisent des données XML sérialisées qui sont beaucoup plus détaillées que les charges utiles de données JSON sérialisées utilisées par l’API Web. Vous êtes moins susceptible de rencontrer des erreurs lorsque la demande ou la charge utile réponse est trop volumineuse lorsque vous utilisez l’API Web. En savoir plus sur l’héritage SOAP point de terminaison
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é).