Usar la API web con metadatos de Dynamics 365

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Puede realizar cualquier operación de metadatos con la API web que puede realizar mediante el servicio de la organización. Esta sección proporciona instrucciones sobre cómo usar la API web con los tipos de entidad incluidos en Web API Metadata EntityType Reference.

Hay cuatro rutas del conjunto de entidades expuestas para realizar operaciones con las entidades de metadatos como se describe en la siguiente tabla.

Ruta del conjunto de entidades	Descripción
[URI de la organización]/api/data/v8.2/EntityDefinitions	Contiene entidades EntityMetadata EntityType.
[URI de la organización]/api/data/v8.2/RelationshipDefinitions	Contiene ManyToManyRelationshipMetadata EntityType y OneToManyRelationshipMetadata EntityType ya que ambas se heredan de RelationshipMetadataBase EntityType.
[URI de la organización]/api/data/v8.2/GlobalOptionSetDefinitions	Contiene entidades BooleanOptionSetMetadata EntityType y OptionSetMetadata EntityType definidas globalmente ya que ambas se heredan de OptionSetMetadataBase EntityType.
[URI de la organización]/api/data/v8.2/ManagedPropertyDefinitions	Sólo para uso interno.

Cada tipo de entidad de metadatos usa MetadataId como propiedad de identificador único, que se hereda del MetadataBase EntityType. Mientras todas las entidades de metadatos tienen una MetadataId, no se puede consultar todas ellas directamente. Por ejemplo, puede consultar y realizar operaciones en atributos solo en el contexto de la entidad EntityMetadata que los contiene.

Estas entidades tienen algunas diferencias sustanciales respecto de las entidades que almacenan datos de negocios y aplicaciones, por ejemplo:

• Las propiedades de las entidades de metadatos usan muchos de los tipos complejos y de enumeración definidos en Web API ComplexType Reference y Web API EnumType Reference en lugar de los tipos de datos primitivos usados para las propiedades en las entidades que se heredan de crmbaseentity EntityType.

• Las entidades de metadatos siguen otra convención de nomenclatura y mantienen el estilo de nomenclatura de mayúsculas y minúsculas Pascal usado en los ensamblados del servicio de la organización.

• Los campos de metadatos hacen un uso más extenso de la herencia, lo que requiere que quizá deba realizar conversiones para recuperar los datos que desee.

En esta sección

• Consulta de metadatos utilizando la API web
  Puede usar la API web para consultar metadatos de forma similar a lo que puede realizarse utilizando RetrieveMetadataChangesRequest y los objetos del espacio de nombres Microsoft.Xrm.Sdk.Metadata.Query con el servicio de la organización.

• Recuperar metadatos por nombre o identificador de metadatos
  Los aplicaciones pueden adaptarse a los cambios de configuración consultando los metadatos. Cuando conoce una de las propiedades clave de un elemento de metadatos, puede recuperar definiciones de metadatos mediante la API web.

• Crear y actualizar definiciones de entidad mediante la API web
  Puede crear y actualizar entidades y atributos mediante la web API para lograr los mismos resultados que obtiene con el servicio de la organización CreateEntityRequest, UpdateEntityRequest, CreateAttributeRequest y UpdateAttributeRequest.

• Crear y actualizar relaciones de entidad mediante la API web
  Puede comprobar si las entidades son elegibles para participar en una relación con otras entidades y luego crear o actualizar esas relaciones con la API web.

Ver también

Modelos de datos y metadatos en Microsoft Dynamics 365
Examinar los metadatos de la organización
Usar el servicio de la organización con metadatos de Dynamics 365
Use la API web de Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright