Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]
Dans cet article, nous explorons certains concepts clés sur Dataverse que les programmeurs Python (et d’autres non-.NET) doivent savoir pour réussir lors de l’utilisation de Dataverse. Nous fournissons é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 si vous choisissez de le faire.
Les programmeurs codant en C#/.NET devraient lire notre guide complet du développeur Dataverse.
Tables et messages
Les données sont stocké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 connues et les entités, et les lignes sont parfois appelées enregistrements dans notre documentation.
Tables
Il existe trois types de tables que vous utilisez couramment 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. Les tables personnalisables et personnalisées peuvent être modifiées de manière interactive ou par programmation par l’utilisateur si cette personne dispose des autorisations appropriées pour le faire.
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, vous modifiez les métadonnées de la table. Le Kit de développement logiciel (SDK) pour Python inclut des fonctions (par exemple create_table, delete_table) qui vous permettent facilement d’utiliser les métadonnées de table.
Plus d’informations : Référence EntityType de l’API Web, Utiliser l'API Web avec les définitions de table
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, 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 mis à disposition pour cette table.
Security
L’accès aux données dans votre environnement Dataverse est limité en fonction du rôle de sécurité (ou des rôles) que vous avez attribué à un administrateur et des autorisations de gestion des données de ce rôle. Votre rôle peut autoriser l’accès à une table entière, ou la sécurité peut restreindre votre accès à une ligne et une colonne spécifiques.
Plus d’informations : Vue d’ensemble de la sécurité, sécurité et accès aux données
Personnalisations et extensions
Ici, nous abordons quelques 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 qui peut être modifiée, 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 SDK fournit des fonctions Python qui vous permettent de créer et de supprimer des tables personnalisées.
Extensions
Les fonctionnalités du traitement des données dataverse peuvent être modifiées par les gestionnaires d’événements (appelés plug-ins) et les 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. Nous le mentionnons uniquement ici en tant qu’activité de plug-in ou de flux de travail peut modifier les 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.
Il existe d’autres façons de personnaliser et d’étendre Dataverse, 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/ou personnalisent Dataverse. Les solutions constituent le mécanisme permettant d'empaqueter et d'exporter des personnalisations et des extensions dans un seul fichier compressé. Ce fichier de solution peut ensuite être importé dans d’autres environnements (également connu sous le nom d’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 et que vous ne les ajoutez pas à une solution personnalisée, elles sont automatiquement placées dans la solution par défaut.
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.
Plus d’informations : Concepts de la solution