e-cometa Metadata Language
La aplicación, escrita como metadatos
Cada pantalla, campo, botón y proceso de e-cometa es un registro de metadatos que la plataforma interpreta en tiempo de ejecución. Este es el lenguaje en que se escriben esos registros, especificado como un contrato versionado que pueden leer y validar personas, herramientas y asistentes.
colOrder
06#Price@color@greyEn el listado, una columna «Price» cuyas celdas toman el estilo gris del tema.
fieldOrder
050#Stock@POP@IDM310@FILTERrow.Reference=rowtarget.ReferenceEn la ficha, un botón «Stock» que abre la opción de menú 310 en un popup, filtrada por la referencia del registro actual.
fieldOrder
00#Generate@IDP12@PAR@@OUTR@1#Un botón que ejecuta el proceso 12 y le indica que escriba en el segundo de sus recursos de salida.
01
Una definición, tres zonas
Una pantalla es un listado, una ficha y un bloque de búsqueda generados de los mismos metadatos. Cada zona guarda su posición, su etiqueta y su ancho, de modo que el listado puede decir «P. Coste» y la ficha «Precio de coste».
02
El comportamiento se declara, no se programa
Qué abre un botón, qué proceso ejecuta, qué registro le pasa y cómo se pinta una columna se escriben en los metadatos. Cambiarlo es editar un registro, sin compilar ni desplegar.
03
Un contrato que se puede validar
Cada modificador está especificado con las zonas que lo leen, la gramática de su valor, cómo se combina con los demás, su efecto y las formas en que falla sin avisar. La especificación se publica en YAML con un JSON Schema, y cada consumidor fija una versión.
04
Independiente de quien lo interpreta
Los metadatos son el activo que perdura. Hoy los interpreta un frontend Vaadin y se sirven a través de un backend REST. El contrato describe efectos, no clases de implementación, así que puede sobrevivir a los dos.
e-cometa Metadata Language
Qué recoge la especificación de cada modificador
Una etiqueta lleva su posición, su texto y, tras la primera @, los modificadores que lee la plataforma.
- Dónde
- Las columnas de etiqueta y las zonas de pantalla que lo leen, y a qué tipo de campo se aplica.
- Valor
- Dónde acaba el valor, su gramática y quién define los valores válidos: la plataforma, el tema, los metadatos o el despliegue.
- Composición
- Si tiene que ir el último, con qué se combina y qué hace a su lado la marca de alineación.
- Efecto
- Lo que ve el usuario, en un párrafo.
- Fallos silenciosos
- Las posiciones y valores que no hacen nada, o rompen, sin mensaje de error.
Capítulos
- Modificadores de etiqueta →Especificado · v0.1.0-draft
- Pantallas, campos, menús, listas de valores y procesosSeguirán el mismo camino
La especificación es la referencia para quien escribe metadatos de e-cometa a mano, y la fuente de la que el asistente de e-cometa saca cómo explicar y comprobar lo que escribe.