Développeurs : Comprendre la terminologie dans Microsoft Dataverse

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

Si vous connaissez bien ADO.NET Entity Framework, les architectes et les développeurs d’applications orientées données ont du mal à atteindre deux objectifs différents.

• Ils doivent modéliser les entités, relations et la logique des problèmes commerciaux qu’ils résolvent.
• Ils doivent également utiliser les services de données utilisés pour stocker et récupérer les données.

Entity Framework permet aux développeurs d’utiliser les données sous la forme d’objets et de propriétés spécifiques au domaine, tels que des clients et des adresses de clients, sans avoir à se soucier des tables et des colonnes de base de données sous-jacentes dans lesquelles ces données sont stockées.

Dans Power Apps et Dataverse, tandis que les tables et les colonnes sont utilisées dans l’interface utilisateur et se réfèrent à l’idée générale de la façon dont les données sont stockées dans la base de données Dataverse, une terminologie spécifique (telle que entité et attributs) est utilisée pour faire référence au modèle de données sous-jacent et aux interfaces avec lesquelles les développeurs travaillent en fonction du protocole ou de la technologie utilisée pour interagir avec les données.

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

Pour…	Avec…	Les développeurs…
Créer une table Dataverse	API web	PUBLIER une instance du EntityMetadata EntityType à la ressource /EntityDefinitions
Créer une table Dataverse	.NET SDK	Créer une instance de la classe EntityMetadata et utilisez la classe CreateEntityRequest lors de l’utilisation du SDK pour .NET.
Créer une ligne ou un enregistrement dans une table Dataverse	API web	PUBLIEZ les données définies comme un EntityType spécifique. Vous pouvez trouver une liste de ces EntityTypes ici : Référence web API EntityType
Créer une ligne ou un enregistrement dans une table Dataverse	.NET SDK	Créez une instance de la classe Entity ou une classe qui en hérite (Account, Contact, etc.) et utilise la classe CreateRequest lors de l’utilisation du 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 terminologie utilisée dans la documentation du développeur dépend du protocole ou de la bibliothèque de classes utilisés par les développeurs.

• Lorsque vous travaillez avec l’API web, nous utilisons la terminologie définie par le protocole OData. Les structures de données sont définies comme EntityTypes, qui ont des propriétés et des propriétés de navigation.

• Lorsque vous travaillez avec le .NET SDK, nous utilisons Entity, car il existe une classe Entity. La classe Entity a une propriété Attributes qui contient une collection d’attributs définis par des données dans une classe AttributeMetadata et de nombreuses autres classes en dérivent.

Nous utilisons la terminologie appropriée pour décrire la technologie SDK et l’API web. La documentation du développeur utilise parfois une terminologie différente de celle de l’interface utilisateur Power Apps. La table ci-dessous vous aide à identifier certaines des différences de terminologie entre la documentation du développeur et le reste de la documentation Power Apps.

IU Power Apps	SDK Dataverse	API web Dataverse
Tableau	Entity	Type d’entité
Colonne	Attribut	Propriété
Ligne	Enregistrement	Enregistrement
Options	Liste de sélection/OptionSet	OptionSet
Oui/non	Boolean	Boolean