Referência de tabela/entidade do Dataverse

Use esta referência para compreender as operações disponíveis para tabelas específicas, as colunas padrão de cada tabela e as relações entre tabelas. As definições de tabelas utilizam a classe EntityMetadata.

Esta referência inclui apenas as tabelas em que:

• EntityMetadata.IsPrivate iguais false

  Esta condição exclui tabelas sem casos de uso externos.

• EntityMetadata.IsIntersect igual false ou IsIntersect é true igual e a tabela contém mais de quatro colunas.

  A maioria das tabelas intersect contém apenas as quatro colunas necessárias para suportar a relação muitos-para-muitos. Não são úteis. Tabelas de interseção com mais de quatro colunas não são comuns e 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. Consulte a tabela/referência de entidades de aplicações ativadas no Dynamics 365.

Cada produto específico do Dynamics 365 pode adicionar mais tabelas. 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. Inclui apenas aquelas propriedades que são mais úteis para os promotores. Pode alterar alguns valores das propriedades das entidades.

Columns

As colunas estão listadas em duas secções separadas:

Secção	Description
Colunas/atributos graváveis	Colunas que podes definir ao criar ou atualizar linhas numa tabela. Estas colunas retornam true para as AttributeMetadata.IsValidForCreate propriedades ou, AttributeMetadata.IsValidForUpdate normalmente ambas. Se alguma das propriedades devolver false, esta condição é indicada.
Colunas/atributos apenas de leitura	Colunas que podes recuperar mas não podes definir ao criar ou atualizar linhas numa tabela. Estas colunas retornam false sempre para as AttributeMetadata.IsValidForCreate propriedades e AttributeMetadata.IsValidForUpdate .

Opções de coluna de escolha

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 com opções que melhor se adequam à língua ou cultura. Pode personalizar estas opções alterando os rótulos ou adicionando e removendo 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

Embora cada tabela liste as relações que lhe são aplicadas, 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 visão de uma relação um-para-muitos a partir da tabela de referência.

Relações muitos-para-um

Inclui estas OneToManyRelationshipMetadata propriedades de classe :

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 quais as operações realizadas na entidade-mãe descem em cascata para entidades relacionadas. Para mais informações, veja Configuração em cascata.

Relações um-para-muitos

Inclui estas OneToManyRelationshipMetadata propriedades de classe :

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 consegues mudar as propriedades da relação.
ReferencedEntityNavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esta relação. Para mais informações, consulte Propriedades de Navegação Web API.
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 ManyToManyRelationshipMetadata propriedades de classe são incluídas:

Propriedade	Description
IntersectEntityName	O nome lógico da tabela de cruzamento que suporta esta relação muitos para muitos.
IsCustomizable	Se consegues mudar as propriedades da relação.
SchemaName	O nome do esquema da relação.
IntersectAttribute (Entity1IntersectAttribute ou Entity2IntersectAttribute)	O nome da coluna na tabela de cruzamento que é a chave primária para registos deste tipo.
NavigationPropertyName (Entity1NavigationPropertyName ou Entity2NavigationPropertyName)	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 (Entity1AssociatedMenuConfiguration ou 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.

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 orientadas a modelos para controlar se e como os dados da segunda tabela podem ser acedidos na interface a partir desta tabela como a segunda tabela.