Identificador de tabla de datos

Introducción

En NocoBase, el identificador de tabla de datos (Table OID) se utiliza para identificar la tabla de datos a la que pertenece un registro.

El identificador de tabla de datos es común en tablas heredadas o en escenarios donde es necesario distinguir la Collection de origen de un registro. Se trata principalmente de un campo utilizado por las capacidades del sistema y los metadatos.

Por lo general, las tablas de negocio comunes no necesitan crear manualmente un campo de identificador de tabla de datos.

Casos de uso

El identificador de tabla de datos es adecuado para los siguientes escenarios empresariales:

  • Identificación del origen de los registros de tablas heredadas
  • Agregación y visualización entre tablas secundarias
  • Configuración de metadatos
  • Capacidades del sistema que necesitan distinguir el origen de una Collection

Crear configuración

En la página «Configure fields» de la tabla de datos, haz clic en «Add field» y selecciona «Identificador de tabla de datos» para crear un campo de identificador de tabla de datos.

20240512174746

ConfiguraciónDescripción
Field interfaceTipo de interfaz del campo. El identificador de tabla de datos corresponde a tableoid, que determina cómo se introduce y se muestra en la página.
Field display nameNombre que se muestra para el campo en la interfaz, por ejemplo, «Identificador de tabla de datos» o «Tabla de origen». Se recomienda utilizar un nombre que el personal de negocio pueda entender directamente.
Field nameNombre identificador del campo, utilizado para referencias internas en API, campos de relación, permisos, flujos de trabajo, etc. Normalmente no se modifica después de su creación; solo admite letras, números y guiones bajos, y debe comenzar por una letra.
Field typeTipo del campo en la capa de datos. El identificador de tabla de datos suele ser un campo virtual.
Default valueValor predeterminado. Al crear un registro, si el usuario no lo introduce, se puede completar automáticamente con este valor.
Validation rulesNormalmente lo mantiene el sistema.
DescriptionDescripción del campo. Es adecuado incluir el significado del campo, los requisitos de cumplimentación, el origen de los datos o la persona responsable de su mantenimiento.
Atención

El nombre del campo será utilizado por los bloques de página, los permisos, los flujos de trabajo y las API. Confirma el nombre antes de crearlo para evitar el coste de ajustar la configuración posteriormente.

Características del campo

El comportamiento predeterminado de los campos de identificador de tabla de datos es el siguiente:

CaracterísticaDescripción
Field interface predeterminadatableoid.
Field type predeterminadovirtual.
Field type opcionalvirtual.
Componente de páginaNormalmente se muestra en la página mediante un selector de tabla de datos o como contenido de solo lectura.
FiltradoSe puede utilizar para filtrar por tabla de datos de origen, según la configuración de la página.
OrdenaciónNormalmente no se utiliza para ordenar.
ValidaciónLa mantienen el sistema o las capacidades de metadatos.

Editar configuración

Después de crear el campo, haz clic en «Edit» a la derecha del campo para editar su configuración. La edición se utiliza principalmente para ajustar cómo se muestra y se utiliza el campo en NocoBase, por ejemplo, para modificar el nombre mostrado, la descripción, el valor predeterminado, las reglas de validación o la configuración específica del campo.

Si el campo procede de una tabla ya sincronizada en la base de datos principal, normalmente la edición consiste en realizar un mapeo de campos: asignar el campo de la base de datos a un Field type y un Field interface de NocoBase.

ConfiguraciónSe puede editarDescripción
Field display nameSíModifica el nombre que se muestra para el campo en la interfaz, sin cambiar el nombre identificador del campo.
Field nameNoPor lo general, el nombre identificador del campo no se puede modificar en el formulario de edición después de su creación.
Field interfaceSegún las condicionesLos campos de la base de datos principal o los campos sincronizados se pueden ajustar durante el mapeo de campos. El cambio afectará a la forma de introducir, mostrar y validar los datos en la página.
Field typeSegún las condicionesLos campos de la base de datos principal o los campos sincronizados se pueden ajustar durante el mapeo de campos. Antes de hacerlo, es necesario confirmar que los datos existentes se puedan utilizar con el nuevo tipo.
Default valueSíAjusta el valor predeterminado al crear nuevos registros.
Validation rulesSíAjusta las reglas de validación del campo.
DescriptionSíAñade el significado del campo, los requisitos de cumplimentación, el origen de los datos o la persona responsable de su mantenimiento.
Atención

Cambiar el Field type o el Field interface no equivale a modificar simplemente un nombre mostrado. Esto afecta a la forma de almacenamiento del campo, el componente de entrada, las reglas de validación, las condiciones de filtrado y la forma de utilizar las variables en los flujos de trabajo. Cuando ya existen muchos datos, confirma primero que su formato sea compatible.

Eliminar el campo

Haz clic en «Delete» a la derecha del campo para eliminar el campo de identificador de tabla de datos. En la base de datos principal también puedes seleccionar varios campos y eliminarlos por lotes.

Al eliminar un campo de identificador de tabla de datos creado en la base de datos principal, normalmente también se eliminan la columna real correspondiente en la base de datos y los datos existentes en ella. Al eliminar un campo sincronizado desde la base de datos o mapeado desde una fuente de datos externa, el alcance del impacto depende de la fuente de datos y del origen del campo correspondiente.

Advertencia

Eliminar un campo puede afectar a los bloques de página, formularios, filtros, permisos, flujos de trabajo, API, importaciones y exportaciones, así como a los datos existentes. Antes de eliminarlo, confirma si el campo sigue siendo utilizado por alguna configuración de negocio.

Uso en la configuración de páginas

Los campos de identificador de tabla de datos son adecuados para utilizarse en tablas heredadas y escenarios de metadatos.

EscenarioUso
Bloque de tablaMuestra la tabla de datos de origen del registro.
Bloque de filtradoFiltra por tabla de datos de origen.
Permisos y flujos de trabajoSe utiliza como condición para determinar la tabla de origen.
Capacidades de metadatosIdentifica la Collection a la que pertenece el registro.

Enlaces relacionados