Développeurs : Comprendre la terminologie dans Microsoft Dataverse

Dataverse n’est pas seulement une base de données. Il fournit également des services web qui permettent aux développeurs d’interagir avec les données.

Si vous êtes familiarisé avec ADO.NET Entity Framework, vous savez que les architectes et les développeurs d'applications orientées données ont souvent du mal à atteindre deux objectifs différents.

• Ils doivent modéliser les entités, les relations et la logique des problèmes métier qu’ils résolvent.
• Ils doivent également travailler avec les services de données qui stockent et récupèrent les données.

Entity Framework permet aux développeurs d’utiliser des données en tant qu’objets et propriétés spécifiques au domaine, tels que les clients et les adresses client. Ils n’ont pas besoin de s’inquiéter des tables et colonnes de base de données sous-jacentes où ces données sont stockées.

Dans Power Apps et Dataverse, vous utilisez des tables et des colonnes dans l’interface utilisateur. Ces termes font référence à l’idée générale de la façon dont les données sont stockées dans la base de données Dataverse. Toutefois, une terminologie spécifique telle que l’entité et les attributs fait référence au modèle de données et aux interfaces sous-jacents. Les développeurs utilisent cette terminologie en fonction du protocole ou de la technologie utilisé pour interagir avec les données.

Les structures de données avec laquelle les développeurs travaillent sont exposées en tant qu’entités. Le terme est incorporé dans les noms des éléments que les développeurs utilisent. Par exemple:

Pour…	Utilisation de...	Les développeurs vont...
Créer une table Dataverse	API web	POST une instance de EntityMetadata EntityType à la /EntityDefinitions ressource
Créer une table Dataverse	Kit de développement logiciel (SDK) .NET	Créez une instance de la classe EntityMetadata et utilisez la classe CreateEntityRequest lors de l’utilisation du Kit de développement logiciel (SDK) pour .NET.
Créer une ligne ou un enregistrement dans une table Dataverse	API web	Données POST définies en tant qu’EntityType spécifique. Vous trouverez la liste de ces EntityTypes ici : Référence EntityType de l’API web
Créer une ligne ou un enregistrement dans une table Dataverse	Kit de développement logiciel (SDK) .NET	Créez une instance de la classe d’entité ou d’une classe qui hérite de celle-ci (compte, contact, etc.) et utilisez la classe CreateRequest lors de l’utilisation du Kit de développement logiciel (SDK) pour .NET. Un développeur peut trouver les informations dont il a besoin pour utiliser la classe Entity dans la référence d’entité.

Utilisation de la terminologie en fonction du protocole ou de la technologie

La documentation du développeur utilise la terminologie qui dépend du protocole ou de la bibliothèque de classes que les développeurs utilisent.

• Lorsque vous utilisez l’API web, vous utilisez la terminologie définie par le protocole OData. Les structures de données appelées EntityTypes ont des propriétés et des propriétés de navigation.

• Lorsque vous travaillez avec le KIT de développement logiciel (SDK) .NET, vous utilisez Entity, car il existe une classe Entity. La classe Entity possède une propriété Attributes qui contient une collection d’attributs définis par les données d’une classe AttributeMetadata et de nombreuses autres classes dérivées de celle-ci.

Utilisez la terminologie appropriée pour décrire la technologie du SDK et de l’API web. La documentation du développeur utilise parfois une terminologie différente de celle de l’interface utilisateur Power Apps. Le tableau suivant vous aide à vous guider dans certaines des différences de terminologie entre la documentation du développeur et le reste de la documentation Power Apps.

Interface utilisateur de Power Apps	Kit de développement logiciel (SDK) Dataverse	API Web Dataverse
Table	Entité	EntityType
Colonne	Caractéristique	Propriété
Ligne	Enregistrement	Enregistrement
Choices	JeuD'options/ListeDeSélection	OptionSet
Oui/non	Booléen	Booléen