Compartir a través de


Referencia de tabla o entidad de Dynamics 365 Sales

Las tablas de Dataverse proporcionan el conjunto común de tablas que tienen todas las bases de datos del entorno.

Referencia de tabla/entidad de aplicaciones Dynamics 365 Enabled contiene las tablas adicionales que se requieren antes de poder instalar aplicaciones Dynamics 365 como Sales.

Las tablas enumeradas aquí se agregan o modifican cuando selecciona instalar Dynamics 365 Sales mientras agrega Dataverse a un entorno que crea.

Esta referencia incluye solo aquellas tablas donde:

  • IsPrivate es igual a false

  • 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 admitir la relación de varios a varios. No son útiles. Las tablas de intersección con más de cuatro columnas son más interesantes.

Mensajes

Los mensajes de esta lista son aplicables para la entidad. Por ejemplo, las tablas que pertenecen al usuario admiten los mensajes Assign, GrantAccess, ModifyAccess y RevokeAccess mientras que las tablas que pertenecen a la organización no los admiten.

SDK para .NET

Al usar el SDK para .NET, normalmente puede invocar la clase de solicitud correspondiente, que pertenecerá a los espacios de nombres Microsoft.Crm.Sdk.Messages o Microsoft.Xrm.Sdk.Messages. Estas clases tienen nombres que incluyen el prefijo Request agregado al nombre del mensaje.

Algunos mensajes se agregan como acciones personalizadas para las soluciones que admiten. Estos mensajes no se definen en los ensamblados del SDK, pero hay varias maneras de usarlos.

API Web

Al usar la API web, puede encontrar las funciones y acciones comunes Dataverse de OData definidas en estas referencias:

Para estas funciones y acciones, y cualquier otra adicional que se agregue, puede descubrir cómo usarlas de la siguiente manera:

  1. Examine el documento de servicio $metadata para obtener detalles sobre los parámetros y los valores devueltos. Consulte Definiciones de acciones y Definiciones de funciones para obtener más información.
  2. Invocar acciones y funciones. Consulte Usar acciones de la API web y Usar funciones de la API web para obtener más información.

Eventos

Los eventos son mensajes que existen para que puedas suscribirte a ellos. A menos que haya agregado el evento, no debe invocar el mensaje, solo suscribirse a él. Puede suscribirse a eventos de varias maneras diferentes, por ejemplo:

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

Las opciones de la columna de opción de esta documentación de referencia proceden de una implementación en la que el inglés es el idioma base. Algunas opciones de elección pueden variar en función del idioma base seleccionado al crear el entorno. Estas diferencias se alinean más estrechamente con las opciones que mejor se adaptan al idioma o la cultura. Puede 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
OneToManyRelationships OneToManyRelationshipMetadata[] Obtiene la matriz de relaciones de uno a varios para la entidad.
ManyToOneRelationships OneToManyRelationshipMetadata[] Obtiene la matriz de relaciones de varios a uno para la entidad.
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 varios a uno

Incluye estas propiedades OneToManyRelationship:

Property Description
ReferencedEntity El nombre lógico de la tabla relacionada.
ReferencedAttribute El nombre lógico de 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 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.
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 propiedades OneToManyRelationship:

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 varios a varios incluye Entity1LogicalName y Entity2LogicalName. En esta documentación, los detalles de la relación se proporcionan en el contexto de la tabla actual. Si es Entity1 o Entity2 no es realmente importante.

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.
Puede usar este valor al unir columnas de tabla mediante FetchXml
IsCustomizable Si las propiedades de la relación se pueden cambiar.
SchemaName El nombre de esquema de la relación.
IntersectAttribute El nombre de la columna de la tabla de intersección es la clave principal para 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.

En el raro caso de que una relación de varios a varios sea autorreferencial, como para el Rol de conexión (ConnectionRole) connectionroleassociation_association, Entity1 o Entity2 se antepone a la propiedad.

Property valor
Entity1IntersectAttribute El nombre de la columna de la tabla de intersección es la clave principal para registros de este tipo como la primera tabla.
Entity2IntersectAttribute El nombre de la columna de la tabla de intersección es la clave principal para registros de este tipo como la segunda tabla.
Entity1NavigationPropertyName El nombre de la propiedad de navegación valorada como colección de la API web para esta relación como la primera tabla.
Entity2NavigationPropertyName El nombre de la propiedad de navegación valorada como colección de la API web para esta relación como la 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 la primera tabla.
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 la segunda tabla