El menú lateral de SmartPWA —sus categorías, sus secciones y cada opción con su icono y su destino— también se declara en un texto de configuración guardado en la base de datos.

Es el hermano del layout de los formularios: mismo sitio (un campo DESCRIPCION), mismos ámbitos y la misma idea de que lo que se ve no está compilado en el programa. Lo que cambia es la sintaxis, que aquí es más sencilla: una línea por opción.

En la tabla PWA_MENUS, cuya clave es COD_MENU + TIPO_AMBITO + COD_AMBITO + CLAVE_INSTALACION.

A quién se le aplica cada fila lo resuelve PWA_GET_MENU(COD_MENU, COD_USUARIO) con las cinco precedencias de siempre: usuario, usuario del que hereda, clave de instalación, clave de grupo y general. Está explicado en Ámbitos: quién ve qué.

<note>El menú se lee de un solo tirón, así que su límite son 8000 caracteres (el del layout de un formulario es tres veces mayor). Un menú completo de los que hay hoy anda por la mitad.</note>

Al arrancar, la aplicación pinta el menú en tres pasadas: primero el que lleva compilado dentro, después el que guardó de la última sesión y, cuando contesta la base de datos, el que le toca al usuario. Por eso:

• una base de datos a la que todavía no ha llegado el script de PWA_MENUS enseña el menú de respaldo, sin dar ningún error;
• sin conexión se sigue viendo el de la última vez;
• y un cambio en la base de datos no se ve hasta la siguiente entrada, o hasta recargar el menú desde la pantalla de menús.

M:Gestión de flota
S:Formularios
Control de vehículos | VEHI_CONTROL | speedometer
Avisos               | /avisos      | notifications | badge=avisos

Repetir un M: que ya existe no crea otra categoría: sus opciones se suman a las que ya tenía. Con las secciones pasa lo mismo. Eso permite escribir el texto por bloques —o pegarle a un menú un trozo de otro— sin que salgan categorías duplicadas.

Si alguna sección de la categoría tiene nombre, la categoría se pinta como acordeón; si ninguna lo tiene, sale la lista de opciones sin más.

Los cuatro campos van separados por barras verticales. Los espacios sobran, así que se pueden alinear en columnas para que el texto se lea, que es como están escritos los menús de hoy.

La regla es simple: si empieza por barra, es una ruta; si no, es una tabla.

Clientes | TERCERO | people | titulo=Clientes; defecto.TIPO=CL

Esa línea abre el listado de terceros titulado «Clientes» y, al dar de alta, propone el tipo CL. Es la manera de sacar del mismo listado varias opciones de menú distintas: clientes, proveedores y empleados son la misma tabla TERCERO con distinto valor por defecto.

Se nombran sin sufijo (people, car, document-text), y la aplicación pinta la variante que corresponde. Solo valen los del catálogo; los que no estén salen con el icono genérico (ellipse), sin dar error. La opción Comprobar el texto de la pantalla de menús dice cuáles no ha reconocido.

Para añadir un icono nuevo hay que meterlo en el catálogo del programa (menu/iconos-menu.ts), que es un cambio de versión: al escribir un menú conviene quedarse en los que ya hay.

M:Gestión de flota
S:Formularios
Control de vehículos    | VEHI_CONTROL                           | speedometer
Siniestros              | VEHI_SINIESTRO                         | warning
Contratos de vehículos  | VEHI_CAB_CONTRATO                      | document
Avisos                  | /avisos                                | notifications | badge=avisos
S:Configuración
Vehículos               | /consultas/ALR_FICHA_VEHICULO          | car
Perfiles documento      | DOC_PERFIL                             | document-text
S:Informes
Flota de vehículos      | /consultas/ALR_VEHICULOS_FLOTA         | car
Vehículos alquilados    | /consultas/ALR_VEHICULOS_ALQUILADOS    | car
Resumen facturación     | /consultas/ALV_DIARIO_FACTURAS_DELEG   | stats-chart

Es como está montado el menú de flota: los formularios con los que se trabaja, lo que se configura de tarde en tarde y los informes, separados.

M:Procesos
Borrar lote asientos    | /ejecutar-proceso/BORRAR_LOTE_ASIENTOS | trash
Dotación amortizaciones | /ejecutar-proceso/CONTAB_AMORT2        | calculator

Sin ninguna S:, la categoría enseña sus opciones seguidas, sin acordeón. Y un destino /ejecutar-proceso/PROC lleva a la pantalla que pide los parámetros de un proceso y lo lanza.

M:Terceros
S:Formularios
Clientes     | TERCERO | people    | titulo=Clientes;    defecto.TIPO=CL
Proveedores  | TERCERO | briefcase | titulo=Proveedores; defecto.TIPO=PR
Empleados    | TERCERO | person    | titulo=Empleados;   defecto.TIPO=EM
Bancos       | TERCERO | cash      | titulo=Bancos;      defecto.TIPO=BA

-- Menú de la instalación 026: sin alquiler y sin planificador.
M:Taller
S:Formularios
Partes de avería | CAB_PARTE_AVERIA | construct
-- Pendiente de que entre en producción el nuevo circuito de garantías:
-- Garantías      | GARANTIA_PARTE  | warning

Comentar una línea con – es la manera de quitar una opción sin perderla, que en un menú por instalación se agradece.

El menú se edita en Menús (/menus), y su propio menú de acciones trae:

Lo de Comparar con el general importa más de lo que parece: cada ámbito describe el menú entero, no un parche. Una instalación con menú propio no se entera de las opciones nuevas que se añadan al general, y esa comparación es lo que lo pone de manifiesto. Está explicado en Ámbitos: quién ve qué.

Como la de los formularios: se actualiza en el mismo cambio en que se toca la sintaxis.