Formularios
No toda la información proviene de un sensor o un sistema automatizado. A veces se necesita un toque humano — y ahí es donde entra el widget de Formularios. Piense en él como su portapapeles digital dentro de IronFlock. Úselo siempre que quiera capturar datos manualmente, como:
- Registrar conteos de piezas defectuosas en la línea de producción
- Ingresar lecturas de un sensor de pH tradicional
- Registrar notas de inspección durante un recorrido por la fábrica
Cómo funcionan los formularios
Cuando alguien envía un formulario, los datos se almacenan en una tabla designada en la base de datos de su app. Cada campo del formulario corresponde a una columna en esa tabla, y todos los campos se guardan juntos como una nueva fila cuando se envía el formulario.
Lo que configura en el widget de formulario:
- Un título para el formulario
- Uno o más campos, cada uno con una etiqueta, tipo de entrada y la columna de la tabla donde debe escribirse
- Reglas de validación opcionales y valores predeterminados por campo
- Textos opcionales para los botones (Button Labels), por ejemplo Guardar en lugar de Submit, y una página que se abre después de guardar (Post-Submit Navigation)
Tipos de campo disponibles: desplegable (seleccionar de una lista), texto, número, casilla de verificación y selector de fecha/hora.
Organizar los campos
De forma predeterminada, cada campo ocupa una fila completa, uno debajo del otro. Un formulario largo resulta más fácil de completar cuando los campos relacionados se colocan uno al lado del otro y se agrupan bajo encabezados:
- Width: cada campo puede ocupar una fila completa, tres cuartos, dos tercios, la mitad, un tercio o un cuarto de una fila. Los campos llenan cada fila de izquierda a derecha, y un campo que ya no cabe comienza la fila siguiente. Defina un Default Field Width en Field Layout para dar a todos los campos el mismo ancho y, después, cambie los campos individuales que lo necesiten.
- Start a New Row: el campo comienza una nueva fila, aunque todavía cupiera junto al anterior.
- Secciones: un campo del tipo section añade un encabezado con una indicación opcional debajo. Agrupa los campos que le siguen, hasta la siguiente sección. Su Field Width in Group define el ancho de todos esos campos a la vez, y su Conditional Display muestra u oculta todo el grupo, por ejemplo ajustes que solo se aplican a un tipo de máquina.
- Density: los formularios nuevos empiezan en Compact, con campos más pequeños para boards de escritorio que se usan con ratón. Elija Comfortable para los campos más grandes, adecuados para pantallas táctiles.
El formulario se adapta al espacio disponible. En un widget pequeño o en un teléfono, los campos se ensanchan paso a paso hasta quedar apilados en una sola columna, de modo que todos siguen siendo legibles. Minimum Field Width define cuánto puede estrecharse un campo antes de que eso ocurra.
¿A dónde van los datos?
Cada envío de formulario agrega una nueva fila a la tabla. Esto le da un historial completo de todas las entradas — nada se sobrescribe ni se pierde.
Asegúrese de configurar todos los campos requeridos para que cada nueva fila sea completa y consistente.
Seguimiento del estado más reciente
Si está usando formularios para rastrear el estado actual de máquinas o activos — como el resultado más reciente de inspección por máquina — IronFlock puede mostrarle únicamente la entrada más nueva de cada elemento. El desarrollador de la app habilita esto indicándole a la tabla qué columnas identifican una entidad, por ejemplo el nombre de la máquina.
Cuando esto está configurado, active el interruptor latest en los ajustes de filtro de un widget y el widget mostrará solo la fila actual de cada máquina o activo. IronFlock determina cuál es esa fila cada vez que el widget lee la tabla, y cada nuevo envío sustituye la fila del elemento en el board a medida que llega, de modo que un envío tardío o corregido nunca deja el board mostrando un valor obsoleto. El historial completo de envíos permanece disponible si desea revisarlo.
En una tabla así, un formulario necesita un campo para las columnas que identifican la entidad y, por lo demás, solo para las columnas que edita. Cada envío conserva el valor actual de toda columna que el formulario no escribe. Los campos del formulario se escriben siempre: un campo numérico vaciado borra su columna, un campo de texto vaciado guarda un texto vacío y un campo oculto por una condición de visualización borra su columna. Un campo con valor predeterminado escribe ese valor en lugar de dejar la columna vacía.
Editar un registro desde una tabla
Para que los usuarios puedan abrir un registro existente y modificarlo, combine una tabla con un formulario en la misma página:
- Añada a la tabla una columna del tipo Edit button, vinculada a la columna que identifica el registro, como el nombre de la máquina, y establezca su URL Parameter Key, por ejemplo
edit. Cada fila muestra entonces un icono de lápiz. Un clic escribe la clave de la fila en la URL de la página (?edit=press-1), igual que un widget de filtro establece su parámetro. - Añada un formulario a la misma página, active su Form Open Button y establezca Open on URL parameter con el mismo nombre. En un board el formulario no muestra ningún botón propio: se abre como un diálogo en cuanto la URL contiene el parámetro y se cierra de nuevo cuando el usuario guarda o cancela, lo que quita el parámetro de la URL.
- Vincule el Pre-filled Value de cada campo a la columna del registro, con un filtro sobre la columna identificadora cuyo valor procede del parámetro de filtro
edit, y con el interruptor Latest activado. El campo que escribe la columna identificadora es un Hidden Field con la misma vinculación, de modo que el guardado va al mismo registro. Como en la sección anterior, cada columna que el formulario no escribe conserva su valor.
El diálogo muestra una barra de progreso hasta que llegan los valores del registro. Con el interruptor latest activado, la tabla muestra el cambio guardado en el momento en que se almacena. Una URL guardada como marcador con el parámetro abre el diálogo de inmediato, y el botón atrás del navegador lo cierra.
Un formulario aparte con su propio botón de apertura sigue creando registros nuevos. Fuera de un board, en la vista previa del editor de widgets, el formulario conserva su botón para que pueda probarlo.
Eliminar datos
IronFlock utiliza un enfoque de solo adición también para la eliminación. En lugar de quitar una fila, un formulario envía una nueva entrada que marca el registro como eliminado en la columna deleted de la tabla, una columna booleana que el desarrollador de la app añade a la tabla. No hay un botón de eliminar especial para ello: un formulario de eliminación es un formulario cuyo botón de envío dice Eliminar.
Para que los usuarios eliminen un registro desde una tabla, con una confirmación:
- Añada a la tabla una segunda columna del tipo Edit button, vinculada a la columna que identifica el registro, con el URL Parameter Key
deletey el Icondelete. - Añada un formulario a la misma página, active su Form Open Button, establezca Open on URL parameter en
deletey dele un título como «¿Eliminar este registro?». En Button Labels, establezca el Submit Label enEliminary el Cancel Label enConservar, y elija un Highlight Color rojo. - Dé al formulario exactamente dos campos, ambos con Hidden Field activado: uno que escribe la columna identificadora, con su Pre-filled Value vinculado como en el formulario de edición anterior pero filtrado por el parámetro
delete, y una casilla de verificación que escribe la columnadeleted, con su Default Value activado.
Un clic en el icono de eliminar de una fila abre el diálogo, y Eliminar guarda la clave del registro con deleted en true. Para eliminar en cambio un registro en su propia página de detalle, coloque allí el mismo formulario y establezca su Post-Submit Navigation en la página de lista, por ejemplo /machines.
Los widgets que listan los registros combinan el interruptor latest con un filtro sobre la columna deleted (deleted está vacío o es false). Un registro eliminado desaparece del board en cuanto llega la entrada y permanece en la base de datos para el historial y la auditoría. No se necesita ninguna vista ni transformación para ello; consulte Eliminación lógica de registros. Para que un formulario de edición restaure un registro eliminado, añádale una casilla oculta sobre la columna deleted cuyo Default Value esté desactivado.
Los formularios creados con una versión del widget de formulario anterior a la 2.0 tienen los ajustes Show Delete Button y Delete-Flag Column. La versión 2.0 ya no los tiene: cuando pase un formulario así a la versión 2.0 o posterior, reconstruya su eliminación como se describe aquí.
Resumen
Con el widget de Formularios obtiene:
- Entrada de datos manual fácil directamente desde el board
- Seguimiento automático del historial para cada envío
- Patrones claros para mostrar el estado actual y ocultar registros eliminados
- Edición de registros existentes desde una tabla, en un diálogo en la misma página
Todo sin salir de su board de IronFlock.