Utiliser les tables Dataverse avec du code

  • Article

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

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

Modifier les tables

Vous pouvez modifier le design de table à l’aide de différentes méthodes.

Utiliser les concepteurs

Il existe plusieurs façons de modifier un design de table à l’aide de concepteurs.

Concepteur Description
make.powerapps.com L’approche la plus simple et la plus courante pour modifier le schéma consiste à utiliser le https://make.powerapps.com/ pour modifier les tables Dataverse dans un environnement. Les modifications appliquées ici sont exécutées dans le cadre d’une solution par défaut Common Data Service non gérée.
Explorateur de solutions pour votre solution Si vous envisagez de distribuer une solution, vous devez créer les nouvelles tables, les nouveaux attributs ou les nouvelles relations dans le contexte de la solution non gérée que vous utiliserez pour développer votre solution.
Plus d’informations : Éditeur de solutions
Depuis l’éditeur de formulaires En modifiant un formulaire d’application basé sur un modèle pour une entité, vous pouvez cliquer sur le bouton Nouveau champ dans Explorateur de champs. Si vous créez un champ de recherche, vous créerez une relation pour le prendre en charge.

Importer une solution

Une solution peut contenir une table et d’autres composants personnalisés. Importer une solution gérée ou non 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 avec Power Query

Vous pouvez créer des tables et les remplir avec des données via Power Query. En savoir plus : Ajouter des données à une table dans Dataverse en utilisant Power Query

Utiliser les services web pour travailler avec les définitions de table

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

Définitions de table

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

La définition de la table comprend les informations suivantes :

Données Description
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. Pour plus d’informations, voir : Définition d’entité
Attributs La propriété Attributes d’entité est une collection d’attributs ou de colonnes. Chaque colonne a environ 50 propriétés qui décrivent comment il est identifié, le type de données qu’il contient, comment il est mis en forme et ce qui peut être fait avec lui. Pour plus d’informations : Définition d’attributs
Relations Trois des propriétés d’entité sont des collections de relations entre des tables. Ces collections contiennent différents types de relations : plusieurs-à-plusieurs, plusieurs-à-un et un-à-plusieurs. Pour plus d’informations : Définition de relations
Privilèges L’une des propriétés est une collection de 0 à 8 privilèges qui identifient les types d’opérations de données qui peuvent être effectués sur cette table avec un identificateur unique associé à chacun d’eux. Ces opérations comprennent : Ajouter, Ajouter à, Attribuer, Créer, Supprimer, Lecture, Partager et Écrire.
Clés Par défaut, chaque table a un seul attribut GUID (identificateur global unique) et la propriété Keys est une collection vide. Vous pouvez ajouter d’autres clés à une table. Plus d’informations : Clés

Conseil

Le développement d’une bonne compréhension de la définition de table dans le système permet de vous aider à mieux comprendre comment fonctionne la plateforme Dataverse. La plupart des propriétés contrôlent également ce que peuvent faire les tables dans les applications basées sur des modèles. Les concepteurs disponibles pour modifier les métadonnées ne peuvent pas afficher toutes les informations figurant dans les métadonnées. Vous pouvez installer une application basée sur des modèles appelée Navigateur de métadonnées, qui vous permet d’afficher toutes les tables masquées et les propriétés de métadonnées qui se trouvent dans le système. Pour plus d’informations : Parcourir les définitions de table et de colonnes dans votre environnement

Tables privées

Dataverse contient des tables qui ne sont pas destinées aux développeurs tiers. Ces tables sont ajoutées par Microsoft pour activer la fonctionnalité des fonctionnalités. Les tables privées sont indiquées par les EntityMetadata.IsPrivate . Ces tables ne sont pas incluses dans l’API web Document $metadata CSDL. Cependant, vous les trouverez lors de l’interrogation des métadonnées d’entité.

Attention

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 une personne autre que Microsoft n’est pas prise en charge.

Voir aussi

Vue d’ensemble du développeur Dataverse

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é).