#Capítulo 4: Formularios y detalles — captura, visualización, todo en uno

En el capítulo anterior montamos la lista de tickets y, con un formulario sencillo, registramos datos de prueba. En este capítulo vamos a mejorar la experiencia del formulario: optimizar la disposición de Field del bloque de formulario, añadir el bloque de detalles, configurar reglas de campo y, además, usar el historial de cambios para hacer seguimiento de cada modificación de los tickets.

#4.1 Mejorar el formulario de creación de tickets

En el capítulo anterior creamos rápidamente un formulario de creación funcional. Ahora vamos a perfeccionarlo: ajustar el orden de Field, establecer valores por defecto y optimizar la disposición. Si se saltó la parte del formulario rápido del capítulo anterior, no pasa nada: aquí empezaremos desde cero.

#Añadir el botón de acción «Crear»

1. Asegúrese de estar en modo UI Editor (interruptor de la esquina superior derecha activado).
2. Entre en la página «Lista de tickets» y haga clic en «Acciones (Actions)» sobre el bloque de tabla.
3. Marque el botón de acción «Añadir».
4. Aparecerá un botón «Añadir» sobre la tabla; al pulsarlo se abrirá un popup.

#Configurar el formulario dentro del popup

1. Haga clic en el botón «Añadir» para abrir el popup.

2. En el popup, pulse «Crear Block (Add block) → bloque de datos → Formulario (añadir)».

3. Seleccione «Tabla de datos actual (Current collection)». El popup ya está vinculado al contexto de la tabla correspondiente, no es necesario especificarla manualmente.

   

4. En el formulario, pulse «Field (Fields)» y marque los siguientes Field:

Verá que el Field «Título» tiene un asterisco rojo * automáticamente — porque al crear el Field en el Capítulo 2 ya lo definimos como obligatorio; el formulario hereda automáticamente la regla obligatoria del nivel de tabla, sin necesidad de configurarla aparte.

Sugerencia: si un Field no es obligatorio a nivel de tabla pero quiere que lo sea en el formulario actual, también puede configurarlo individualmente en las opciones del Field.

#Añadir botón de envío

1. Bajo el bloque de formulario, haga clic en «Acciones (Actions)».
2. Marque el botón «Enviar».

3. Tras rellenar el formulario, el usuario hace clic en Enviar para crear un nuevo ticket.

#4.2 Reglas de campo: valores por defecto y comportamiento condicional

Algunos Field queremos rellenarlos automáticamente (p. ej., el estado por defecto «Pendiente»); otros deben cambiar dinámicamente según condiciones (p. ej., los tickets urgentes requieren descripción obligatoria). En 2.0, la función de valores por defecto sigue evolucionando, por lo que en este tutorial usamos uniformemente las reglas de campo para configurar valores por defecto y comportamiento condicional de los Field.

1. Haga clic en la configuración del bloque de formulario (icono de tres líneas) en la esquina superior derecha.
2. Busque «Reglas de campo (Linkage rules)» y, al pulsar, se abrirá el panel de configuración en la barra lateral.

#Establecer valores por defecto

Primero establecemos valores por defecto para «Estado» y «Remitente»:

1. Haga clic en «Añadir regla de campo».
2. No establezca condición (déjela vacía) — las reglas sin condición se ejecutan inmediatamente al cargar el formulario.

3. Configure las acciones (Actions):
   • Field Estado → Establecer valor por defecto → Pendiente
   • Field Remitente → Establecer valor por defecto → Usuario actual

Atención al seleccionar el valor del Field: al establecer el valor, primero seleccione «Formulario actual» como fuente de datos. Si es un Field de objeto relacionado (como Categoría, Remitente, Responsable y otros Field muchos a uno), debe seleccionar el atributo del objeto en sí, no un sub-Field expandido.

Al seleccionar variables (como «Usuario actual»), debe primero hacer un clic para seleccionar la variable y luego doble clic para insertarla en la barra de selección.

Si quiere que el remitente no pueda modificar un Field (como el estado), en la configuración del Field cambie «Modo de visualización (Display mode)» a «Solo lectura (Readonly)».

Tres modos de visualización: Editable, Solo lectura (Readonly, prohíbe editar pero conserva la apariencia del Field) y Modo lectura (Easy-reading, solo muestra texto).

#Tickets urgentes con descripción obligatoria

A continuación añadimos una regla con condición: cuando el usuario seleccione prioridad «Urgente», el Field descripción se vuelve obligatorio, recordando al remitente que detalle bien la situación.

1. Haga clic en «Añadir regla de campo».

2. Configure la regla:
   • Condición (Condition): Formulario actual / Prioridad igual a Urgente
   • Acciones (Actions): Field Descripción → marcar como Obligatorio

3. Guarde la regla.

Probemos: seleccione prioridad «Urgente» y aparecerá un asterisco rojo * junto al Field descripción, indicando que es obligatorio. Si selecciona otra prioridad, vuelve a no ser obligatorio.

Por último, según lo aprendido, ajustemos un poco la disposición.

¿Qué más pueden hacer las reglas de campo? Además de establecer valores por defecto y controlar la obligatoriedad, también pueden controlar la visibilidad/ocultación de Field y asignar valores dinámicamente. Por ejemplo: cuando el estado sea «Cerrado», ocultar el Field Responsable. Lo ampliaremos cuando lo encontremos en capítulos posteriores.

#4.3 Bloque de detalles

En el capítulo anterior añadimos un botón «Ver» a las filas de la tabla; al pulsarlo se abre un cajón. Ahora vamos a configurar el contenido del cajón.

1. En la tabla, haga clic en el botón «Ver» de una fila para abrir el cajón.
2. En el cajón, pulse «Crear bloque (Add block) → bloque de datos → Detalles».
3. Seleccione «Tabla actual (Current collection)».

4. En el bloque de detalles pulse «Field (Fields)», con la disposición:

¿Cómo colocar un título grande? Seleccione Field > markdown > editar markdown > en el área de edición seleccione una variable > Registro actual > Título. Esto inserta dinámicamente el título del registro en el bloque markdown. Borre el texto por defecto y, con sintaxis markdown, conviértalo en estilo de título de segundo nivel (es decir, anteponga ## con un espacio).

El Field de título original de la página puede eliminarse; ajuste un poco el diseño del formulario de detalles.

Sugerencia: varios Field pueden disponerse en una misma fila arrastrándolos, para una disposición más compacta y atractiva.

1. En «Acciones (Actions)» del bloque de detalles, marque el botón «Editar», para entrar al modo de edición directamente desde los detalles.

#Configurar el formulario de edición

Al hacer clic en «Editar» se abre un nuevo popup, en el que hay que colocar un formulario de edición. Los Field del formulario de edición son casi iguales a los del formulario de creación: ¿hay que volver a marcarlos uno a uno?

No. ¿Recuerda el formulario de creación? Lo guardamos primero como plantilla y el formulario de edición lo referenciará directamente.

Paso 1: volver al formulario de creación y guardarlo como plantilla

1. Cierre el popup actual, vuelva a la lista de tickets y haga clic en «Añadir» para abrir el formulario de creación.
2. Haga clic en la configuración del bloque de formulario (icono de tres líneas) en la esquina superior derecha y busque «Guardar como plantilla (Save as template)».

3. Pulse guardar; por defecto es «Referencia (Reference)»: todos los formularios que referencian la plantilla comparten la misma configuración, modificar uno actualiza todos.

Como nuestro formulario de tickets no es complejo, elegir «Referencia» es más cómodo de mantener. Si elige «Copiar», cada formulario obtiene una copia independiente, que se modifican sin afectarse mutuamente.

Paso 2: referenciar la plantilla en el popup de edición

1. Vuelva al cajón de detalles o a la columna de acciones de la tabla y haga clic en «Editar» para abrir el popup de edición.

Quizá piense: ¿no basta con crearlo directamente con «Crear bloque → Otros bloques → Plantilla de bloque»? Pruebe y verá que crea un formulario de creación y los Field no se rellenan automáticamente. Es una trampa habitual.

La forma correcta es:

2. En el popup pulse «Crear bloque (Add block) → bloque de datos → Formulario (Editar)» y cree primero un bloque de formulario de edición de manera normal.
3. En el formulario de edición pulse «Field (Fields) → Plantilla de Field (Field templates)» y seleccione la plantilla guardada anteriormente.
4. Los Field se rellenarán todos de golpe, idénticos al formulario de creación.
5. No olvide añadir el botón de acción «Enviar» para que el usuario pueda guardar tras modificar.

¿Quiere añadir un Field más adelante? Modifique solo la plantilla y los formularios de creación y edición se actualizarán a la vez.

#Edición rápida: modificar datos sin abrir popup

Además de la edición por popup, NocoBase admite edición rápida directamente en la tabla — sin abrir ningún popup, basta con pasar el ratón.

Hay dos formas de activarla:

• A nivel de bloque de tabla: haga clic en la configuración del bloque (icono de tres líneas) y busque «Edición rápida (Quick editing)»; al activarla, todos los Field de la tabla admiten edición rápida.
• A nivel de Field individual: haga clic en la configuración de la columna y busque «Edición rápida»; puede controlar Field a Field si se activa.

Una vez activada, al pasar el ratón sobre la celda aparece un pequeño icono de lápiz; al pulsarlo aparece el componente de edición del Field, y se guarda automáticamente al modificar.

¿En qué escenarios va bien? La edición rápida es ideal cuando hay que modificar masivamente Field como estado o responsable. Por ejemplo, un administrador navegando por la lista de tickets puede pulsar directamente la columna «Estado» para pasar rápidamente un ticket de «Pendiente» a «En proceso», sin tener que abrir uno a uno.

#4.4 Habilitar el historial de registros

Lo más importante de un sistema de tickets es: quién modificó qué y cuándo, debe ser rastreable. El plugin «Historial de registros» de NocoBase registra automáticamente cada cambio de datos.

#Configurar el historial de registros

1. Vaya a Configuración → Gestión de plugins y asegúrese de que el plugin «Historial de registros» (Record History) está habilitado.

2. Entre en la página de configuración del plugin, pulse «Añadir tabla de datos» y seleccione «Tickets».
3. Seleccione los Field a registrar: Título, Estado, Prioridad, Responsable, Descripción, etc.

Sugerencia: no es necesario registrar todos los Field. Field como ID o fecha de creación, que no se modifican manualmente, no merecen seguimiento. Registre solo Field con significado para el negocio.

4. En este momento vuelva a la configuración y pulse «Sincronizar instantánea de datos históricos»; el plugin registrará automáticamente todos los tickets actuales como primer registro histórico, y cada modificación posterior añadirá un nuevo registro histórico.

#Ver el historial en la página de detalles

1. Vuelva al cajón de detalles del ticket (pulse el botón «Ver» de la fila de la tabla).
2. En el cajón pulse «Crear bloque (Add block) → Historial de registros».
3. Seleccione «Tabla actual» y, en datos, «Registro actual».
4. En la parte inferior de los detalles aparecerá una línea de tiempo que muestra claramente cada cambio: quién, cuándo, qué Field cambió de qué valor a qué valor.

Así, aunque el ticket pase por varias manos, todos los cambios quedan claros como el agua.

#Resumen

En este capítulo hemos completado el ciclo de vida completo de los datos:

• Formulario: el usuario puede enviar nuevos tickets, con valores por defecto y validación
• Reglas de campo: los tickets urgentes requieren automáticamente descripción
• Bloque de detalles: muestra de forma clara la información completa del ticket
• Historial de registros: rastrea automáticamente cada cambio, auditoría sin preocupaciones (plugin comercial, opcional)

Desde "verlo" hasta "introducirlo" y "consultarlo": nuestro sistema de tickets ya tiene una usabilidad básica.

#Recursos relacionados

• Bloque de formulario — Configuración detallada del bloque de formulario
• Bloque de detalles — Configuración del bloque de detalles
• Reglas de campo — Descripción de las reglas de campo