Referência de tabela/entidade do Dataverse

Use esta referência para entender as operações disponíveis que podem ser executadas para tabelas específicas, as colunas padrão de cada tabela e as relações entre tabelas.

Esta referência inclui apenas as tabelas em que:

• IsPrivate é igual a false

  • Isto exclui tabelas onde não existem casos de utilização externos.

• IsIntersect é igual a false ou IsIntersect é igual a true e a tabela contém mais do que 4 colunas.

  • A maioria das tabelas de cruzamento contém apenas as 4 colunas necessárias para suportar a relação Muitos para Muitos. Não são úteis. As tabelas de cruzamento com mais de quatro colunas são mais interessantes.

Para exibir informações sobre todas as tabelas em seu ambiente, consulte Procurar definições de tabelas em seu ambiente.

Referência da tabela de produtos do Dynamics 365

Os produtos do Dynamics 365 usam o Dataverse. Quando você cria um ambiente para produtos Dynamics 365, o ambiente tem um conjunto comum de tabelas para todos os produtos Dynamics 365. Essas tabelas estão incluídas na referência de tabela/entidade de aplicativos habilitados do Dynamics 365.

Cada um dos produtos específicos do Dynamics 365 pode adicionar tabelas adicionais. A tabela a seguir mostra a referência de tabela para produtos específicos do Dynamics 365:

Documentação do produto	Referência da tabela de produtos
Vendas	Tabela de vendas/referência de entidade
Serviço de campo	Referência de tabela/entidade do Field Service
Atendimento ao Cliente	Referência de tabela/entidade do Serviço de Apoio ao Cliente

Propriedades

Esta secção inclui propriedades de entidade selecionadas em vez de todas elas. Só estão incluídas as propriedades que se espera que sejam as mais úteis para os programadores. Alguns valores de propriedade de entidade podem ser alterados.

Columns

As colunas estão listadas em duas secções separadas: Colunas/atributos graváveis e Colunas/atributos só de leitura. O objetivo desta separação é focar-se nas colunas que um programador pode definir quando cria ou atualiza linhas numa tabela. Compreender estas colunas ajuda o programador a entender o que pode fazer com a tabela além de apenas obter os valores.

As colunas na secção Colunas/atributos graváveis devolvem true para qualquer uma das propriedades IsValidForCreate ou IsValidForUpdate (normalmente, ambas). Se qualquer uma destas propriedades devolver false, isto será indicado.

Colunas/atributos só leitura devolvem sempre false para as propriedades IsValidForCreateeIsValidForUpdate.

As opções de coluna de escolha nesta documentação de referência vêm de uma implementação em que o inglês é o idioma base. Algumas opções de escolha podem variar dependendo do idioma base selecionado quando o ambiente é criado. Estas diferenças alinham-se mais estreitamente com as opções que melhor se adequam ao idioma ou à cultura. É livre de personalizar estas opções ao alterar as etiquetas ou adicionar e remover opções conforme necessário.

Relações

A classe EntityMetadata inclui três propriedades para representar relações:

Propriedade	Tipo	Description
OneToManyRelationships	OneToManyRelationshipMetadata[]	Obtém a matriz de relações um-para-muitos para a entidade.
ManyToOneRelationships	OneToManyRelationshipMetadata[]	Obtém a matriz de relações muitos para um para a entidade.
ManyToManyRelationships	ManyToManyRelationshipMetadata[]	Obtém a matriz de relações muitos para muitos da entidade.

Observação

É importante ter em mente que, embora cada tabela liste as relações que se aplicam a ela, cada relação é partilhada por ambas as tabelas. As relações existem entre as tabelas. Embora existam relações Um-Para-Muitos, as relações Muitos para Um são simplesmente uma vista de uma relação Um-Para-Muitos da tabela de referência.

Relações Muitos para Um

Inclui estas OneToManyRelationship propriedades:

Propriedade	Description
ReferencedEntity	O nome lógico da tabela relacionada.
ReferencedAttribute	O nome lógico da chave primária da tabela relacionada.
ReferencingEntity	O nome lógico da tabela relacionada que tem a coluna de procura.
ReferencingAttribute	O nome lógico da coluna de procura na tabela relacionada que contém uma referência à chave primária da tabela primária.
IsHierarchical	Se a relação representa uma relação hierárquica autorreferencial
CascadeConfiguration	Os dados que descrevem que operações executadas na entidade principal serão transmitidas para as entidades relacionadas. Mais informações: Configuração em cascata

Relações um-para-muitos

Inclui estas OneToManyRelationship propriedades:

Propriedade	Description
ReferencingEntity	O nome lógico da tabela relacionada.
ReferencingAttribute	O nome lógico da coluna na tabela relacionada que contém uma referência à chave primária da tabela primária.
IsCustomizable	Se as propriedades da relação podem ser alteradas.
ReferencedEntityNavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esta relação. Mais informações: Propriedades de Navegação da API Web
AssociatedMenuConfiguration	Dados usados por aplicações condicionadas por modelo para controlar se e como os dados de entidade relacionados podem ser acedidos na IU a partir da entidade primária.

Relações de muitos-para-muitos

Cada relação muitos para muitos inclui Entity1LogicalName e Entity2LogicalName. Para esta documentação, os detalhes da relação são fornecidos no contexto da tabela atual. Se é Entity1 ou Entity2 não é realmente importante.

Para cada relação muitos para muitos, as seguintes propriedades estão incluídas:

Propriedade	Description
IntersectEntityName	O nome lógico da tabela de interseção que dá suporte a essa relação muitos-para-muitos
IsCustomizable	Se as propriedades da relação podem ser alteradas.
SchemaName	O nome do esquema da relação.
IntersectAttribute	O nome da coluna na tabela de cruzamento que é a chave primária para registos deste tipo.
NavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esta relação. Mais informações: Propriedades de Navegação da API Web
AssociatedMenuConfiguration	Dados usados por aplicações condicionadas por modelo para controlar se e como os dados da tabela secundária podem ser acedidos na IU a partir desta tabela.

No caso raro em que uma relação muitos para muitos é autorreferenciada, como para Função de Ligação (ConnectionRole) connectionroleassociation_association, Entity1 ou Entity2 é anexado ao início da propriedade.

Propriedade	Valor
Entity1IntersectAttribute	O nome da coluna na tabela de cruzamento que é a chave primária para registos deste tipo como a primeira tabela.
Entity2IntersectAttribute	O nome da coluna na tabela de cruzamento que é a chave primária para registos deste tipo como a segunda tabela.
Entity1NavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esta relação como a primeira tabela.
Entity2NavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esta relação como a segunda tabela.
Entity1AssociatedMenuConfiguration	Dados usados por aplicações condicionadas por modelo para controlar se e como os dados da tabela secundária podem ser acedidos na IU a partir desta tabela como a primeira tabela.
Entity2AssociatedMenuConfiguration	Dados usados por aplicações condicionadas por modelo para controlar se e como os dados da tabela secundária podem ser acedidos na IU a partir desta tabela como a segunda tabela