Selector de tablas de datos

Introducción

En NocoBase, el selector de tablas de datos (Collection select) se utiliza para seleccionar una o varias tablas de datos.

El selector de tablas de datos es adecuado para escenarios como la configuración de plugins, la configuración de reglas y la gestión de metadatos. Guarda el identificador de la tabla de datos, no los registros de negocio.

Si quieres seleccionar registros de una tabla concreta, debes utilizar un campo de relación en lugar de un selector de tablas de datos.

Casos de uso

El selector de tablas de datos es adecuado para estos escenarios empresariales:

  • Seleccionar la tabla de datos de destino en la configuración de plugins
  • Especificar el alcance de las tablas de datos en la configuración de reglas
  • Gestión de metadatos y configuración de plantillas
  • Configuración de funciones que necesitan hacer referencia al identificador de una Collection

Crear la configuración

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

20240512174047

ConfiguraciónDescripción
Field interfaceTipo de interfaz del campo. El selector de tablas de datos corresponde a collectionSelect, que determina cómo se introducen y muestran los datos en la página.
Field display nameNombre que se muestra para el campo en la interfaz, por ejemplo, «Tabla de datos de destino», «Tabla de datos objetivo» o «Ámbito de datos». Se recomienda utilizar un nombre que el personal de negocio pueda entender directamente.
Field nameNombre identificador del campo, utilizado para referencias internas en la API, los campos de relación, los permisos, los flujos de trabajo, etc. Por lo general, 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 selector de tablas de datos normalmente guarda el identificador de la tabla de datos; el tipo de almacenamiento depende de la configuración real.
Default valueValor predeterminado. Al crear un registro, si el usuario no introduce ningún valor, se puede completar automáticamente con el valor predeterminado.
Validation rulesReglas de validación. Normalmente se configura si el campo es obligatorio o el rango de selección permitido.
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 del mantenimiento.
Nota

El nombre del campo será utilizado por bloques de página, permisos, flujos de trabajo y API después de su creación. Confirma el nombre antes de crearlo para evitar costes de ajuste de la configuración posteriormente.

Características del campo

El comportamiento predeterminado de los campos selectores de tablas de datos es el siguiente:

CaracterísticaDescripción
Field interface predeterminadocollectionSelect.
Field type predeterminadostring.
Field type disponiblestring, json, según la configuración real.
Componente de páginaEn el modo de edición se utiliza el componente de selección de tablas de datos.
FiltradoNormalmente no se utiliza como campo de filtrado de negocio.
OrdenaciónNormalmente no se utiliza para ordenar.
ValidaciónAdmite validaciones básicas, como la obligatoriedad.

Editar la 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 del campo se utiliza principalmente para ajustar cómo se muestra y se utiliza 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 de la base de datos principal que ya se ha sincronizado, la edición normalmente consiste en realizar una asignación 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 nameModifica 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 interfaceCon condicionesLos campos de la base de datos principal o los campos sincronizados se pueden ajustar durante la asignación de campos. El cambio afectará a la forma de introducir, mostrar y validar los datos en la página.
Field typeCon condicionesLos campos de la base de datos principal o los campos sincronizados se pueden ajustar durante la asignación de campos. Antes de realizar el cambio, debes confirmar que los datos existentes se puedan utilizar con el nuevo tipo.
Default valueAjusta el valor predeterminado al crear nuevos registros.
Validation rulesAjusta las reglas de validación del campo.
DescriptionAñade el significado del campo, los requisitos de cumplimentación, el origen de los datos o la persona responsable del mantenimiento.
Nota

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

Eliminar el campo

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

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

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

El selector de tablas de datos es adecuado para utilizarse en formularios de configuración.

EscenarioUso
Bloque de formularioSeleccionar una o varias tablas de datos.
Bloque de detallesMostrar las tablas de datos seleccionadas.
Configuración de pluginsEspecificar el alcance de las tablas de datos sobre las que actúa la función.
Flujo de trabajo o reglaParticipar en la lógica como configuración de metadatos.

Enlaces relacionados

  • Campos — Conoce la función, clasificación y lógica de asignación de los campos
  • Tabla normal — Crea y administra campos en una tabla normal
  • Tabla normal — Conoce cómo se utiliza una Collection
  • Campo de relación — Selecciona registros de una tabla concreta