Diseñando la ficha

Diseñando la ficha es el diseñador del formulario de una sección: cada campo se dibuja como el control que va a salir en la ficha, con sus medidas reales y sin datos, y lo colocas arrastrando. Lo que se mueve aquí es la misma geometría que usa la ficha real: pestaña, posición, ancho, alto y la etiqueta a la izquierda.

No tiene entrada en el menú. Se abre desde la sección, con Diseñar en su tarjeta de Secciones. También desde la ficha de un campo, con Abrir el Diseñador en su pestaña En la ficha. Su dirección es /App/FlexHub/Secciones/{id}, así que se puede enlazar, y la flecha de volver atrás del navegador vuelve a la lista.

Antes de empezar

• Ser Administrador de la empresa. Ver FlexHub.
• Una sección principal o una tabla de líneas. Las plantillas base no se diseñan y su tarjeta no lleva Diseñar: lo que se dibuja en pantalla es siempre la sección derivada. Sin sección válida, la pantalla se titula Diseñador de fichas y dice lo que pasa. Son tres casos: Falta la sección que vas a diseñar, Esta sección no se diseña (ya no existe, es una plantilla base o está de baja) y No se ha podido leer la sección. El botón Ir a Secciones vuelve a la lista.
• Un servidor que publique la maqueta de los campos. Si no la publica, la tira de estado lo avisa en rojo y el lienzo no coloca ningún campo.
• Saber qué se guarda y cuándo. Mover, estirar, renombrar, las casillas del menú y las pestañas quedan en memoria hasta que pulsas Guardar. Crear un campo, duplicarlo, darlo de baja, su ficha y los scripts escriben en el servidor al momento.

La pantalla

Encima de la tarjeta, la ruta de navegación: el botón Secciones (vuelve a la lista), el icono de la sección y su nombre. El icono se cambia pulsándolo solo si la sección es tuya: la hizo tu empresa o viene del módulo que desarrolla tu licencia. El de una sección de otro módulo no se cambia, porque lo ven todos los que tienen ese módulo. La ventana del icono está en Secciones.

Debajo, una sola tarjeta, Diseñando la ficha, con el subtítulo N campos · N pestañas (o Leyendo la sección…). Dentro, en este orden: la barra, la tira de estado, las tarjetas de bloqueos y de resultado cuando corresponde, el formulario en su propia tarjeta y, a la derecha, los paneles que se abren y se cierran.

La barra

Solo Nuevo campo, Contenedor, Pestañas y Guardar llevan texto. El resto son iconos: su nombre y lo que hacen salen al pasar el ratón.

Los tres interruptores de vista se muestran pulsados cuando lo están. Tu navegador conserva qué paneles dejaste abiertos.

Ordenar con IA avisa de lo que hace:

• Campos ordenados: N campos movidos de M. Están en pantalla y sin guardar: si no te convence, pulsa Deshacer.
• Sin cambios: la IA ha dejado los campos como estaban.
• N campos se quedan donde están, cada uno con su motivo: sin maqueta, fijado por su módulo, oculto, un marco o dentro de un marco. Los dados de baja no cuentan. Si no queda ninguno que recolocar, el aviso es No hay nada que ordenar.
• La IA se ha dejado N campos: se quedan donde estaban.
• La IA no ha devuelto ningún orden, y El orden no se ha aplicado si la sección se volvió a leer antes de que la IA respondiera. Pulsado antes de que acabe de leer la sección: Todavía está leyendo.

Gasta cuota de IA.

La tira de estado

Debajo de la barra, una línea con la leyenda de la sección y, cuando pasan, sus avisos.

La leyenda son números y no frases: N campos · N nuevos · N modificados. Cuenta como campos todos los de la sección, los nuevos incluidos; los dados de baja no. Los nuevos son los que has creado aquí: la ficha no los muestra hasta que guardes. Los modificados son los que has movido o cambiado sin guardar. Nuevos y modificados solo salen cuando hay alguno, y el porqué de cada número sale al pasar el ratón. No hay nada que pulsar: lo que hay que pulsar es Guardar, que consolida solo cuando hace falta.

Al abrir una sección puede haber ya campos modificados. El diseñador coloca los que no tienen medidas, ajusta el alto de los controles que no se estiran y separa de la pared de su marco los que están pegados. Todo eso se escribe con Guardar, y Descartar no lo deshace. Con la sección de solo lectura no cambia nada.

Después de la leyenda, los avisos:

Consolidar la estructura no se pide desde la tira: lo hacen Guardar y Recargar por su cuenta cuando hay campos nuevos. El único botón que queda es Consolidar ahora, en el resultado de un guardado que el servidor haya marcado (ver Guardar). Ese botón pregunta antes: Reconstruye la estructura de toda la empresa y tarda unos diez segundos. Mientras dura, nadie puede cambiarla., con Consolidar ahora o Ahora no. Al terminar: Estructura consolidada: los cambios ya surten efecto.

El lienzo

El formulario mide 1018 px de ancho y no se estira: lo que quede más allá no se ve en la ficha. Encima lleva una regla graduada: una raya cada 10 px, una marca cada 50 y el número cada 100. Marca las cuatro bandas de columna y termina en 1018 px. El fondo es la cuadrícula de 10 px, y los campos se pegan a esa rejilla. Al arrastrar, el imán los pega también a los bordes y al centro de sus vecinos y a las columnas, con guías de alineación. Con Shift, ni rejilla ni imán. Al mover o estirar un campo, no se queda a menos de 20 px del borde izquierdo, del superior ni del derecho del formulario, tampoco con Shift.

Un marco (un contenedor) se mueve arrastrando su borde, y se lleva los campos que tiene dentro. Un campo queda dentro de un marco cuando su centro está dentro y cabe con su margen. Ahí se queda a 20 px de los cuatro bordes, sin cruzar ninguno. Para meterlo o sacarlo, arrástralo: con las flechas, el borde de un marco no se cruza. Un marco no se estrecha por debajo de lo que lleva dentro más esos 20 px.

Las pestañas del formulario son las mismas que va a ver el usuario, y solo salen si hay más de una. Cada campo es una caja con el control dibujado. Se distinguen la casilla de texto, la casilla de sí/no con su etiqueta a la derecha y el desplegable con su flecha. La relación lleva su flecha y sus dos botones; la fecha, su calendario; la fecha y hora y la hora, su reloj. También el número con una cifra de muestra, el editor de texto con su barra, el área de varias líneas y el archivo con su botón Subir archivo. Y el botón, y la lista de líneas de un documento, dibujada como una tabla. Un contenedor con nombre lo lleva en una banda que la ficha no muestra; los que crea Contenedor no llevan banda.

La barra del editor sale corta hasta 650 px de ancho y 400 de alto, y entera en cuanto pasa de una de las dos medidas. El alto de una casilla, una fecha o un desplegable es el que ese control necesita y no se cambia; solo se estiran los textos largos, los editores, los archivos, los botones y los marcos. En modo diseño, el alto que sobra se raya: el control se dibuja pegado al borde superior y el resto es hueco.

Sobre las cajas:

El texto de cada caja al pasar el ratón dice la etiqueta, el nombre de columna, el tipo, las medidas y la posición.

Estado vacío: Esta sección todavía no tiene campos (Crea el primero y aparecerá aquí, en el formulario.) con el botón Nuevo campo, o Esta pestaña no tiene campos colocados (Los campos de la sección están en otras pestañas. Crea uno nuevo aquí, o trae uno con el botón derecho sobre su caja: «Llevar a la pestaña».).

Gestos y teclas

La tira de debajo del formulario, solo en modo diseño, los resume:

Los atajos de teclado funcionan con el lienzo activo: pulsar un campo, o elegirlo desde el panel Campos, se lo da.

El menú de un campo

Se abre con el botón derecho sobre la caja o con los tres puntos del indicador de medidas. Entra lo que se decide viendo el formulario; lo que depende del negocio (qué valida, con qué se relaciona) está en la ficha del campo.

Todo lo de los tres primeros grupos se apunta en memoria y viaja con Guardar. Abrir la ficha y dar de baja releen la sección al terminar, así que antes el diseñador guarda solo lo pendiente. Si ese guardado no entra, pregunta si sigues perdiéndolo, con Seguir y perderlo o Volver y arreglarlo. Duplicar no relee nada: lo pendiente se queda como estaba.

Dar de baja y dar de alta

Dar de baja «…» pregunta antes y dice a qué afecta: el campo deja de recibir datos y desaparece de la ficha, de los roles y de los informes. La columna y sus datos no se borran, así que se puede volver a dar de alta desde el panel Campos. Si afecta a otros objetos, los lista. Botones Dar de baja y Dejarlo como está. Un campo de un módulo publicado no se elimina: el servidor lo marca obsoleto, y para eliminarlo del todo hay que despublicarlo desde su módulo. Después, la notificación Campo dado de baja · pulsa aquí para deshacerlo deja volver atrás.

Dar de alta «…» devuelve el campo a activo y avisa: dar de alta no deshace lo que quitó la baja. Lo que salió de roles, informes o secciones se vuelve a poner a mano. Notificación Campo dado de alta.

Nuevos campos

La ventana Nuevos campos se abre con Nuevo campo (en la barra, en el lienzo vacío o en el panel Campos vacío) y con Nuevos campos aquí… del botón derecho. El subtítulo dice dónde se van a colocar y cuántos se van a crear: En «Sección», pestaña «General», uno debajo de otro. 2 campos por crear. Es una lista dentro de una tarjeta, con las columnas Nombre y Tipo:

• Cada fila tiene un número, la casilla Escribe el nombre…, la caja del tipo y un aspa para quitar la fila. La caja del tipo se pulsa y abre ¿Qué tipo de campo?, con el aviso El formato y su máscara no se pueden cambiar después de crear el campo. La lista arranca con una fila, el foco en el nombre y el último tipo que creaste.
• No tiene atajos de teclado. Campo añade otra fila, con el tipo de la anterior, y Aceptar crea los campos. El nombre se cambia luego con F2 sobre el campo, ya en el lienzo.
• Dos campos no se pueden llamar igual, sin distinguir mayúsculas. Un nombre repetido marca su fila en rojo con Este nombre ya está en otra fila. Cámbialo. o Ya existe un campo con este nombre. Cámbialo. Los campos dados de baja también cuentan.
• Un tipo Relación añade en la misma fila A qué sección apunta (abre ¿A qué sección apunta?). Sin destino, la fila se marca en rojo: Elige la sección de destino para crear esta relación.
• Sugerir 3 con IA lee la sección (su nombre, sus campos y lo que ya hay en la lista) y propone tres campos que faltan, con su tipo. Entran como filas normales, y el motivo de cada uno sale al pasar el ratón por el nombre. Mientras tanto, el botón dice Proponiendo…. Si no propone nada: La IA no ha propuesto nada. Vuelve a pulsar. Si todo estaba ya: Todo lo que ha propuesto ya estaba en la lista. Gasta cuota de IA.
• Aceptar va siempre encendido, y las filas sin nombre no cuentan. Si falta algo, avisa al pulsar: Falta el nombre, Hay un nombre repetido o Falta la sección de destino.
• Cerrar, el aspa y Esc descartan la lista. Si hay nombres escritos, preguntan antes en Cerrar sin crear: Cerrar y perder los cambios o Seguir editando.

Los campos se crean uno detrás de otro en el servidor, sin consolidar por campo. Mientras tanto hay una caja provisional Creando… en su sitio, y el botón Nuevo campo cuenta Creando 2 de 5…. Se colocan en columna en la pestaña abierta y quedan como nuevos sin consolidar hasta Guardar. Al terminar, Campo creado o Campos creados, con dónde se han colocado. Una relación sin destino se salta (Campo saltado). Si uno falla, No se ha creado el campo da el motivo, los de antes ya existen y Tanda a medias dice cuál no ha entrado. Con la sección en solo lectura, Solo lectura: no se crea nada.

Los tipos preparados

La ventana ¿Qué tipo de campo? muestra 22 tipos en cuatro grupos, cada uno con el icono de su formato, su nombre y para qué sirve. El tipo que ya tiene la fila sale marcado y con el foco: Enter lo repite. Tab recorre las tarjetas, Esc cierra y Cerrar sale sin cambiar nada. Un tipo preparado es un formato más un rol: el rol pone la máscara y decide cómo trata la ficha el dato. Ver Roles de campo.

Un campo de archivo o de imagen no se crea desde aquí. Duplicar uno existente no siempre se puede: cuando no, el aviso es No se duplica, con el motivo.

Editar pestañas

La ventana Editar pestañas (botón Pestañas de la barra) cambia el nombre o el orden de todas a la vez. Su tarjeta, Nombre y orden, avisa: Lo que cambies aquí llega a todos los campos de esa pestaña. Los cambios se ven al momento en el diseñador y se escriben con Guardar.

Cada fila lleva su número, el nombre en una casilla y cuántos campos tiene. Si su módulo fija alguno, sale la etiqueta N de su módulo: esos campos se quedan en la pestaña de antes. Las flechas Subir y Bajar salen siempre, apagadas donde no hay adónde ir.

Cuatro pestañas son fijas: su casilla sale apagada, con la etiqueta Fija y el motivo al pasar el ratón. General va siempre primera, Detalles justo detrás, Obsoleto al final delante de Registro, y Registro la última. Ni se renombran ni se mueven.

Al pulsar Aceptar, toda pestaña necesita un nombre (Falta el nombre). Tampoco puede haber dos que se llamen igual sin distinguir mayúsculas (Nombre repetido): Hay dos pestañas que se llamarían «…». Ponles nombres distintos, o mueve los campos de una a la otra desde el diseñador. Cerrar no cambia nada.

Una pestaña existe mientras algún campo pertenece a ella: se crea desde un campo (Nueva pestaña…) y se borra vaciándola.

El panel Campos

Todos los campos de la sección, no solo los que se ven en el lienzo, agrupados por pestaña (General primero) y con los dados de baja al final, en Retirados. Cada grupo dice cuántos tiene. El subtítulo cuenta N campos · N pestañas, y con un filtro puesto, N de M campos · N pestañas. Pulsar una fila elige el campo, salta a su pestaña y deja el lienzo preparado para las flechas. El aspa cierra el panel; se vuelve a abrir con Campos en la barra.

En la cabecera del panel, el buscador Buscar por etiqueta o por nombre de columna… y el embudo con Todos, Esta pestaña, Ocultos y De baja (solo si hay alguno), cada uno con su cuenta. Con un filtro puesto, el botón lo dice: Ocultos · 3.

Cada fila lleva el icono de su formato, la etiqueta y, a la derecha, las marcas y los mandos. El icono es el mismo que en ¿Qué tipo de campo?; un marco lleva el suyo. Al pasar el ratón, la fila dice además su nombre de columna. La de un campo oculto sale apagada. Una raya separa lo que se apunta en memoria (y Deshacer devuelve) de lo que escribe en el servidor al momento:

El ojo, el asterisco y la papelera solo salen en los campos que se pueden cambiar. El ojo y el asterisco piden también que el servidor haya dado la maqueta del campo. Marcas: candado (con el motivo), aviso Sin leer: el servidor no ha dado la maqueta de este campo. y un punto en los campos Cambiado y sin guardar.

Dos vacíos. Esta sección todavía no tiene campos (Una ficha se maqueta con sus campos: crea el primero y aparecerá en el formulario.) trae el botón Nuevo campo. Ningún campo encaja (La sección tiene N campos, pero ninguno pasa este filtro ni la búsqueda.) trae Ver todos.

El panel Scripts

Los scripts de la sección: lo que calcula, valida o rellena campos al guardar la ficha o al cambiar un valor. El subtítulo cuenta N scripts. Nuevo abre la ventana de un script en blanco; pulsar una fila abre el suyo, con el código y sus propiedades. Un script propio no lleva etiqueta; uno de módulo lleva la de su módulo, y los obsoletos, Obsoleto. Vacío: Esta sección no tiene scripts (Un script calcula, valida o rellena campos de la ficha al guardar o al cambiar un valor.) con Nuevo script.

Esa ventana escribe en el servidor al momento: un script no forma parte de la maqueta, así que queda fuera de Deshacer y de Guardar. La ventana del script se explica en Scripts de FlexHub; qué es un script y qué lo dispara, en Scripts de Desarrollo.

Guardar

Guardar (o Ctrl+S) manda de una vez la geometría de todos los campos movidos. Las casillas cambiadas y los nombres nuevos van después, en su propio apunte por campo.

El diseñador revisa campo a campo lo que el servidor rechazaría. Si alguno frenaría el lote, Guardar no manda nada. Lo dice la tarjeta No se puede guardar todavía: No se manda nada: el servidor los rechazaría con este mismo motivo, y se guarda todo o nada. Sale una fila por campo con su motivo, y pulsar la fila elige el campo y salta a su pestaña. La tarjeta se rehace con cada cambio: al arreglar un campo, su fila se va.

Después ensaya con el servidor y solo escribe si el ensayo pasa. Con campos nuevos sin consolidar, el botón pasa por Consolidando… antes de Guardando…. Si no había nada más que guardar, avisa Estructura consolidada: Los campos nuevos ya salen en la ficha.

Las notificaciones:

• Nada que guardar: no has cambiado nada.
• No se puede guardar: el servidor rechazaría N campos, listados en pantalla.
• Todavía no se puede guardar: no se ha podido leer qué campos se pueden escribir. Pulsa Volver a intentarlo.
• Solo lectura: el servidor no publica hoy ninguna columna editable para los campos.
• No se ha guardado: el servidor ha rechazado la colocación, con su motivo.
• Guardado: N campos movidos · N propiedades cambiadas.
• Guardado a medias: la colocación entró y alguna casilla no.
• Hay campos que no han entrado: siguen pendientes y están en el resultado con su motivo.

La tarjeta de resultado dice lo que contestó el servidor, entero. Solo se queda en pantalla cuando hay algo que leer: columnas rechazadas, un fallo o una consolidación pendiente.

Cerrar quita la tarjeta.

Salir

Lo movido sin guardar está solo en la memoria de esta pantalla. Salir por el botón Secciones, por el menú lateral o con la flecha de volver atrás del navegador pregunta Tienes N campos movidos sin guardar y N campos nuevos sin consolidar. Si sales ahora, lo movido se pierde y los campos nuevos no saldrán en la ficha hasta la próxima consolidación. Guardar arregla las dos cosas., con Salir igualmente o Seguir aquí. Recargar la página o cerrar la pestaña del navegador muestra el aviso del propio navegador.

Lo que el lienzo no puede mostrar: en un móvil, por debajo de 1000 px de ancho, la ficha pone todas las etiquetas encima de su campo, y aquí siempre se dibuja la maqueta de escritorio. Tampoco se muestran datos: un campo vacío y uno con un texto largo ocupan lo mismo, pero no se leen igual.