Compartir a través de

Definiciones de tabla en Microsoft Dataverse

Cada tabla proporciona la capacidad de almacenar datos estructurados. Para los desarrolladores, las tablas corresponden a las clases que se usan al trabajar con datos en Microsoft Dataverse.

Nombres de tabla

Cada tabla tiene un nombre único que se define al crearla. Verá este nombre de varias maneras:

Nombre de propiedad Description
SchemaName Normalmente, una versión con estilo de mayúsculas y minúsculas Pascal del nombre lógico. Por ejemplo, Cuenta
CollectionSchemaName Forma plural del nombre del esquema. Por ejemplo, Cuentas
LogicalName Todas las versiones en minúscula del nombre de esquema. Por ejemplo, cuenta
LogicalCollectionName Todas las versiones en minúscula del nombre de esquema de la colección. Por ejemplo, cuentas
EntitySetName Se usa para identificar colecciones con la API web. De forma predeterminada, es igual que el nombre de la colección lógica.
Puede cambiar el nombre del conjunto de entidades mediante programación actualizando las definiciones. Pero solo realice este cambio antes de escribir cualquier código de API web para la tabla. Para obtener más información, consulte Nombre del conjunto de entidades.

Nota:

EntitySetName se genera automáticamente cambiando el EntityName al plural de ese nombre. Ejemplo: EntityName: Car EntitySetName: Cars. Al crear manualmente una nueva tabla, EntitySetName se puede cambiar. El sistema creado EntitySetName siempre es el plural de EntityName y no se puede cambiar a través de la interfaz de cliente. Esta regla se aplica tanto a las tablas del sistema como a las tablas creadas para intersecciones de relaciones de muchos a muchos.

Al crear una tabla personalizada, el valor del prefijo de personalización del publicador de la solución antepone el nombre que elija. No se pueden cambiar los nombres de una tabla después de la creación, excepto el nombre del conjunto de entidades. Si quiere nombres coherentes para los elementos de definición de la solución, créelos en el contexto de una solución que cree asociada a un publicador de soluciones que contenga el prefijo de personalización que desea usar. Para obtener más información, consulte Publicador de soluciones.

Cada tabla también tiene tres propiedades que pueden mostrar valores localizados:

Nombre Description
DisplayName Normalmente, es igual al nombre de esquema, pero puede incluir espacios. Por ejemplo, Cuenta
DisplayCollectionName Versión plural del nombre para mostrar. Por ejemplo, Cuentas
Description Frase corta que describe la tabla que es Negocio que representa a un cliente o cliente potencial. La empresa a la que se factura en transacciones comerciales.

Use estos valores localizables para hacer referencia a las tablas de una aplicación. Puede cambiar estos valores en cualquier momento. Para agregar o editar valores localizados, vea Traducir texto personalizado de tabla, formulario y columna en otros idiomas.

Clave principal

El PrimaryIdAttribute valor de la propiedad es el nombre lógico de la columna que actúa como clave principal para la tabla.

De forma predeterminada, todas las tablas incluyen una sola columna de identificador único GUID denominada <table logical name>Id.

Nombre principal

El PrimaryNameAttribute valor de propiedad es el nombre lógico de la columna que almacena el valor de cadena que identifica el registro de tabla. Este valor aparece en un vínculo que abre el registro en una interfaz de usuario.

Ejemplo: La tabla Contact usa la fullname columna como columna de nombre principal.

Nota:

No todas las tablas tienen un nombre principal. Algunas tablas no están diseñadas para mostrarse en una interfaz de usuario.

Imágenes de entidad

El valor de la propiedad PrimaryImageAttribute es el nombre lógico de la columna de imagen que eliges para representar el registro de entidad. Una aplicación puede mostrar esta imagen.

Ejemplo: la columna EntityImagede la tabla Contact puede almacenar una imagen del contacto.

Nota:

Esta imagen es diferente del icono que muestran las aplicaciones basadas en modelos para una tabla. La IconVectorName propiedad contiene el nombre del recurso web SVG que establece el icono.

Para obtener más información, consulte:

Tipos de tablas

Las funcionalidades y el comportamiento de las tablas dependen de varias propiedades de tabla. La mayoría de estas propiedades son relativamente simples y tienen nombres descriptivos. Cuatro propiedades que requieren una explicación más son: propiedad, tablas de actividad, tabla Activityparty y tablas secundarias.

Propiedad de la tabla

Puede clasificar las tablas por el modo en que los datos de ellos son propiedad. Este concepto es importante para entender cómo aplicar seguridad a las tablas. La OwnershipType propiedad contiene esta información. En la tabla siguiente se describen los distintos tipos de propiedad:

Tipo de propiedad Description
Negocio Los datos pertenecen a la unidad de negocio. El acceso a los datos se puede controlar en el nivel de unidad de negocio.
Ninguno Los datos no pertenecen a otra tabla.
Organización Los datos pertenecen a la organización. El acceso a los datos se controla en el nivel de organización.
Usuario o equipo Los datos pertenecen a un usuario o a un equipo. Las acciones que se pueden realizar en estos registros se pueden controlar en un nivel de usuario.

Al crear nuevas tablas, las únicas opciones de propiedad son: Organización o Usuario o Equipo. No se puede cambiar esta opción después de realizar una elección. Elija Usuario o equipo para obtener el control más pormenorizado sobre quién puede ver o realizar acciones en los registros. Elija Organización cuando este nivel de control no sea necesario.

Tablas de actividades

Una actividad es una tarea que un usuario realiza o planea realizar. Una actividad es cualquier acción para la que puede realizar una entrada en un calendario.

Las actividades se modelan de forma diferente a otros tipos de tablas que almacenan datos empresariales. Los datos sobre las actividades se muestran con frecuencia en una lista, pero cada tipo de actividad requiere propiedades únicas. En lugar de usar una sola tabla activity con todas las propiedades posibles, use tipos independientes de tablas de actividad. Cada una de estas tablas hereda las propiedades de una tabla ActivityPointer base. Estas tablas tienen la IsActivity propiedad establecida en true.

Table Description
Cita Compromiso que representa un intervalo de tiempo con horas de inicio y finalización y duración.
Correo electrónico Actividad que se entrega a través del correo electrónico.
Fax Actividad que mantiene un seguimiento del resultado de llamadas y el número de páginas de un fax y que, opcionalmente, almacena una copia electrónica del documento.
Carta Actividad que realiza un seguimiento de la entrega de una carta. Actividad que puede contener la copia electrónica de la carta.
PhoneCall Actividad para mantener un seguimiento de una llamada de teléfono.
RecurringAppointmentMaster Cita principal de una serie de citas periódicas.
SocialActivity Solo para uso interno.
tarea Actividad genérica que representa el trabajo que se debe realizar.

Cuando un usuario crea uno de estos tipos de registros de tabla de actividad, el sistema crea un registro de tabla correspondiente ActivityPointer con el mismo ActivityId valor de columna de identificador único. No puede crear, actualizar ni eliminar instancias de la ActivityPointer tabla, pero puede recuperarlas. Este diseño le permite presentar todos los tipos de actividades juntas en una lista.

Puede crear tablas de actividad personalizadas que se comporten de la misma manera.

Tabla ActivityParty

Use esta tabla para agregar estructura a las columnas de la tabla PartyListType de actividad que incluyen referencias a otras tablas. Use esta tabla al establecer valores para columnas de tabla de actividad como Email.to o PhoneCall.from. En la tabla ActivityParty, establezca la columna ParticipationTypeMask para definir el rol que desempeña la referencia. Los roles incluyen Sender, ToRecipient, Organizery mucho más.

Se puede consultar la tabla ActivityParty, pero no se puede crear, recuperar, actualizar o eliminar una parte de actividad fuera de la actividad con la que está relacionada. Para obtener más información, consulte:

Tablas secundarias

Las tablas en las que la IsChildEntity propiedad es true nunca tienen ningún privilegio definido y nunca son propiedad de usuario o equipo. Las operaciones que puede realizar en una tabla hija están vinculadas a una tabla con la que están asociadas a través de una relación de muchos a uno. Los usuarios solo pueden realizar operaciones en tablas secundarias si pueden realizar la misma operación en la tabla relacionada. Las tablas secundarias se eliminan automáticamente cuando se elimina el registro de tabla del que dependen.

Por ejemplo, PostComment, PostLike y PostRole son elementos secundarios de la tabla Post.

Keys

Cada definición de clave alternativa describe una o varias columnas en combinación que identifican de forma única una tabla. Normalmente, solo se aplican claves alternativas para la integración con sistemas externos. Defina claves alternativas para identificar de forma única un registro. Esta característica es valiosa si va a integrar datos con un sistema que no admite claves de identificador único GUID. Puede definir un valor de columna único o una combinación de valores de columna para identificar de forma única una tabla. Al agregar una clave alternativa, se aplica una restricción de unicidad en estas columnas. No puede crear ni actualizar otro registro de tabla para tener los mismos valores.

Para obtener más información, consulte:

Estados de tabla

La mayoría de las tablas tienen dos propiedades para realizar un seguimiento del estado de un registro. Estas propiedades son StateCode, que aparecen como Estado en aplicaciones controladas por modelos y StatusCode, que aparece como Motivo de estado en aplicaciones controladas por modelos.

Ambas propiedades contienen un conjunto de opciones que muestran los valores válidos. Los StateCode valores y StatusCode están vinculados para que solo ciertas StatusCode opciones sean válidas para un determinado StateCode.

Este vínculo puede variar según la tabla, pero el patrón común para muchas tablas y el valor predeterminado para las tablas personalizadas es este patrón:

Opciones de StateCode Elecciones de StatusCode
0: Activo 1: Activo
1: Inactivo 2: Inactivo

Algunas tablas tienen diferentes conjuntos de opciones.

Ejemplo: PhoneCall tabla StateCode y StatusCode opciones

StateCode Código de estado
0: Abrir 1: Abrir
1: Completado 2: Hecho
4: Recibido
2: Cancelado 3: Cancelado

No puede personalizar el conjunto de códigos de estado válidos para una tabla, pero puede personalizar los códigos de estado. Puede agregar más StatusCode opciones para un StateCode correspondiente.

En el caso de las tablas personalizadas, puede definir más criterios para las transiciones válidas entre estados.

Para obtener más información, consulte:

Consulte también

Tablas de Dataverse

  • Last updated on