Compartir a través de


Referencia de tabla/entidad de Dataverse

Utilice esta referencia para comprender las operaciones disponibles que se pueden realizar para tablas específicas, las columnas predeterminadas de cada tabla/entidad y las relaciones entre tablas.

Esta referencia incluye solo aquellas tablas donde:

  • IsPrivate es igual a false

    • Esto excluye las tablas donde no existe ningún caso de uso externo.
  • IsIntersect es igual a false o IsIntersect es igual a true y la tabla contiene más de 4 columnas.

    • La mayoría de las tablas de intersección contienen solo las 4 columnas necesarias para soportar la relación de muchos a muchos. No son útiles. Las tablas de intersección con más de cuatro columnas son más interesantes.

Para ver información sobre todas las tablas en su alinear, consulte Explorar definiciones de tablas en su alinear.

Propiedades

En esta sección se incluyen las propiedades de entidad seleccionadas en lugar de todos ellas. Solo se incluyen las propiedades que se espera sean más útiles para los desarrolladores. Algunos valores de propiedades de las entidades se pueden cambiar.

Columnas

Las columnas se enumeran en dos secciones separadas: Columnas/atributos escribibles y Columnas/atributos de solo lectura. La finalidad de esta separación es poner el foco en las columnas que un desarrollador puede establecer al crear o actualizar filas en una tabla. Comprender estas columnas ayuda a un desarrollador a comprender lo que pueden hacer con la tabla aparte de recuperar los valores.

Las columnas en la sección Columnas/atributos escribibles devuelven verdadero para las propiedades IsValidForCreate o IsValidForUpdate , (generalmente ambas). Si alguna de estas propiedades devuelve un valor false, esto se indica.

Las columnas/atributos de solo lectura siempre devuelven falso para las propiedades IsValidForCreateyIsValidForUpdate .

Las opciones de la columna de selección en esta documentación de referencia provienen de una implementación donde el inglés es el idioma base. Algunas opciones de elección pueden variar dependiendo del idioma base seleccionado cuando se crea ambiente. Estas diferencias se ajustan más estrechamente a las opciones que mejor se adaptan al idioma o la cultura. Usted es libre de personalizar estas opciones cambiando las etiquetas o agregando y eliminando opciones según sea necesario.

Relaciones

La clase EntityMetadata incluye tres propiedades para representar Relaciones:

Propiedad Tipo Descripción
Relaciones de uno a muchos Metadatos de relación de uno a muchos[] Obtiene la matriz de relaciones de uno a varios para la entidad.
Relaciones de muchos a uno Metadatos de relación de uno a muchos[] Obtiene la matriz de relaciones de varios a uno para la entidad.
Relaciones entre muchos y muchos Metadatos de relación de muchos a muchos[] Obtiene la matriz de relaciones de varios a varios para la entidad.

Nota

Es importante tener en cuenta que mientras cada tabla muestra las relaciones que se aplican a ella, cada relación está compartida por las ambas tablas. Los Relaciones existen entre las tablas. Si bien existen relaciones de uno a muchos Relaciones, las relaciones de muchos a uno Relaciones son simplemente una vista de una relación de uno a muchos desde la tabla de referencia.

Muchos a uno Relaciones

Incluye estas OneToManyRelationship propiedades:

Property Description
ReferencedEntity El nombre lógico de la tabla relacionada.
ReferencedAttribute El nombre lógico de la clave principal de la tabla relacionada.
ReferencingEntity El nombre lógico de la tabla relacionada que tiene la columna de búsqueda.
ReferencingAttribute El nombre lógico de la columna de búsqueda en la tabla relacionada que contiene una referencia a la clave principal de la tabla principal.
IsHierarchical Si la relación representa una relación jerárquica como que se hace referencia a sí misma.
CascadeConfiguration Datos que describen qué operaciones realizadas en la entidad principal se ejecutarán en cascada sobre las entidades relacionadas.
Más información: Configuración en cascada

Relaciones de uno a varios

Incluye estas OneToManyRelationship propiedades:

Property Description
ReferencingEntity El nombre lógico de la tabla relacionada.
ReferencingAttribute El nombre lógico de la columna de la tabla relacionada que contiene una referencia a la clave principal de la tabla principal.
IsCustomizable Si las propiedades de la relación se pueden cambiar.
ReferencedEntityNavigationPropertyName El nombre de la propiedad de navegación valorada como colección de la API web para esta relación.
Más información: Propiedades de navegación de la API web
AssociatedMenuConfiguration Datos usados por aplicaciones basadas en modelos para controlar si y cómo se puede acceder a los datos de la entidad relacionada en la interfaz de usuario de la entidad principal.

Relaciones de varios a varios

Cada relación de muchos a muchos incluye Entity1LogicalName y Entity2LogicalName. Para esta documentación, los detalles de la relación se proporcionan en el contexto de la tabla actual. Si lo es o no, en realidad no importa. Entity1 Entity2

Para cada relación de varios a varios las propiedades siguientes se incluyen:

Propiedad Descripción
IntersectEntityName El nombre lógico de la tabla de intersección que admite esta relación de varios a varios
IsCustomizable Si las propiedades de la relación se pueden cambiar.
SchemaName El nombre del esquema de la relación.
IntersectAttribute El nombre de la columna en la tabla de intersección que es la clave principal para los registros de este tipo.
NavigationPropertyName El nombre de la propiedad de navegación valorada como colección de la API web para esta relación.
Más información: Propiedades de navegación de la API web
AssociatedMenuConfiguration Datos utilizados por aplicaciones basadas en modelos para controlar si se puede acceder a los datos de la segunda tabla en la interfaz de usuario desde esta tabla y cómo hacerlo.

En el caso poco común en que una relación de muchos a muchos sea autorreferencial, como en el caso del rol de conexión (ConnectionRole), se antepone connectionroleassociation_association ,o Entity1 a la propiedad. Entity2

Property valor
Entity1IntersectAttribute El nombre de la columna en la tabla de intersección que es la clave principal para los registros de este tipo como la primera tabla.
Entity2IntersectAttribute El nombre de la columna en la tabla de intersección que es la clave principal para los registros de este tipo como la segunda tabla.
Entity1NavigationPropertyName El nombre de la propiedad de navegación con valor de colección de API web para esta relación como la primera tabla.
Entity2NavigationPropertyName El nombre de la propiedad de navegación con valor de colección de API web para esta relación como segunda tabla.
Entity1AssociatedMenuConfiguration Datos utilizados por aplicaciones basadas en modelos para controlar si se puede acceder a los datos de la segunda tabla en la interfaz de usuario desde esta tabla como primera tabla y cómo hacerlo.
Entity2AssociatedMenuConfiguration Datos utilizados por aplicaciones basadas en modelos para controlar si se puede acceder a los datos de la segunda tabla en la interfaz de usuario desde esta tabla como segunda tabla y cómo hacerlo.