Referência de tabela/entidade do Dynamics 365 Field Service

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

A referência de tabela/entidade de aplicativos habilitados do Dynamics 365 contém as tabelas adicionais necessárias para que você possa instalar os aplicativos do Dynamics 365, como o Field Service.

As tabelas listadas aqui são adicionadas ou modificadas quando você opta por instalar o Dynamics 365 Field Service enquanto adiciona o Dataverse a um ambiente criado. Os esquemas de tabela podem ter uma aparência diferente, se houver outros aplicativos instalados em seu ambiente do Dataverse.

Observação

Esta documentação de referência exclui determinadas tabelas que existem em seu ambiente. Por exemplo, tabelas destinadas apenas para uso interno e que consideramos menos relevantes para desenvolvedores do Field Service. As alterações nos esquemas de tabela não são refletidas imediatamente porque geramos essa documentação em determinados intervalos.

Lançamos esta documentação de referência em fevereiro de 2025. Você pode notar mudanças com mais frequência à medida que coletamos feedback inicial e as abordamos.

Para exibir informações atuais e não filtradas de todas as tabelas em seu ambiente do Dataverse, use o navegador de definição de tabela. O navegador de definição de tabela é uma solução gerenciada descrita em Procurar definições de tabela em seu ambiente.

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 true a 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 à relação Muitos para Muitos. Eles 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 dão suporte a , , Assign, e GrantAccess mensagens, ModifyAccessenquanto as RevokeAccesstabelas de propriedade da organização não.

SDK 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ção da API Web

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

1. Examine o documento de serviço $metadata 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. Invocar 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á-los. A menos que você tenha adicionado o evento, você não deve invocar a mensagem, apenas assiná-la. Você pode se inscrever em eventos de várias maneiras diferentes, por exemplo:

• Use o conector do PowerAutomate Dataverse usando o gatilho Quando uma ação é executada .
• Registre um plug-in do Dataverse para responder ao evento.
• Enviar 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 em vez de todas elas. Apenas as propriedades que se espera serem 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 um 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. Essas diferenças se alinham mais de perto às opções que melhor se adequam 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
Um para muitos relacionamentos	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.
MuitosParaMuitosRelacionamentos	Metadados de ManyToManyRelationship[]	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 deTo-Many Um, as relações Muitos-para-Um são simplesmente uma exibição de uma relação deTo-Many Um 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 pai serão transmitidas em cascata para entidades relacionadas. 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 Web para essa relação. Mais informações: Propriedades de navegação da API Web
AssociatedMenuConfiguration	Dados usados por aplicativos baseados em modelo para controlar se e como os dados da entidade relacionada podem ser acessados na interface do usuário da entidade primária.

Relações 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 propriedades são incluídas:

Propriedade	Description
IntersectEntityName	O nome lógico da tabela de interseção que dá suporte a 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 Web para essa relação. Mais informações: Propriedades de navegação da API Web
AssociatedMenuConfiguration	Dados usados por aplicativos baseados em modelo para controlar se e como os dados da segunda tabela podem ser acessados na interface do usuário dessa tabela.

No caso raro em que uma relação muitos-para-muitos é autorreferenciada, como para a Função de Conexão (ConnectionRole) connectionroleassociation_association, Entity1 ou Entity2 é anexada à 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 essa relação como a primeira tabela.
Entity2NavigationPropertyName	O nome da propriedade de navegação com valor de coleção da API Web para essa relação como a segunda tabela.
Entity1AssociatedMenuConfiguration	Dados usados por aplicativos baseados em modelo para controlar se e como os dados da segunda tabela podem ser acessados na interface do usuário dessa tabela como a primeira tabela.
Entity2AssociatedMenuConfiguration	Dados usados por aplicativos baseados em 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