Utilizar la API web con definiciones de tabla

Puede realizar cualquiera de las operaciones de definición de tabla y columna (metadatos) con la API web que puede realizar mediante el SDK para .NET. En esta sección se proporcionan instrucciones sobre cómo usar la API web con los tipos de entidad incluidos en Web API Metadata Entity Type Reference.

Hay cuatro rutas de conjuntos de entidades expuestas para realizar operaciones con las entidades de definición, como se describe en la tabla siguiente.

Ruta de acceso del conjunto de entidades	Description
[URI de la organización]/api/data/v9.2/EntityDefinitions	Contiene una colección de EntityMetadata EntityType.
[URI de la organización]/api/data/v9.2/RelationshipDefinitions	Contiene ManyToManyRelationshipMetadata EntityType y OneToManyRelationshipMetadata EntityType , ya que ambos heredan de RelationshipMetadataBase EntityType.
[URI de la organización]/api/data/v9.2/GlobalOptionSetDefinitions	Contiene una colección de valores BooleanOptionSetMetadata EntityType y OptionSetMetadata EntityType definidos globalmente, ya que ambos heredan de OptionSetMetadata EntityType.
[URI de la organización]/api/data/v9.2/ManagedPropertyDefinitions	Sólo para uso interno.

Cada tipo de entidad de definición usa MetadataId como propiedad de identificador único, que hereda de MetadataBase EntityType. Aunque todas las entidades de definición tienen un MetadataId, no puede consultarlas directamente. Por ejemplo, puede consultar y realizar operaciones en atributos (columnas de tabla) solo en el contexto de la entidad que los EntityMetadata contiene.

Estas entidades de definición tienen algunas diferencias importantes de las tablas que almacenan datos empresariales y de aplicaciones, por ejemplo:

• Las propiedades de las entidades de definición utilizan muchos de los tipos complejos y de enumeración definidos en Web API Complex Type Reference y Web API Enum Type Reference en lugar de los tipos de datos primitivos usados para las propiedades de las entidades que heredan de crmbaseentity EntityType.

• Las entidades de definición siguen una convención de nomenclatura diferente y mantienen el estilo de nomenclatura Pascal Case usado en los ensamblados del SDK para .NET.

• Las entidades de definición hacen un uso más extenso de la herencia, lo que implica que tiene hacer conversiones para recuperar los datos que desea.

En esta sección

Consultar definiciones de tabla con la API web
Puede usar la API web para consultar definiciones de tabla o columna mediante un estilo de consulta RESTful.

Recuperar definiciones de tabla por nombre o MetadataId
Las aplicaciones pueden adaptarse a los cambios de configuración consultando las definiciones de tabla y columna. Cuando conoce una de las propiedades clave de un elemento de definición, puede recuperar definiciones mediante la API web.

Crear y actualizar definiciones de tabla mediante la API web
Puede crear y actualizar tablas mediante la API web para lograr los mismos resultados que obtenga con el SDK para .NET CreateEntityRequest y UpdateEntityRequest.

Creación y actualización de definiciones de columna mediante la API web
Puede crear y actualizar columnas mediante la API web para lograr los mismos resultados que obtiene con el SDK para .NET CreateAttributeRequesty UpdateAttributeRequest.

Creación y actualización de relaciones de tabla mediante la API web
Puede comprobar si las tablas son aptas para participar en una relación con otras tablas y, a continuación, crear o actualizar esas relaciones mediante la API web.

Búsquedas en varias tablas
Las columnas de tipo de búsqueda de varias tablas permiten a un usuario usar una tabla específica que tenga varias relaciones de uno a varios (1:N) con otras tablas del entorno. Una sola columna de tipo de búsqueda puede hacer referencia a varias otras tablas. Un valor de búsqueda enviado a la columna de tipo de varias tablas coincidirá con un registro en cualquiera de las tablas relacionadas. Se pueden crear búsquedas de varias tablas utilizando tanto tablas locales como virtuales como tablas de referencia.

Creación y actualización de opciones (conjuntos de opciones) mediante la API web
Explica cómo trabajar con campos de opciones globales y locales. Cómo recuperar valores de opción, agregar, actualizar, eliminar y volver a ordenar opciones.

Consulte también

Examinar las definiciones de tabla de tu entorno
Uso de la API Web de Microsoft DataverseEjemplo de operaciones del esquema de tabla API Web
Ejemplo de operaciones de esquema de tabla de API web (C#)