Use o API da Web com metadados do Dynamics 365

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Você pode executar todas as operações da Web com metadados que você pode realizar usando o serviço da organização. Esta seção fornece orientações sobre como usar API da Web como os tipos de entidade incluídos em Web API Metadata EntityType Reference.

Há quatro caminhos definidos expostos de entidade para executar operações com as entidades de metadados conforme descrito na próxima tabela.

Caminho da entidade	Descrição
[URI da organização]/api/data/v8.2/EntityDefinitions	Contém as entidades EntityMetadata EntityType.
[URI da organização]/api/data/v8.2/RelationshipDefinitions	Contém ManyToManyRelationshipMetadata EntityType e OneToManyRelationshipMetadata EntityType já que os dois herdam de RelationshipMetadataBase EntityType.
[URI da organização]/api/data/v8.2/GlobalOptionSetDefinitions	Contém BooleanOptionSetMetadata EntityType definido globalmente e entidades OptionSetMetadata EntityType já que os dois herdam de OptionSetMetadataBase EntityType.
[URI da organização]/api/data/v8.2/ManagedPropertyDefinitions	Somente para uso interno.

Cada tipo de metadados usa MetadataId como o identificador de propriedade único, que ele herda de MetadataBase EntityType. Quando todas entidades de metadados têm um MetadataId, você não pode consultar todos eles diretamente. Por exemplo, você pode ver e executar operações no contexto da entidade EntityMetadata dos atributos que os contém.

Algumas entidades têm as diferenças substanciais das entidades que armazenam dados de negócios e de aplicativo, por exemplo:

• As propriedades de entidades de metadados usam muitos dos tipos enumerados definidos em Web API ComplexType Reference e Web API EnumType Reference em vez de tipos de dados primitivos usados para propriedades em entidades que herdam de crmbaseentity EntityType.

• Elas seguem de metadados a convenção de nomenclatura diferente e mantém o Pascal Case de exemplo de nome usado no estilo do serviço da organização.

• Os metadados de entidade mais extensivo de herança, que é necessário para realizar as conversões e recuperar os dados desejados.

Nesta seção

• Consultar metadados usando a API da Web
  Use o API da Web para consulta como um modo de metadados é o que pode ser feito com RetrieveMetadataChangesRequest e os objetivo no namespace Microsoft.Xrm.Sdk.Metadata.Query usando o serviço de organização.

• Recuperar metadados por nome ou por MetadataId
  Os aplicativos podem adaptar às alterações de metadados consultando configuração. Quando você sabe propriedades de uma de um item de metadados é possível recuperar, definições dos metadados da API.

• Criar e atualizar definições de entidade usando API da Web
  Você pode criar entidades e atributos e atualize usando API da Web como os mesmos de obter resultados que você tem com o CreateEntityRequest, UpdateEntityRequest, CreateAttributeRequest e UpdateAttributeRequest.

• Criar e atualizar relacionamentos de entidade usando API da Web
  Verifique se as elegíveis entidades correspondem para participar em um relacionamento com outras entidades e criar ou atualizar essas relações de API da Web.

Confira Também

Os metadados e os modelos de dados no Microsoft Dynamics 365
Procurar os metadados da sua organização
Usar o serviço da Organização com metadados do Dynamics 365
Use a API da Web do Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais