Referência de tabela/entidade do Dataverse

Use essa 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

  • Isso exclui tabelas em que não existem casos de uso externos.

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

  • A maioria das tabelas de interseção contém apenas as 4 colunas necessárias para dar suporte ao relacionamento Muitos para Muitos. Elas não são úteis. Tabelas de interseção 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 do Dynamics 365, o ambiente tem um conjunto comum de tabelas para todos os produtos do Dynamics 365. Essas tabelas são incluídas na referência de tabela/entidade de aplicativos habilitados para 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	Referência de tabela/entidade de vendas
Serviço de campo	Referência de tabela/entidade do Field Service
Atendimento ao Cliente	Referência de tabela/entidade do Customer Service

Propriedades

Esta seção inclui propriedades de entidade selecionadas, e não todas elas. Apenas as propriedades que aparentemente são mais úteis para os desenvolvedores são incluídas. Alguns valores de propriedade de entidade podem ser alterados.

Columns

As colunas são listadas em duas seções separadas: Colunas/atributos graváveis e Colunas/atributos somente leitura. O objetivo dessa separação é se concentrar nas colunas que um desenvolvedor pode definir ao criar ou atualizar linhas em uma tabela. Entender essas colunas ajuda o desenvolvedor a entender o que pode fazer com a tabela além de apenas recuperar os valores.

As colunas na seção Colunas/atributos graváveis retornam true para as propriedades IsValidForCreate ou IsValidForUpdate (geralmente ambas). Se qualquer uma dessas propriedades retornar false, isso será indicado.

Colunas/atributos somente leitura sempre retornam false para as propriedades IsValidForCreateeIsValidForUpdate.

As opções de coluna nesta documentação de referência vêm de uma implantação em que o inglês é o idioma base. Algumas opções podem variar dependendo do idioma base selecionado quando o ambiente é criado. Essas diferenças se alinham melhor com as opções que mais se adaptam ao idioma ou à cultura. Você pode personalizar essas opções alterando os rótulos ou adicionando e removendo opções conforme necessário.

Relationships

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

Propriedade	Tipo	Description
OneToManyRelationships	OneToManyRelationshipMetadata[]	Obtém a matriz de relacionamentos um-para-muitos para a entidade.
ManyToOneRelationships	OneToManyRelationshipMetadata[]	Obtém a matriz de relacionamentos muitos-para-um para a entidade.
ManyToManyRelationships	ManyToManyRelationshipMetadata[]	Obtém a matriz de relacionamentos muitos-para-muitos para a entidade.

Observação

É importante ter em mente que, embora cada tabela liste os relacionamentos que se aplicam a ela, cada relacionamento é compartilhado pelas duas tabelas. Os relacionamentos existem entre as tabelas. Embora existam relacionamentos Um-para-Muitos, os relacionamentos Muitos-para-Um são simplesmente uma exibição de um relacionamento Um-para-Muitos da tabela de referência.

Relacionamentos 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 pesquisa.
ReferencingAttribute	O nome lógico da coluna de pesquisa 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 operações executadas na entidade pai serão transmitidas em cascata para entidades relacionadas. Mais informações: Configuração em cascata

Relacionamentos 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 do relacionamento podem ser alterados.
ReferencedEntityNavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esse relacionamento. Mais informações: Propriedades de navegação da API Web
AssociatedMenuConfiguration	Dados usados por aplicativos baseados em modelo para controlar se/como os dados da entidade relacionada podem ser acessados na interface do usuário da entidade primária.

Relacionamentos de muitos para muitos

Cada relacionamento muitos-para-muitos inclui Entity1LogicalName e Entity2LogicalName. Para esta documentação, os detalhes do relacionamento são fornecidos no contexto da tabela atual. Ser Entity1 ou Entity2 não importa tanto.

Para cada relacionamento muitos-para-muitos, as seguintes propriedades são incluídas:

Propriedade	Description
IntersectEntityName	O nome lógico da tabela intersect que dá suporte a essa relação muitos para muitos
IsCustomizable	Se as propriedades do relacionamento podem ser alterados.
SchemaName	O nome do esquema do relacionamento.
IntersectAttribute	O nome da coluna na tabela de interseção que é a chave primária para registros desse tipo.
NavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esse relacionamento. Mais informações: Propriedades de navegação da API Web
AssociatedMenuConfiguration	Dados usados por aplicativos baseados em modelo para controlar se/como os dados da segunda tabela podem ser acessados na interface do usuário desta tabela.

No caso raro em que um relacionamento muitos-para-muitos é autorreferenciado, como para a Função de Conexão (ConnectionRole) connectionroleassociation_association, Entity1 ou Entity2 se anexam à propriedade.

Propriedade	Value
Entity1IntersectAttribute	O nome da coluna na tabela de interseção que é a chave primária para registros desse tipo como a primeira tabela.
Entity2IntersectAttribute	O nome da coluna na tabela de interseção que é a chave primária para registros desse tipo como a segunda tabela.
Entity1NavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esse relacionamento como a primeira tabela.
Entity2NavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esse relacionamento como a segunda tabela.
Entity1AssociatedMenuConfiguration	Dados usados por aplicativos baseados em modelo para controlar se/como os dados da segunda tabela podem ser acessados na interface do usuário desta tabela como a primeira tabela.
Entity2AssociatedMenuConfiguration	Dados usados por aplicativos baseados em modelo para controlar se/como os dados da segunda tabela podem ser acessados na interface do usuário desta tabela como a segunda tabela