Referencia de tabla/entidad de Dataverse

Use esta referencia para comprender las operaciones disponibles para tablas específicas, las columnas predeterminadas de cada tabla y las relaciones entre tablas. Las definiciones de tabla usan la clase EntityMetadata.

Esta referencia incluye solo aquellas tablas donde:

  • EntityMetadata.IsPrivate es igual a false

    Esta condición excluye las tablas sin casos de uso externos.

  • EntityMetadata.IsIntersect equals false o IsIntersect es igual true y la tabla contiene más de cuatro columnas.

    La mayoría de las tablas intersect contienen solo las cuatro columnas necesarias para admitir la relación de varios a varios. No son útiles. Las tablas de intersección con más de cuatro columnas no son comunes y más interesantes.

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

Referencia de la tabla de productos de Dynamics 365

Los productos de Dynamics 365 usan Dataverse. Al crear un entorno para productos de Dynamics 365, el entorno tiene un conjunto común de tablas para todos los productos de Dynamics 365. Consulte la referencia de la entidad o tabla de aplicaciones habilitadas Dynamics 365.

Cada producto Dynamics 365 específico puede agregar más tablas. En la tabla siguiente se muestra la referencia de tabla para productos específicos de Dynamics 365:

Documentación del producto Referencia de la tabla de productos
Ventas Referencia de tabla/entidad de ventas
Servicio de campo Referencia de tabla/entidad de Field Service
Servicio al cliente Referencia de tabla/entidad de Customer Service

Propiedades

En esta sección se incluyen las propiedades de entidad seleccionadas en lugar de todos ellas. Incluye solo las propiedades que son más útiles para los desarrolladores. Puede cambiar algunos valores de propiedad de entidad.

Columnas

Las columnas se enumeran en dos secciones independientes:

Section Descripción
Columnas o atributos grabables Columnas que puede establecer al crear o actualizar filas en una tabla. Estas columnas devuelven true para las AttributeMetadata.IsValidForCreate propiedades o AttributeMetadata.IsValidForUpdate , normalmente ambas. Si alguna propiedad devuelve false, se indica esta condición.
Columnas o atributos de solo lectura Columnas que se pueden recuperar, pero no se pueden establecer al crear o actualizar filas en una tabla. Estas columnas siempre devuelven false para las AttributeMetadata.IsValidForCreate propiedades y AttributeMetadata.IsValidForUpdate .

Opciones de la columna Opción

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 alinean más estrechamente con las opciones que mejor se adapten al idioma o la referencia cultural. Puede personalizar estas opciones cambiando las etiquetas o agregando y quitando 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

Aunque cada tabla muestra las relaciones que se aplican a ella, ambas tablas comparten cada relación. Los Relaciones existen entre las tablas. Aunque existen relaciones uno a varios, las relaciones de varios a uno son simplemente una vista de una relación uno a varios de la tabla de referencia.

Relaciones varios a uno

Incluye estas OneToManyRelationshipMetadata propiedades de clase :

Propiedad Descripción
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 las operaciones realizadas en la entidad primaria en cascada a las entidades relacionadas.
Para obtener más información, consulte Configuración en cascada.

Relaciones de uno a varios

Incluye estas OneToManyRelationshipMetadata propiedades de clase :

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.
IsCustomizable Si puede cambiar las propiedades de la relación.
ReferencedEntityNavigationPropertyName El nombre de la propiedad de navegación valorada como colección de la API web para esta relación.
Para obtener más información, consulte Propiedades de navegación de 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. Entity1Entity2

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

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 puede cambiar las propiedades de la relación.
SchemaName El nombre del esquema de la relación.
IntersectAttribute (Entity1IntersectAttribute o Entity2IntersectAttribute) El nombre de la columna en la tabla de intersección que es la clave principal para los registros de este tipo.
NavigationPropertyName (Entity1NavigationPropertyName o Entity2NavigationPropertyName) 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 (Entity1AssociatedMenuConfiguration o 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 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

Propiedad 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 la 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 usados por aplicaciones controladas por modelos para controlar si y cómo se puede acceder a los datos de la segunda tabla en la interfaz de usuario de esta tabla como segunda tabla.