Referencia de tabla/entidad de Dataverse

Nota

¿No está seguro de entidad frente a tabla? Vea Desarrolladores: comprender la terminología en Microsoft 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
    • Esto excluye las tablas que se usan para definir relaciones de varios a varios.
  • La entidad admite algún tipo de operación de modificación de datos directa.
    • Esto excluye las tablas con las que no puede trabajar directamente.

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

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 que se pueden escribir 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 de la sección Columnas/atributos que se pueden escribir devuelven un valor verdadero para ya sea la propiedad IsValidForCreate o para la propiedad IsValidForUpdate (normalmente para ambas). Si alguna de estas propiedades devuelve un valor false, esto se indica.

Las Columnas/atributos de solo lectura siempre devolverán un valor falso para las propiedades IsValidForCreate e IsValidForUpdate.

Relaciones

La clase EntityMetadata incluye tres propiedades para representar relaciones:

Propiedad Tipo Descripción
OneToManyRelationships OneToManyRelationshipMetadata[] Obtiene la matriz de relaciones de uno a varios para la entidad.
EntityMetadata.ManyToOneRelationships OneToManyRelationshipMetadata[] Obtiene la matriz de relaciones de varios a uno para la entidad.
EntityMetadata.ManyToManyRelationships ManyToManyRelationshipMetadata[] 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. Las relaciones existen entre las tablas. Mientras las relaciones de uno a varios existen, las relaciones de Varios a uno son simplemente una vista de una relación de uno a varios desde la tabla de referencia.

Relaciones de uno a varios

Con el fin de representar que no hay ninguna relación de Varios a uno real con un mínimo de confusión, los detalles de cada relación solo se documentan una vez. Cada una de las relaciones de uno a varios aparece con la tabla de referencia e incluye detalles de la relación seleccionada y un vínculo a la relación de Varios a uno correspondiente. Cada relación de varios a uno que se muestra solo incluye un vínculo a la correspondiente relación de uno a varios.

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

Propiedad Descripción
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.
IsHierarchical Si la relación representa una relación jerárquica como que se hace referencia a sí misma.
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.
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 varios a varios

Cada relación de varios a varios incluye Entity1LogicalName y Entity2LogicalName. Para esta documentación, los detalles de las relaciones solo se incluyen en el tema de Entity1. Cada relación de varios a varios donde la entidad es Entity2, solo incluye un vínculo a los detalles que se encuentran en el tema de Entity1.

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
Entity1LogicalName El nombre lógico de la primera tabla de la relación.
Entity1IntersectAttribute El nombre lógico de la columna de la tabla de intersección que contiene una referencia a la clave principal de la primera tabla.
Entity1NavigationPropertyName 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.
Entity1AssociatedMenuConfiguration Datos utilizados por aplicaciones basadas en modelos para controlar si se puede acceder a los datos de la primera tabla en la interfaz de usuario desde la segunda tabla y cómo.
Entity2LogicalName El nombre lógico de la segunda tabla de la relación.
Entity2IntersectAttribute El nombre lógico de la columna de la tabla de intersección que contiene una referencia a la clave principal de la segunda tabla.
Entity2NavigationPropertyName Suele ser el mismo valor que el Entity1NavigationPropertyName
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 la primera tabla y cómo.
IsCustomizable Si las propiedades de la relación se pueden cambiar.

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).