Tabela/referência de entidade do Dynamics 365 Sales

Tabelas do Dataverse fornecem o conjunto comum de tabelas que todos os bancos de dados de ambiente têm.

A tabela/referência de entidade de aplicativos habilitados para o Dynamics 365 contém as tabelas adicionais necessárias antes de instalar aplicativos do Dynamics 365, como o Sales.

As tabelas listadas aqui são adicionadas ou modificadas quando você opta por instalar o Dynamics 365 Sales enquanto adiciona o Dataverse a um ambiente criado.

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. Saiba mais sobre tabelas privadas

• 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.

Messages

As mensagens nesta lista são aplicáveis à entidade. Por exemplo, as tabelas de propriedade do usuário suportam mensagens Assign, GrantAccess, ModifyAccess e RevokeAccess, enquanto tabelas de propriedade da organização, não.

SDK do para .NET

Ao usar o SDK para .NET, geralmente você 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 às quais elas dão suporte. 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 Web, você pode encontrar as funções e ações comuns do Dataverse OData definidas nestas referências:

• Referência de ação da API Web
• Referência de funções da API Web

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

1. Examine o documento $metadata service para obter detalhes sobre os parâmetros e valores retornados. 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 Web e Usar funções da API Web para obter detalhes.

Eventos

Eventos são mensagens que existem para que você possa assiná-las. A menos que você tenha adicionado o evento, você não deve invocar a mensagem, apenas assiná-la. Você pode assinar eventos de várias maneiras, por exemplo:

• Use o conector do Power Automate Dataverse usando o gatilho Quando uma ação é executada.
• Registre um plug-in do Dataverse para responder ao evento.
• Envie dados de eventos para o Azure ou um web hook com a integração do Dataverse com o Azure

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:

Relacionamentos muitos-para-um

Inclui estas OneToManyRelationship propriedades:

Relacionamentos um-para-muitos

Inclui estas OneToManyRelationship propriedades:

Relacionamento 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:

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.