Secuencia

Introducción

En NocoBase, Secuencia (Sequence) se utiliza para generar números de negocio.

El campo de secuencia es adecuado para números de pedido, contrato, orden de trabajo, solicitud y otros identificadores que requieren reglas legibles. A diferencia de la clave primaria, está más orientado a la presentación empresarial y a la identificación manual.

Si solo necesitas un identificador único interno, utiliza Snowflake ID, UUID o Nano ID.

Casos de uso

La secuencia es adecuada para estos escenarios empresariales:

  • Números de pedido y contrato
  • Números de orden de trabajo y solicitud
  • Identificadores de activos y equipos
  • Números con prefijos, fechas o reglas incrementales

Crear configuración

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

20240512173752

ConfiguraciónDescripción
Field interfaceTipo de interfaz del campo. La secuencia corresponde a sequence y determina cómo se introduce y se muestra en la página.
Field display nameNombre que se muestra para el campo en la interfaz, como «Número de pedido», «Número de contrato» o «Número de orden de trabajo». Se recomienda utilizar un nombre que el personal empresarial 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. 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 tipo de almacenamiento de un campo de secuencia depende de la regla de secuencia y normalmente es string.
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 rulesNormalmente se generan según las reglas del sistema y no requieren validación manual.
DescriptionDescripción del campo. Es adecuada para indicar el significado del campo, los requisitos de introducción, el origen de los datos o la persona responsable del mantenimiento.
Atención

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

Características del campo

El comportamiento predeterminado de los campos de secuencia es el siguiente:

CaracterísticaDescripción
Field interface predeterminadasequence.
Field type predeterminadostring.
Field type opcionalstring, integer, según la configuración de secuencia real.
Componente de páginaNormalmente se genera automáticamente y se utiliza después de configurar la regla de numeración.
FiltradoAdmite búsquedas exactas por número o filtrado de texto.
OrdenaciónLa idoneidad para ordenar depende de la regla de numeración.
ValidaciónDepende de la regla de secuencia y normalmente mantiene la unicidad.

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 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 ya sincronizada de la base de datos principal, 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 mostrado del campo en la interfaz, sin cambiar el nombre identificador del campo.
Field nameNoNormalmente, el nombre identificador del campo no se puede modificar en el formulario de edición después de su creación.
Field interfaceCondicionalmenteLos campos de la base de datos principal o los campos sincronizados se pueden ajustar durante la asignación de campos. El ajuste afecta a la forma de introducir, mostrar y validar los datos en la página.
Field typeCondicionalmenteLos campos de la base de datos principal o los campos sincronizados se pueden ajustar durante la asignación de campos. Antes de realizar el ajuste, 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 introducción, el origen de los datos o la persona responsable del mantenimiento.
Atención

Cambiar el Field type o el Field interface no equivale simplemente a modificar 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 haya muchos datos existentes, confirma primero que el formato de los datos sea compatible.

Eliminar campo

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

Al eliminar un campo de secuencia creado en la base de datos principal, normalmente también se eliminan la columna real correspondiente de la base de datos y los datos existentes en ella. Al eliminar un campo sincronizado desde una 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 que el campo ya no sea utilizado por ninguna configuración empresarial.

Uso en la configuración de páginas

Los campos de secuencia son adecuados para escenarios de números de negocio y búsquedas manuales. 20260710151731

EscenarioUso
Crear registrosGenerar automáticamente números de negocio.
Bloques de tablaMostrar, buscar y filtrar números.
Bloques de detallesUtilizarlo como identificador legible del registro.
Flujos de trabajo y notificacionesReferenciar el número de negocio en aprobaciones y notificaciones.

Enlaces relacionados