Referência de tabela/entidade do Dataverse

Use essa referência para entender 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 tabela usam a classe EntityMetadata.

Esta referência inclui apenas as tabelas em que:

• EntityMetadata.IsPrivate Equals false

  Essa condição exclui tabelas sem casos de uso externo.

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

  A maioria das tabelas interseccionais contém apenas as quatro colunas necessárias para dar suporte à relação muitos para muitos. Eles não são úteis. Tabelas interseccionadas com mais de quatro colunas não são comuns e 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. Consulte a referência de tabela/entidade de aplicativos habilitados Dynamics 365.

Cada produto Dynamics 365 específico 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	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. Ele inclui apenas as propriedades mais úteis para desenvolvedores. Você pode alterar alguns valores de propriedade de entidade.

Columns

As colunas são listadas em duas seções separadas:

Seção	Description
Colunas/atributos graváveis	Colunas que você pode definir ao criar ou atualizar linhas em uma tabela. Essas colunas retornam true para as AttributeMetadata.IsValidForCreate propriedades ou AttributeMetadata.IsValidForUpdate , geralmente, ambas. Se uma das propriedades retornar false, essa condição será indicada.
Colunas/atributos somente leitura	Colunas que você pode recuperar, mas não pode definir ao criar ou atualizar linhas em uma tabela. Essas colunas sempre retornam false para as propriedades e AttributeMetadata.IsValidForUpdate as AttributeMetadata.IsValidForCreate propriedades.

Opções da coluna Escolha

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 mais de perto às opções que melhor se adaptam à linguagem ou à cultura. Você pode personalizar essas opções alterando os rótulos ou adicionando e removendo as 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

Embora cada tabela liste as relações que se aplicam a ela, cada relação é compartilhada por ambas as tabelas. Os relacionamentos existem entre as tabelas. Embora existam relações um-para-muitos, relações muitos para um são simplesmente uma visão de uma relação um-para-muitos da tabela de referência.

Relacionamentos 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 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	Dados que descrevem quais operações executadas na entidade pai são em cascata para entidades relacionadas. Para obter mais informações, consulte a configuração em cascata.

Relacionamentos 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 você pode alterar as propriedades da relação.
ReferencedEntityNavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para esse relacionamento. Para obter mais informações, consulte As 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 relação muitos para muitos, as seguintes ManyToManyRelationshipMetadata propriedades de classe estão incluídas:

Propriedade	Description
IntersectEntityName	O nome lógico da tabela de interseção que dá suporte a esse relacionamento muitos-para-muitos.
IsCustomizable	Se você pode alterar as propriedades da relação.
SchemaName	O nome do esquema do relacionamento.
IntersectAttribute (Entity1IntersectAttribute ou Entity2IntersectAttribute)	O nome da coluna na tabela de interseção que é a chave primária para registros desse tipo.
NavigationPropertyName (Entity1NavigationPropertyName ou Entity2NavigationPropertyName)	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 (Entity1AssociatedMenuConfiguration ou 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.

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 controlados por modelos para controlar se e como os dados da segunda tabela podem ser acessados na interface do usuário desta tabela como a segunda tabela.