Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O Dataverse não é apenas um banco de dados. Ele também fornece serviços Web que permitem que os desenvolvedores interajam com os dados.
Se você estiver familiarizado com o ADO.NET Entity Framework, você sabe que arquitetos e desenvolvedores de aplicativos orientados a dados geralmente lutam para alcançar dois objetivos diferentes.
- Eles devem modelar as entidades, as relações e a lógica dos problemas de negócios que estão resolvendo.
- Eles também devem trabalhar com os serviços de dados que armazenam e recuperam os dados.
O Entity Framework permite que os desenvolvedores trabalhem com dados como objetos e propriedades específicos do domínio, como clientes e endereços de clientes. Eles não precisam se preocupar com as tabelas e colunas de banco de dados subjacentes em que esses dados são armazenados.
No Power Apps e no Dataverse, você usa tabelas e colunas na interface do usuário. Esses termos referem-se à ideia geral de como os dados são armazenados no banco de dados do Dataverse. No entanto, terminologia específica, como entidade e atributos , refere-se ao modelo de dados e interfaces subjacentes. Os desenvolvedores usam essa terminologia dependendo do protocolo ou da tecnologia usada para interagir com os dados.
As estruturas de dados com as quais os desenvolvedores trabalham são expostas como entidades. O termo é inserido nos nomes das coisas que os desenvolvedores usam. Por exemplo:
| Para... | Usando... | Os desenvolvedores... |
|---|---|---|
| Criar uma tabela no Dataverse | Web API | POST uma instância do EntityMetadata EntityType para o recurso /EntityDefinitions |
| Criar uma tabela no Dataverse | SDK do .NET | Crie uma instância da classe EntityMetadata e use a classe CreateEntityRequest ao usar o SDK para .NET. |
| Criar uma linha ou registro em uma tabela do Dataverse | Web API | Dados de POST definidos como um EntityType específico. Você pode encontrar uma lista desses tipos de entidade aqui: Referência de tipos de entidade da API Web |
| Criar uma linha ou registro em uma tabela do Dataverse | SDK do .NET | Crie uma instância da Classe de Entidade ou uma classe que herda dela (Conta, Contato etc.) e use a Classe CreateRequest ao usar o SDK para .NET. Um desenvolvedor pode encontrar as informações necessárias para usar a classe Entity na referência de entidade. |
Uso de terminologia dependendo do protocolo ou da tecnologia
A documentação do desenvolvedor usa a terminologia que depende do protocolo ou da biblioteca de classes que os desenvolvedores usam.
Quando você trabalha com a API Web, usa a terminologia definida pelo protocolo OData. Estruturas de dados chamadas EntityTypes têm propriedades e propriedades de navegação.
Quando você trabalha com o SDK do .NET, usa a Entidade porque há uma classe Entity. A classe Entity tem uma propriedade Attributes que contém uma coleção de atributos definidos por dados em uma classe AttributeMetadata e muitas outras classes derivadas dela.
Use a terminologia apropriada para descrever o SDK e a tecnologia de API Web. Às vezes, a documentação do desenvolvedor usa uma terminologia diferente da interface do usuário Power Apps. A tabela a seguir ajuda a orientar você para algumas das diferenças de terminologia entre a documentação do desenvolvedor e o restante da documentação do Power Apps.
| Interface de Usuário do Power Apps | Dataverse SDK | Dataverse Web API |
|---|---|---|
| Table | Entity | EntityType |
| Coluna | Attribute | Property |
| Linha | Gravar | Gravar |
| Escolhas | OptionSet/Picklist | OptionSet |
| Sim/Não | booleano | booleano |