Partilhar via


Referência de tabela/entidade de aplicativos habilitados do Dynamics 365

As tabelas Dataverse fornecem o conjunto comum de tabelas que todos os bancos de dados de ambiente têm. As tabelas listadas aqui são adicionadas ou modificadas quando você seleciona Habilitar aplicativos do Dynamics 365? , enquanto adiciona o Dataverse a um ambiente criado.

Quando tiver as licenças necessárias, pode instalar produtos do Dynamics 365 que podem adicionar ainda mais tabelas ou personalizar as tabelas existentes do Dynamics 365 ou do Dataverso.

Esta tabela lista outros produtos do Dynamics 365 que dependem dessa referência:

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

Esta referência inclui apenas os quadros em que:

  • IsPrivate é igual a false

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

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

Messages

As mensagens nesta lista são aplicáveis para a entidade. Por exemplo, as tabelas de propriedade do usuário suportam as mensagens , Assign, GrantAccesse ModifyAccess enquanto as RevokeAccesstabelas de propriedade da organização não.

SDK para .NET

Ao usar o SDK para .NET, você geralmente pode invocar a classe de solicitação correspondente que pertencerá aos namespaces Microsoft.Crm.Sdk.Messages ou Microsoft.Xrm.Sdk.Messages . Essas classes têm nomes que incluem o prefixo Request adicionado ao nome da mensagem.

Algumas mensagens são adicionadas como ações personalizadas para as soluções suportadas. Essas mensagens não são definidas nos assemblies do SDK, mas há várias maneiras de usá-las.

Web API

Ao usar a API da Web, você pode encontrar as funções e ações comuns do Dataverse OData definidas nesta referência:

Para essas funções e ações, e qualquer outra adicionada, você pode descobrir como usá-las ao:

  1. Examine o documento de serviço $metadata para obter detalhes sobre os parâmetros e valores de retorno. Consulte Definições de ação e Definições de função para obter detalhes.
  2. Invoque ações e funções. Consulte Usar ações da API da Web e Usar funções da API da Web para obter detalhes.

Events

Eventos são mensagens que existem para que você possa assiná-los. A menos que você tenha adicionado o evento, você não deve invocar a mensagem, apenas assiná-la. Pode subscrever eventos de várias formas diferentes, por exemplo:

Propriedades

Esta seção inclui propriedades de entidade selecionadas em vez de todas elas. Apenas as propriedades que se espera que sejam mais úteis para os desenvolvedores estã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 de escolha nesta documentação de referência vêm de uma implantaçã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 à língua ou cultura. Você é livre para personalizar essas 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.
ManyToOneRelacionamentos 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 para a entidade.

Observação

É importante ter em mente que, embora cada tabela liste as relações que se aplicam a ela, cada relação é compartilhada por ambas as tabelas. As relações existem entre as tabelas. Embora existam relações de UmTo-Many, as relações de Um para Um são simplesmente uma visão de uma relação de UmTo-Many 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 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-mãe serão transferidas em cascata para entidades relacionadas.
Para obter 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 da Web para essa relação.
Para obter mais informações: Propriedades de navegação da API Web
AssociatedMenuConfiguration Dados usados por aplicativos controlados por modelo para controlar se e como os dados de entidade relacionados podem ser acessados na interface do usuário a partir da entidade principal.

Relações muitos-para-muitos

Cada relação muitos-para-muitos inclui Entity1LogicalName e Entity2LogicalName. Para esta documentação, os detalhes do relacionamento 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 suporta essa relação muitos-para-muitos.
Você pode usar esse valor ao unir colunas de tabela usando FetchXml
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 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 da Web para essa relação.
Para obter mais informações: Propriedades de navegação da API Web
AssociatedMenuConfiguration Dados usados por aplicativos controlados por modelo para controlar se e como os dados da segunda tabela podem ser acessados na interface do usuário a partir dessa tabela.

No caso raro em que um relacionamento muitos-para-muitos é autorreferenciado, como para Connection Role (ConnectionRole) connectionroleassociation_association, Entity1 ou Entity2 é prepended para a propriedade.

Propriedade Valor
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 da Web para essa relação como a primeira tabela.
Entity2NavigationPropertyName O nome da propriedade de navegação com valor de coleção da API da Web para essa relação como a segunda tabela.
Entity1AssociatedMenuConfiguration Dados usados por aplicativos controlados por modelo para controlar se e como os dados da segunda tabela podem ser acessados na interface do usuário a partir desta tabela como a primeira tabela.
Entity2AssociatedMenuConfiguration Dados usados por aplicativos controlados por modelo para controlar se e como os dados da segunda tabela podem ser acessados na interface do usuário a partir desta tabela como a segunda tabela