Compartir a través de

Utilizar la API web con definiciones de tabla

  • Artículo

Puede realizar cualquier operación de definición de tablas y columnas (metadatos) con la API web que puede realizar mediante el SDK para .NET. Esta sección proporciona 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 entidades de definición como se describe en la siguiente tabla.

Ruta del conjunto de entidades Descripción
[Organization URI]/api/data/v9.2/EntityDefinitions Contiene una colección EntityMetadata EntityType.
[Organization URI]/api/data/v9.2/RelationshipDefinitions Contiene ManyToManyRelationshipMetadata EntityType y OneToManyRelationshipMetadata EntityType ya que ambas se heredan de RelationshipMetadataBase EntityType.
[Organization URI]/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.
[Organization URI]/api/data/v9.2/ManagedPropertyDefinitions Sólo para uso interno.

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

Estas entidades de definición tienen algunas diferencias sustanciales con las tablas que almacenan datos comerciales 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 utilizados en entidades que heredan de crmbaseentity EntityType.

  • Las entidades de definición siguen una convención de nomenclatura diferente y mantienen el estilo de nomenclatura de Pascal Case que se usa 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 utilizar la API web para consultar definiciones de tablas o columnas mediante un estilo de consulta RESTful.

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

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

Crear y actualizar definiciones de columna mediante la API web
Puede crear y actualizar columnas utilizando la API web para lograr los mismos resultados que obtiene con el SDK para .NET CreateAttributeRequest y UpdateAttributeRequest.

Crear y actualizar relaciones de tabla mediante la API web
Puede verificar si las tablas son elegibles para participar en una relación con otras tablas y luego crear o actualizar esas relaciones usando la API web.

Búsquedas en varias tablas
Las columnas de tipo de búsqueda de varias tablas permiten al usuario utilizar una tabla específica que tiene varias tablas de relaciones uno a varios (1:N) en otras tablas del entorno. Una sola columna de tipo de búsqueda puede hacer referencia a otras tablas. Un valor de búsqueda enviado a la columna de tipo de tabla múltiple se comparará con un registro en cualquiera de las tablas relacionadas. Las búsquedas de tablas múltiples se pueden crear con tablas locales y tablas virtuales como tablas referenciadas.

Crear y actualizar selecciones (conjuntos de opciones) mediante la API web
Explica cómo trabajar con columnas de opciones globales y locales. Cómo recuperar valores de opciones, agregar, actualizar, eliminar y reordenar opciones.

Consulte también

Examinar las definiciones de tablas para su entorno
Use la API web Microsoft Dataverse Ejemplo de operaciones de esquema de tabla de la API Web
Ejemplo de operaciones de esquema de tabla de API web (C#)

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).