Guide rapide de Dataverse

Cet article présente les concepts clés de Dataverse que les développeurs Python (et les autres développeurs non .NET) devraient connaître pour réussir lorsqu’ils travaillent avec Dataverse. Il fournit également des liens vers des informations plus détaillées. Les fonctionnalités dataverse sont étendues, mais vous pouvez explorer ces autres fonctionnalités à votre propre rythme.

Les programmeurs qui programment en C#/.NET devraient lire le Dataverse Developer Guide détaillé.

Tables et messages

Vous stockez des données dans des tables, qui sont organisées en lignes et colonnes. Les messages sont les opérations qui agissent sur les tables et les données de table. Les tables sont également appelées entités et les lignes sont parfois appelées enregistrements dans la documentation.

Tables

Vous utilisez généralement trois types de tables dans Dataverse : système, personnalisable et personnalisé. Les tables système, également appelées tables prêtes à l’emploi, ne peuvent pas être modifiées et prennent en charge les fonctionnalités de base de Dataverse. Vous pouvez modifier de manière interactive ou programmatique des tables personnalisables et personnalisées si vous disposez des autorisations appropriées.

Pour créer ou modifier de manière interactive une table, utilisez le Centre d’administration Power Platform (PPAC). Pour créer ou modifier une table par programmation, modifiez les métadonnées de table. Le Kit de développement logiciel (SDK) pour Python inclut des fonctions (dans client.tables) qui vous permettent facilement d’utiliser les métadonnées de table.

Les lignes de table Dataverse, également appelées enregistrements, sont représentées en tant que dictionnaires Python avec des noms de schéma de colonne.

Pour plus d’informations, consultez Référence EntityType de l’API Web et Utiliser l’API Web avec des définitions de tables.

Messages

Les messages représentent l’opération de service web à effectuer. Les messages peuvent être des opérations plus simples telles que la création, la récupération, la mise à jour et la suppression (CRUD). Les messages peuvent également appeler des opérations plus complexes telles que book ou win, qui peuvent lancer une combinaison d’autres opérations.

La référence de type d’entité répertorie toutes les tables connues (noncustomes) et les messages standard pris en charge par chaque table. Lorsque vous créez une table personnalisée, un ensemble de messages par défaut est disponible pour cette table.

Sécurité

L’accès aux données dans votre environnement Dataverse est limité en fonction du rôle de sécurité (ou des rôles) attribué par un administrateur et des autorisations de gestion des données de ce rôle. Votre rôle peut accorder l’accès à une table entière, ou la sécurité peut restreindre votre accès à une ligne et une colonne spécifiques.

Pour plus d’informations, consultez Vue d’ensemble de la sécuritéet accès aux données.

Personnalisations et extensions

Cette section décrit certaines façons de personnaliser et d’étendre Dataverse.

En savoir plus sur les tables

Dataverse prend en charge les tables personnalisables et personnalisées. Une table personnalisable est une table existante fournie avec Dataverse que vous pouvez modifier, par exemple, pour ajouter ou supprimer des colonnes, modifier le nom de la table, etc.

Les tables personnalisées sont des tables que vous (ou un tiers) créez. Comme indiqué précédemment dans cet article, le Kit de développement logiciel (SDK) fournit des fonctions Python que vous pouvez utiliser pour créer et supprimer des tables personnalisées.

Extensions

Vous pouvez modifier les fonctionnalités du traitement des données de Dataverse à l’aide de gestionnaires d’événements (appelés plug-ins) et d’activités de flux de travail personnalisées. Ces objets de code personnalisés compilés sont inscrits sur une certaine combinaison de tables et de messages. Une activité de plug-in ou de flux de travail peut modifier des données avant ou après l’opération principale de traitement des données de Dataverse. Si vous voyez des résultats de données différents que prévu, l’une de ces extensions peut être la cause.

D’autres façons de personnaliser et d’étendre Dataverse existent, mais la liste complète dépasse la portée de cet article.

API Web

Le Kit de développement logiciel (SDK) fournit une interface de programmation Python qui appelle en interne l’API web Dataverse. La DataverseClient classe fournit une interface simplifiée pour l’autorisation OData 2.0 requise par l’API web.

Vous pouvez appeler des fonctions et des actions d’API web directement à partir de votre programme Python. Toutefois, le Kit de développement logiciel (SDK) pour Python fournit une syntaxe de programmation plus naturelle pour accéder aux données Dataverse, comme prévu par les développeurs Python et les scientifiques des données.

Solutions

Une solution est un conteneur de dossiers et de fichiers qui étendent et personnalisent Dataverse. Les solutions sont le mécanisme permettant d’empaqueter des personnalisations et des extensions dans un fichier compressé unique pour l’exportation. Vous pouvez importer ce fichier de solution dans d’autres environnements (également appelés organisations).

Les extensions et les personnalisations existent toujours dans une solution. Dans Dataverse, il existe une solution par défaut. Si vous ajoutez des extensions ou des personnalisations à votre environnement sans les ajouter à une solution personnalisée, la solution par défaut les contient automatiquement.

Vous pouvez créer, gérer, exporter et importer des solutions de manière interactive à l’aide de PPAC ou par programmation à l’aide de l’API web.

Pour plus d’informations, voir Concepts de solution.

Informations connexes