Partager via


Utiliser des tables Dataverse à l’aide du code

Fournir un stockage pour les données est la fonction la plus importante de Dataverse. Dataverse inclut un ensemble de tables de base qui fournissent une structure pour les données utilisées par les applications métier.

Vous pouvez afficher l’ensemble de tables de base dans la référence de table/entité Dataverse.

Modifier des tables

Vous pouvez modifier la conception de table à l’aide de plusieurs méthodes différentes.

Utiliser des concepteurs

Il existe plusieurs façons de modifier la conception de table à l’aide de concepteurs.

Concepteur Descriptif
make.powerapps.com L’approche la plus simple et la plus courante pour modifier le schéma consiste à utiliser https://make.powerapps.com/ pour éditer les tables Dataverse dans un environnement. Les modifications appliquées ici sont effectuées dans le contexte d’une solution Common Data Service par défaut non managée.
Explorateur de solutions pour votre solution Si vous distribuez une solution, vous devez créer des tables, des attributs ou des relations dans le contexte de la solution non managée que vous allez utiliser pour développer votre solution.
Plus d’informations : Éditeur de solutions
À partir de l’éditeur de formulaire Lorsque vous modifiez un formulaire d’application piloté par modèle pour une entité, vous pouvez cliquer sur le bouton Nouveau champ dans l’Explorateur de champs. Si vous créez un champ de recherche, vous allez créer une nouvelle relation afin de la supporter.

Importer une solution

Une solution peut contenir une table et d’autres composants personnalisés. L’importation d’une solution managée ou non managée dans votre environnement Dataverse inclut ces tables ou étend les tables existantes avec la nouvelle table qu’elles contiennent.

À partir d’une source de données à l’aide de Power Query

Vous pouvez créer des tables et les remplir avec des données à l’aide de Power Query. Plus d’informations : Ajouter des données à une table dans Dataverse à l’aide de Power Query

Utiliser des services web pour utiliser des définitions de table

Les services web exposés dans Dataverse incluent des fonctionnalités permettant de créer, lire, écrire et supprimer des tables. Ces services sont les plus fréquemment utilisés pour lire, car ces données peuvent informer votre code au moment de l’exécution sur la façon dont l’environnement a été personnalisé. Plus d’informations : Utiliser des définitions de table à l’aide du code

Définitions des tables

Le modèle de données est stocké dans Dataverse.

La définition de table comprend les informations suivantes :

Data Descriptif
Propriétés Chaque entité a près de 100 propriétés qui décrivent comment elle est identifiée et ce qui peut être fait avec elle. Plus d’informations : Définition d’entité
Attributes La propriété d’entité Attributes est une collection d’attributs ou de colonnes. Chaque colonne a environ 50 propriétés pour décrire la façon dont elle est identifiée, le type de données qu’elle contient, la façon dont elle est mise en forme et ce qui peut être fait avec elle. Plus d’informations : Définition d’attribut
Relations Trois des propriétés d’entité sont des collections de relations entre les tables. Ces collections contiennent différents types de relations : plusieurs-à-plusieurs, plusieurs-à-un et un à plusieurs. Plus d’informations : Définition des relations
Privilèges L’une des propriétés est une collection de privilèges compris entre 0 et 8 qui identifient les types d’opérations de données qui peuvent être effectuées sur cette table avec un identificateur unique associé à chacun d’eux. Ces opérations sont les suivantes : Append, AppendTo, Assign, Create, Delete, Read, Share et Write.
Keys Par défaut, chaque table a un seul attribut GUID (identificateur global unique) et la Keys propriété est une collection vide. Vous pouvez ajouter d’autres clés à une table. Plus d’informations : Clés

Conseil / Astuce

Le développement d’une compréhension de la définition de table dans le système peut vous aider à comprendre le fonctionnement de Dataverse. De nombreuses propriétés contrôlent également les tables dans les applications basées sur des modèles. Les concepteurs disponibles pour modifier les métadonnées ne peuvent pas afficher tous les détails trouvés dans les métadonnées. Vous pouvez installer une application basée sur des modèles appelée Metadata Browser qui vous permettra d’afficher toutes les tables masquées et les propriétés de métadonnées trouvées dans le système. Plus d’informations : Parcourir les définitions de table et de colonnes dans votre environnement

Tables privées

Dataverse contient certaines tables qui ne sont pas destinées aux développeurs tiers à utiliser. Ces tables sont ajoutées par Microsoft pour activer la fonctionnalité. Les tables privées sont indiquées par la propriété EntityMetadataIsPrivate. Ces tables ne sont pas incluses dans le document CSDL de l’API web $metadata. Toutefois, vous les trouverez lors de l’interrogation des métadonnées d’entité.

Caution

Vous ne devez pas utiliser de tables privées dans vos solutions. En marquant une table comme privée, Microsoft indique explicitement que nous ne prenons pas en charge d’autres applications pour utiliser la table. Microsoft peut supprimer la table ou introduire des modifications de rupture à tout moment. L’utilisation de ces tables par toute personne autre que Microsoft n’est pas prise en charge.

Voir aussi

Vue d’ensemble du développeur Dataverse