Guia rápido do Dataverse

Este artigo apresenta conceitos-chave do Dataverse que programadores de Python (e de outras linguagens que não sejam .NET) devem conhecer para ter sucesso ao trabalhar com o Dataverse. Ele também fornece links para informações mais detalhadas. As funcionalidades do Dataverse são extensas, mas você pode explorar essas outras funcionalidades em seu próprio ritmo.

Programadores que programam em C#/.NET devem ler o abrangente Guia do Desenvolvedor do Dataverse.

Tabelas e mensagens

Você armazena dados em tabelas, que são organizadas em linhas e colunas. As mensagens são as operações que atuam em tabelas e dados de tabela. As tabelas também são conhecidas como entidades, e as linhas às vezes são chamadas de registros na documentação.

Tables

Normalmente, você usa três tipos de tabelas no Dataverse: sistema, personalizável e personalizado. As tabelas do sistema, também conhecidas como tabelas prontas para uso, não podem ser alteradas e dão suporte à funcionalidade básica do Dataverse. Você pode modificar tabelas personalizadas e personalizáveis de forma interativa ou programática se tiver as permissões apropriadas.

Para criar ou modificar interativamente uma tabela, use o PPAC ( Centro de administração do Power Platform ). Para criar ou modificar programaticamente uma tabela, modifique os metadados da tabela. O SDK para Python inclui funções (em client.tables) que permitem trabalhar facilmente com metadados de tabela.

As linhas de tabela do Dataverse, também conhecidas como registros, são representadas como dicionários Python com nomes de esquema de coluna.

Para obter mais informações, consulte Referência de EntityType da API Web e use a API Web com definições de tabela.

Messages

As mensagens representam a operação do serviço Web a ser executada. As mensagens podem ser operações mais simples, como criar, recuperar, atualizar e excluir (CRUD). As mensagens também podem invocar operações mais complexas, como book ou win, que podem iniciar uma combinação de outras operações.

A referência de tipo de entidade lista todas as tabelas conhecidas (não personalizadas) e as mensagens padrão suportadas por cada tabela. Quando você cria uma tabela personalizada, um conjunto padrão de mensagens está disponível para essa tabela.

Segurança

O acesso aos dados em seu ambiente do Dataverse é limitado com base na função de segurança (ou funções) que um administrador atribui a você e nas permissões de gerenciamento de dados dessa função. Sua função pode conceder acesso a uma tabela inteira ou a segurança pode restringir o acesso a uma linha e coluna específicas.

Para obter mais informações, consulte a visão geral de segurança e segurança e acesso a dados.

Personalizações e extensões

Esta seção aborda algumas maneiras de personalizar e estender o Dataverse.

Mais sobre tabelas

O Dataverse dá suporte a tabelas customizáveis e personalizadas. Uma tabela personalizável é uma tabela existente que é fornecida com o Dataverse que você pode modificar, por exemplo, para adicionar ou excluir colunas, alterar o nome da tabela e muito mais.

Tabelas personalizadas são tabelas que você (ou terceiros) cria. Conforme indicado anteriormente neste artigo, o SDK fornece Python funções que você pode usar para criar e excluir tabelas personalizadas.

Importante

Você deve incluir um valor de prefixo de personalização para todas as operações em tabelas e colunas personalizadas (por exemplo, "new_MyTestTable", não "MyTestTable").

Sempre use nomes de esquema de tabela ("conta", "new_MyTestTable") e nomes de esquema de coluna ("nome", "new_MyTestColumn") em chamadas à API do SDK.

Para obter mais informações, consulte as definições Table no Microsoft Dataverse.

Extensões

Você pode modificar a funcionalidade do processamento de dados do Dataverse usando manipuladores de eventos (chamados plug-ins) e atividades personalizadas de fluxo de trabalho. Esses objetos de código personalizados compilados são registrados em uma determinada combinação de tabelas e mensagens. Uma atividade de plug-in ou fluxo de trabalho pode modificar dados antes ou depois da operação de processamento de dados principal do Dataverse. Se você vir resultados de dados diferentes do esperado, uma dessas extensões pode ser a causa.

Existem outras maneiras de personalizar e estender o Dataverse, mas a lista completa está além do escopo deste artigo.

Web API

O SDK fornece uma interface de programação python que chama internamente a API Web do Dataverse. A DataverseClient classe fornece uma interface simplificada para autorização do OData 2.0, conforme exigido pela API Web.

Você pode invocar funções e ações da API Web diretamente de dentro do seu programa Python. No entanto, o SDK para Python fornece uma sintaxe de programação mais natural para acessar dados do Dataverse, conforme esperado por desenvolvedores e cientistas de dados do Python.

Soluções

Uma solução é um contêiner de pastas e arquivos que estendem e personalizam o Dataverse. As soluções são o mecanismo para empacotar personalizações e extensões em um único arquivo compactado para exportação. Você pode importar esse arquivo de solução para outros ambientes (também conhecidos como organizações).

Extensões e personalizações sempre existem em uma solução. No Dataverse, há uma solução padrão. Se você adicionar extensões ou personalizações ao seu ambiente sem adicioná-las a uma solução personalizada, a solução padrão as conterá automaticamente.

Você pode criar, gerenciar, exportar e importar soluções interativamente usando o PPAC ou programaticamente usando a API Web.

Para obter mais informações, consulte Conceitos de solução.

  • Last updated on