Cómo se declara, en un texto de configuración, lo que enseña cada ficha de edición de SmartPWA: sus pestañas y campos, las rejillas del panel inferior y las opciones de su menú desplegable.

Nada de esto está en el programa: vive en la base de datos, en el campo DESCRIPCION de la tabla PWA_FORMS, y se lee cada vez que se abre la ficha. Cambiar dónde va un campo, añadir una pestaña de una tabla hija o quitarle a una instalación una opción del menú es cambiar ese texto, sin tocar la aplicación ni publicar una versión nueva.

Una fila de PWA_FORMS es la definición de una pantalla para un ámbito. La clave primaria es COD_FORM + TIPO_AMBITO + COD_AMBITO + CLAVE_INSTALACION, donde COD_FORM es el código de la pantalla tal y como lo nombra la aplicación: albaran-venta-edit, parte-averia-edit, producto-edit… (distingue mayúsculas de minúsculas).

Cuando la ficha se abre, PWA_GET_FORM(COD_FORM, COD_USUARIO) elige una sola de esas filas —usuario, usuario del que hereda, clave de instalación, clave de grupo y, por último, la general—, así que una instalación que no alquile no tiene por qué ver la pestaña «Precios alquiler», y a un usuario se le puede dejar la ficha con los cuatro campos que usa. Cómo se gestiona todo eso está en Ámbitos: quién ve qué.

<note important>Cada definición describe la ficha entera, no un parche sobre la general: lo que se añada a la general no llega a quien tenga la suya.</note>

<note>El texto se lee en tres trozos de 8000 caracteres, así que el límite práctico de un layout son 24 000 caracteres. Una ficha con cuarenta pestañas anda por los ocho mil.</note>

<note tip>La aplicación cachea la definición por usuario y formulario. Después de cambiar el texto hay que volver a entrar en la aplicación para verlo.</note>

• Desde la propia aplicación, en Formularios (/formularios), que además ofrece «Copiar script de actualización» y «Descargar script (.sql)» para llevar el cambio a otras bases de datos.
• En el repositorio, los layouts generales están versionados en db/pwa_forms_layouts.sql (UPDATE OR INSERT, idempotente), y de ahí salen los scripts JMnnnn que se incorporan a las bases de los clientes.

Una directiva por línea. Las líneas en blanco se ignoran y los nombres se recortan. Lo que no encaje con ninguna directiva se toma como una fila de campos.

P:General
C1:40%
NRO_ALBARAN
TIPO_TERCERO, COD_TERCERO
-USUARIO_CREA
+COMENTARIOS(300%, 100%)
QRES.S_CUOTA_TOTAL

• Coma: los campos de una misma línea se pintan uno al lado del otro.
• Guión delante (-USUARIO_CREA): el campo se ve pero no se edita.
• Más delante (+COMENTARIOS): la etiqueta va encima del cuadro en vez de a su izquierda. Es lo que quieren los campos anchos.
• Paréntesis con dos porcentajes (COMENTARIOS(300%, 100%)): cuadro de texto multilínea. El primero es cuánto crece de alto respecto a un campo normal (100 % = el doble de alto) y el segundo, el ancho como porcentaje de la columna.
• Las marcas se combinan y en cualquier orden: -+USUARIO_CREA.
• ALIAS.CAMPO: el campo sale de un origen auxiliar D: y no de la tabla de la ficha; siempre de solo lectura.

P:General
C1:40%
NRO_ALBARAN
TIPO_TERCERO, COD_TERCERO
NOMBRE
RAZON_SOCIAL
COD_OBRA
DESC_OBRA
C2:30%
NRO_PEDIDO
REFERENCIA
FECHA_SERVICIO
FECHA_DEVENGO
COD_DELEGACION
C3:30%
COD_FORMA_ENTREGA
SOLICITANTE
ENTREGADO_A
PRIORIDAD

Tres columnas que suman el 100 %, y el tercero en su fila junto a su tipo. Los anchos son orientativos: si no suman cien, se reparte lo que haya.

P:Comentarios
C1:100%
+COMENTARIOS(300%, 100%)

Etiqueta encima, cuatro veces el alto de un campo normal y todo el ancho de la columna. Es como están los comentarios del cliente, del producto y del parte de avería.

P:Datos
C1:50%
CODIGO
DESCRIPCION
C2:50%
FECHA_ALTA
COD_DELEGACION
L:Importes
C1:33%
BASE_IMPONIBLE
C2:33%
CUOTA_IVA
C3:34%
TOTAL

Sin el L:, las columnas nuevas se seguirían añadiendo a la derecha de las anteriores. Con él, Importes empieza una franja debajo, con sus propios anchos y su título.

Es el mismo juego en los datasets D:, en las rejillas R: y en las acciones A::

En las rejillas de procedimiento, un parámetro con ? delante no se fija: se propone. El usuario lo ve relleno en la barra de filtros y puede cambiarlo antes de consultar.

No todos los campos de una cabecera salen de su tabla: algunos los calcula un procedimiento (los totales) y otros viven en una tabla aparte.

D:QRES = RESUMEN_ALB_VENTA_TOTAL3(:NRO_ALBARAN)
D:QUSU = USUARIOS_EN_ALBARANES[NRO_ALBARAN = :NRO_ALBARAN]
...
QRES.S_CUOTA_TOTAL

Con paréntesis el origen es un procedimiento seleccionable y lo de dentro son sus parámetros, por posición. Con corchetes es una tabla y lo de dentro son las condiciones del WHERE. Se lee la primera fila, y sus campos son siempre de solo lectura.

D:QRES = RESUMEN_ALB_VENTA_TOTAL3(:NRO_ALBARAN)
P:Totales
C1:50%
QRES.S_BASE_TOTAL
QRES.S_CUOTA_TOTAL
QRES.S_TOTAL

D:SIT = SITUACION_ACTIVO_A_FECHA(:COD_PRODUCTO, :NRO_SERIE, :FECHA_PARTE)
P:Último tenedor
C1:50%
SIT.S_TIPO_TERCERO
SIT.S_COD_TERCERO
SIT.S_COD_OBRA
C2:50%
SIT.S_FECHA_INI
SIT.S_FECHA_FIN
SIT.S_DIAS_NATURALES

El procedimiento recibe tres campos de la propia cabecera, así que la pestaña se rellena sola en cuanto la ficha sabe de qué máquina habla.

Cada R: es una pestaña de la parte de abajo de la ficha: las tablas hijas y las consultas del documento. Se añaden a las que la pantalla traiga de código —las líneas de un albarán no son configurables: un albarán sin líneas no es nada— y salen en el orden en que se declaran.

R:Unidades = UDS_EQUIV_PRODUCTO
R:Ubicaciones = UBICACION_PRODUCTO [COD_ALMACEN = :COD_ALMACEN] orden=COD_ALMACEN
R:Extracto = EXTRACTO_TERCERO(P_COD_TERC = :CODIGO, ?P_FEC_INI = HOY-3A)

• Corchetes: filtran la rejilla. Sin ellos manda el filtro que pase la ficha (el número del albarán, el código del producto…), que es lo normal.
• Paréntesis: el origen es un procedimiento y la pestaña enseña su consulta. Dentro van los parámetros que se fijan, por nombre; los que no se nombren quedan a mano del usuario en la barra de filtros.

<note>n=si es un COUNT más al abrir el grupo de pestañas: se pone donde el número compense.</note>

Líneas que se numeran solas, de diez en diez mil o de una en una:

R:Productos = PRODUCTO_TERCERO alta=maximo(NRO_LINEA, 1)
R:Productos complementarios = PROD_COMPLEMEN_PROD alta=maximo(NRO_LINEA)

Una tabla hija cuyo número lo da un generador de la base de datos:

R:Obras = OBRA_TERCERO modo=lista alta=generador(GEN_NRO_OBRA)
R:Documentación = DOC_PERFIL [COD_PRODUCTO = :CODIGO] modo=lista
  alta=generador(GEN_NRO_DOCUMENTO, P_FECHA = HOY, P_SIM = SIMULACION)

Documentos de otra tabla que cuelgan de esta ficha, para mirar y no para teclear (modo=lista abre la ficha con doble clic; alta=none quita el botón de nueva fila):

R:Ofertas = CAB_OFERTA_VENTA [TIPO_TERCERO = :TIPO, COD_TERCERO = :CODIGO]
  modo=lista alta=none
R:Partes de avería = CAB_PARTE_AVERIA [TIPO_TERC_ALB = :TIPO,
  COD_TERC_ALB = :CODIGO, CERRADO = 'N'] modo=lista alta=none

Fíjese en el CERRADO = 'N': un filtro no tiene por qué apuntar a un campo de la ficha; puede ser un literal, y así la pestaña enseña solo los partes abiertos.

Una fila que crea el sistema, no el usuario: el botón «Nueva» ejecuta un procedimiento y recarga la pestaña.

R:Ficha de crédito y caución = CLIENTE_CREDITO_CAUCION [CIF_NIF = :CIF_NIF]
  modo=lista alta=proceso(CREA_CYC_DESDE_CL, P_TIPO_TERCERO = :TIPO,
  P_COD_TERCERO = :CODIGO)

El comentario libre del cliente, que vive en otra tabla con una única fila por tercero y se edita como un texto y no como una rejilla:

R:Comentario libre = COMENTARIO_TERCERO modo=memo campo=COMENTARIO

Y una pestaña que además dice cuántas filas tiene, ordenada por almacén:

R:Ubicaciones = UBICACION_PRODUCTO [COD_ALMACEN = :COD_ALMACEN]
  orden=COD_ALMACEN n=si

El extracto del cliente, con dos fechas que el usuario puede cambiar y las columnas técnicas escondidas:

R:Extracto = EXTRACTO_TERCERO(P_TIPO_TERC = :TIPO, P_COD_TERC = :CODIGO,
  P_NRO_FACTURA = NULL, ?P_FEC_INI = HOY-3A, ?P_FEC_FIN = HOY)
  ocultas=TIPO_TERCERO;COD_TERCERO;S_TIPO_TERCERO;S_COD_TERCERO

Los cobros pendientes a una fecha, con fila de totales y con un único parámetro a la vista:

R:Cobros pendientes = COBROS_PENDIENTES(P_TODO = 'S', P_TIPO_TERCERO = :TIPO,
  P_COD_TERCERO = :CODIGO, ?P_FECHA = FIN_ANO)
  visibles=P_FECHA totales=si

<note important>Cada rejilla va en una sola línea; en la página se han partido para que quepan.</note>

Cuando las pestañas son muchas, G: las reparte: cada R: cae en el grupo que abrió el último G:, y el panel enseña una fila con los grupos y, debajo, solo las pestañas del que esté elegido.

G:Tablas
R:Direcciones = DIRECCION_TERCERO
G:Consultas
R:Extracto = EXTRACTO_TERCERO(P_COD_TERC = :CODIGO)

G:Consultas
R:Extracto = EXTRACTO_TERCERO(P_TIPO_TERC = :TIPO, P_COD_TERC = :CODIGO)
R:Cobros pendientes = COBROS_PENDIENTES(P_TODO = 'S', ?P_FECHA = FIN_ANO)
G:Tablas
R:Bancos = BANCO_TERCERO
R:Obras = OBRA_TERCERO modo=lista alta=generador(GEN_NRO_OBRA)
R:Comentario libre = COMENTARIO_TERCERO modo=memo campo=COMENTARIO

Las R: anteriores al primer G: se quedan sin grupo y caen en Detalles, que es donde van también las pestañas que la ficha trae de código. Un layout que no declare ningún grupo sigue enseñando la barra de pestañas de siempre.

Cada A: es una opción del menú desplegable de la ficha (el botón de la flecha, arriba a la derecha). Salen en el orden en que se declaran y delante de las que ofrecen todas las fichas —Eliminar, Copiar url, Color de fondo y Volver—, de las que las separa una línea horizontal.

A:título = destino  modificadores

El @metodo es la válvula de escape: hay opciones cuya lógica no cabe en una línea de texto —la que encadena tres procedimientos mirando lo que devuelve cada uno, la que abre un diálogo propio para elegir una máquina—. Esas siguen en el programa, pero el layout manda igualmente en su texto, su icono, su sitio en el menú y su tecla. Los nombres de método que admite cada pantalla los publica esa pantalla.

En los textos de pregunta= y aviso()'' se escribe :CAMPO para meter el valor del campo de la cabecera.

Varias cosas separadas por punto y coma, y en ese orden:

abrir y aviso miran la primera salida del procedimiento —los de este sistema devuelven el número del documento que crean, o nada—, que en los textos se escribe :SALIDA. Si no hay salida no se abre ni se avisa: el procedimiento no llegó a crear nada.

A:Confirmar  F11 = @confirmar icono=checkmark-circle-outline tecla=F11
A:Facturar avería = FACTURAR_AVERIA(:NRO) icono=cash-outline
  pregunta="¿Facturar el parte :NRO?" boton="Facturar"
  tras=refrescar;abrir(CAB_FACTURA_VENTA, NRO_FACTURA)
A:Imprimir  F8 = IMPRES_PARTE_AVERIA(P_NRO_PARTE = :NRO) modo=consulta
  icono=print-outline tecla=F8
A:Generar albaranes  F10 = CAB_ALBARAN_VENTA[NRO_PARTE_AVERIA = :NRO]
  proc=GEN_ALBARANES_AVERIA(:NRO) proc=GEN_ALBARANES_AVERIA_COMPRA(:NRO)
  icono=receipt-outline tecla=F10
A:Asignar terminal = PCO_ADD_AVERIA_CARTERA(P_NRO_PARTE = :NRO) modo=proceso
  icono=phone-portrait-outline

<note important>Cada opción va en una sola línea; aquí se han partido para que quepan en la página.</note>

<note>Mientras un layout no declare ninguna A:, la ficha enseña el menú que trae de código. Es lo que permite ir pasando las pantallas al layout de una en una, sin que ninguna se quede por el camino sin opciones.</note>

Ejecutar un procedimiento y contar lo que ha hecho. Si no ha creado nada, no dice nada:

A:Confirmar (albarán compra) = CONFIRM_PARTE_AVERIA_COMPRA(:NRO, HOY)
  icono=cart-outline pregunta="¿Confirmar el parte :NRO en albarán de compra?"
  boton="Confirmar"
  tras=refrescar;aviso("Se ha generado el albarán de compra :SALIDA.")

Cerrar algo y llevar a la pestaña donde se ve el resultado:

A:Cerrar presupuesto = CIERRA_AVERIA_PPTO(:NRO, NULL)
  icono=lock-closed-outline pregunta="¿Cerrar el presupuesto de la avería :NRO?"
  boton="Cerrar" tras=refrescar;pestana(CAB_OFERTA_VENTA)

Generar primero y enseñar después. Los dos proc= corren en orden y luego se abre la pestaña de los albaranes (o su listado, si esta instalación no la tiene en el panel):

A:Generar albaranes  F10 = CAB_ALBARAN_VENTA[NRO_PARTE_AVERIA = :NRO]
  proc=GEN_ALBARANES_AVERIA(:NRO) proc=GEN_ALBARANES_AVERIA_COMPRA(:NRO)
  icono=receipt-outline tecla=F10

Una misma opción con dos caras, según cómo esté el registro. Son dos líneas que nunca salen a la vez:

A:Confirmar  F11 = CONFIRM_ALB_VENTA(:NRO_ALBARAN) si=CONFIRMADO<>S
  tecla=F11 icono=checkmark-circle-outline
  pregunta="¿Confirmar el albarán :NRO_ALBARAN?" boton="Confirmar"
  tras=refrescar
A:Desconfirmar  F11 = CONFIRM_ALB_VENTA_DESHACER(:NRO_ALBARAN) si=CONFIRMADO=S
  tecla=F11 icono=close-circle-outline
  pregunta="¿Desconfirmar el albarán :NRO_ALBARAN?" boton="Desconfirmar"
  tras=refrescar

Un informe, que no es más que una consulta con sus parámetros puestos:

A:Imprimir  F8 = IMPRES_PARTE_AVERIA(P_NRO_PARTE = :NRO) modo=consulta
  icono=print-outline tecla=F8

Un proceso que el usuario termina de rellenar. Lo declarado va fijo y lo demás lo pide la pantalla de procesos:

A:Asignar terminal = PCO_ADD_AVERIA_CARTERA(P_NRO_PARTE = :NRO) modo=proceso
  icono=phone-portrait-outline

Un listado de otra tabla acotado a esta ficha, sin procedimiento de por medio:

A:Ver sus facturas = CAB_FACTURA_VENTA[TIPO_TERCERO = :TIPO,
  COD_TERCERO = :CODIGO] icono=document-text-outline

Algo que hay que hacer en el programa, con el layout decidiendo dónde va y cómo se llama:

A:Escoger máquina = @escogerMaquina icono=cube-outline

D:SIT = SITUACION_ACTIVO_A_FECHA(:COD_PRODUCTO, :NRO_SERIE, :FECHA_PARTE)
P:General
C1:50%
NRO
DESCRIPCION
COD_PRODUCTO, NRO_SERIE
C2:50%
FECHA_PARTE
-CERRADO, -FECHA_CIERRA
P:Último tenedor
C1:100%
SIT.S_TIPO_TERCERO
SIT.S_COD_TERCERO
P:Comentarios
C1:100%
+COMENTARIOS(300%, 100%)
G:Tablas
R:Albaranes de venta = CAB_ALBARAN_VENTA [NRO_PARTE_AVERIA = :NRO] modo=lista
G:Consultas
R:Facturas = FACTURAS_EN_AVERIA(P_NRO_PARTE = :NRO)
A:Cerrar avería = CIERRA_AVERIA(:NRO, NULL) icono=lock-closed-outline

La ficha de series, entera:

P:General
C1:50%
CODIGO
DESCRIPCION
SERIE_RELACIONADA
C2:50%
SIMULACION
OMITIR_CTRL_BLOQ_ULT_FRA

Una pestaña, dos columnas, cinco campos. No hace falta más para que la ficha funcione: sin R: no hay panel inferior, y sin A: el menú es el de siempre.

• Diseño del menú (PWA_MENUS), que se declara con la misma idea y otra sintaxis.
• Ámbitos: quién ve qué, común a formularios, menús e informes.

Este meta-lenguaje crece: cada vez que una ficha necesita algo que no se podía declarar, se le añade una directiva o un modificador. La página se actualiza en el mismo cambio, que es la única manera de que siga sirviendo.

Lo que hay que mirar en el código, por si esta página se ha quedado atrás: