Definiciones de tabla en Microsoft Dataverse

Las definiciones de tabla de Microsoft Dataverse describen la estructura y el comportamiento de cada tabla que almacena datos estructurados. En este artículo se explica cómo trabajar con definiciones de tabla mediante programación, incluidos los nombres de tabla, las claves, la propiedad y los estados. Para los desarrolladores, las tablas corresponden a las clases que se usan al trabajar con datos en Microsoft Dataverse.

La clase EntityMetadata del SDK para .NET y el tipo de entidad EntityMetadata de la API web contienen las propiedades que definen las tablas.

Nombres de tabla

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

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

Use estos valores localizables para hacer referencia a las tablas de una aplicación. Puede cambiar estos valores cuando lo desee. 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 vínculos que abren el registro en una interfaz de usuario.

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

Imágenes de tabla

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.

Para más información, consulte:

• Trabajar con definiciones de columna de imagen mediante código
• Utilizar datos de la columna de imagen
• Ejemplo: Operaciones de imagen usando la SDK de Dataverse para .NET
• Ejemplo: Operaciones de imagen usando la API web de Dataverse

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 algo más de explicación son: propiedad de las tablas, tablas de actividad, tabla ActivityParty y tablas hijas.

Propiedad de la tabla

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

Al crear nuevas tablas, las únicas opciones de propiedad son: OrganizationOwned, UserOwnedo Filtered (versión preliminar). No se puede cambiar esta opción después de realizar una elección.

Elija UserOwned cuando los registros necesitan la propiedad de usuario o equipo, la asignación y el uso compartido. Elija OrganizationOwned cuando el acceso de nivel de organización sea suficiente. Elija Filtered (versión preliminar) cuando necesite acceso de nivel de fila en función de los valores de columna, con permisos concedidos a través de filtros de rol de seguridad. Los registros de tablas Filtered no tienen propietario y no se pueden asignar ni compartir.

También puede aplicar filtros de registro a las tablas UserOwned y OrganizationOwned para controlar el acceso de nivel de fila en función de los valores de columna sin cambiar su OwnershipType. Estas tablas conservan su modelo de propiedad existente.

Más información sobre la propiedad de los registros filtrados:

• Propiedad de los registros filtrados (versión preliminar)
• Titularidad filtrada de registros mediante código (versión preliminar)

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 ( tipo de entidad activitypointer de API web). Estas tablas tienen la IsActivity propiedad establecida en true.

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 la tabla ActivityParty (tipo de entidad activityparty de API web) 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. Configure la columna participationtypemask para definir el papel 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.

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 se pueden realizar en una tabla secundaria están enlazadas a una tabla a la que están asociadas a través de una relación de varios 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, Comment (PostComment) y Like (PostLike) son elementos secundarios de la tabla Post .

Claves alternativas

Cada definición de clave alternativa describe una o varias columnas en combinación que identifican de forma única un registro. Normalmente, solo se aplican claves alternativas para la integración con sistemas externos. 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 la misma tabla para que tenga los mismos valores.

Para más información, consulte:

• Definición de claves alternativas para hacer referencia a filas
• Claves alternativas

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:

Algunas tablas tienen diferentes conjuntos de opciones.

Ejemplo: PhoneCall tabla StateCode y StatusCode opciones

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 más información, consulte:

• Definiciones de columna
• Defina transiciones del modelo de estado personalizado.

Consulte también

Tablas de Dataverse