Elementos
Cada propiedad puede ser fija o calcularse con un binding {{ … }}. Cada elemento tiene además Visible si (un binding; vacío = siempre).
| Elemento | Propiedades | Evento |
|---|---|---|
| Título | texto, nivel 1–4, alineación | – |
| Texto | texto, markdown, atenuado, alineación | – |
| Separador | etiqueta (opcional), alineación de la etiqueta, línea (continua, discontinua, punteada), vertical | – |
| Espacio | – (solo espacio vacío en la cuadrícula) | – |
| HTML | HTML con marcadores {{ … }}, opcionalmente una consulta y parámetros (entonces record y records), como tarjeta |
– |
| Imagen | dirección de la imagen (URL), texto alternativo, ajuste, esquinas redondeadas | – |
| Botón | etiqueta, estilo (primary, secondary, danger, ghost), alineación, ancho completo, desactivado si | clic |
| Campo | etiqueta, nombre, tipo (texto, número, correo, teléfono, URL, contraseña, varias líneas), texto de ejemplo, valor inicial, obligatorio, desactivado si, ayuda | cambio |
| Selección | etiqueta, nombre, opciones (una por línea) o una consulta con campo de valor y de etiqueta, texto de ejemplo, valor inicial, obligatorio | cambio |
| Fecha | etiqueta, nombre, con hora, valor inicial, obligatorio | cambio |
| Casilla | etiqueta, nombre, valor inicial | cambio |
| Interruptor | etiqueta, nombre, valor inicial; como una casilla (sí/no), mostrado como interruptor | Cambio |
| Opciones | etiqueta, nombre, opciones o una consulta con campo de valor y de etiqueta, en línea, valor inicial, obligatorio – exactamente una elección | Cambio |
| Selección múltiple | como Opciones, pero cuantas se quiera; el valor es una lista | Cambio |
| Control deslizante | etiqueta, nombre, mínimo, máximo, paso, unidad, valor inicial; el valor es un número | Cambio |
| Valoración | etiqueta, nombre, máximo (5 estrellas), valor inicial; un clic en la estrella actual la borra, Flecha izquierda/derecha la cambia | Cambio |
| Selección con búsqueda | etiqueta, nombre, consulta, parámetros, parámetro de búsqueda (por defecto q), campo de valor y de etiqueta, etiqueta mostrada, marcador, obligatorio |
Cambio |
| Archivo | etiqueta, nombre, tipos permitidos (p. ej. image/*,.pdf), varios archivos, obligatorio, desactivado si, texto de ayuda; va dentro de un formulario |
Cambio |
| Formulario | título, texto del botón, vaciar tras enviar; contiene campos | envío |
| Tabla | título, consulta, parámetros, columnas (campo, etiqueta, formato), filas por página, ordenable, texto si está vacía | selección |
| Vista de detalle | título, registro (enlace, p. ej. {{el.leadsTable.selected}}) o una consulta con parámetros, campos (campo, etiqueta, formato; vacío = todos), columnas (1–4), ocultar campos vacíos, texto si está vacía |
– |
| Lista | consulta, parámetros, título/texto/insignia por entrada, columnas 1–4, máximo, texto si está vacía | selección |
| Gráfico | título, consulta, parámetros, tipo (columnas, barras horizontales, línea, área, circular, anillo), campos de etiqueta, valor y serie, agrupar (por registro, recuento, suma, media), apilado, formato de los valores (número, moneda, porcentaje, horas) | Selección |
| Indicador | título, valor (enlace) o una consulta con campo de valor y agregación (primer registro, cantidad, suma, media, mínimo, máximo), formato (número, moneda, porcentaje, horas), decimales, unidad, subtítulo, comparar con (muestra el cambio en % con una flecha), texto de la comparación, al subir es bueno/malo, icono | Clic |
| Calendario | título, consulta, parámetros, campos de inicio, fin (opcional), título y color (color de etiqueta como blue o #hex), vista mes/semana |
Selección, clic en un día |
| Mapa | título, consulta, parámetros, tipo (puntos, áreas), campo de latitud/longitud, título/texto por punto, campo de color, agrupar puntos cercanos, campo de área, campo de valor, agregar, formato, mapa base, centro, zoom | selección |
| Kanban | título, consulta, parámetros, campo de columnas, columnas (orden; vacío = como en los datos), título/texto/insignia por tarjeta, campo de suma y formato, texto si está vacío | Selección, Mover |
| Galería | título, consulta, parámetros, campo de imagen (columna de adjuntos o dirección de imagen), título/texto/insignia por mosaico, columnas 2–6, proporción (horizontal, cuadrada, vertical), ajuste, texto si está vacío | Selección |
| Insignia | texto, color (color de etiqueta; vacío = según el texto), alineación | – |
| Progreso | etiqueta, valor, máximo (100), ocultar valor, texto del valor, color (vacío = acento, ok, warn, danger – también como enlace) |
– |
| Contenedor | título, estilo (tarjeta, sencillo); cuadrícula propia | – |
| Pestañas | pestañas con etiquetas; una cuadrícula por pestaña | – |
| Diálogo | título, tamaño; se muestra con el paso Abrir diálogo | – |
Campo (entrada, selección, fecha, casilla): la columna de la que Rellenar formulario toma el valor cuando el nombre del elemento es distinto (p. ej. nombre due_date, campo due date).
Indicador: porcentaje espera el valor ya en porcentaje (42 → «42 %»). Comparar con suele ser un enlace al valor anterior, p. ej. {{query.kpis.data.hoursPrev}}; el cambio se muestra en verde cuando va en la buena dirección (para costes o pendientes de cobro elige al subir es malo).
Gráfico: el campo de serie reparte los valores según una segunda columna – columnas y barras quedan entonces una junto a otra (o una encima de otra con apilado), cada serie tiene su propia línea o área; circular y anillo no lo usan. Una serie toma el color de acento de la app, varias series y los sectores reciben hasta ocho colores fijos, distinguibles también con deficiencias en la visión del color (los siguientes pasan a «Otros»), siempre con leyenda – con valor y proporción en el circular. Cada columna, punto y sector muestra sus valores al pasar el ratón. Selección se ejecuta al hacer clic, con point = {label, series, value} – p. ej. Abrir página con el parámetro stage = {{point.label}}; en la página de destino {{url.stage}} lee el valor.
Descarga CSV (tablas, listas, gráficos; desactivada hasta que la actives): un botón CSV arriba a la derecha del elemento. Tablas y listas cargan para ello todos los registros de su consulta (no solo la página mostrada, en el orden actual), las tablas con sus columnas y encabezados, las listas con todos los campos; un gráfico entrega lo que muestra (una fila por etiqueta, una columna por serie, valor y proporción en el circular). El archivo es UTF-8 y sigue el idioma de la interfaz: coma como separador si el separador decimal es el punto (inglés), si no punto y coma y coma decimal – así Excel lo abre directamente. Los valores van en bruto (números sin separador de miles, fechas como 2026-11-12); un texto que empieza como una fórmula (=, +, -, @) recibe un apóstrofo delante. La acción Exportar CSV crea el mismo archivo – también sin botón en el elemento.
Calendario: mes o semana, con navegación y Hoy; las entradas de varios días aparecen en cada día, con más de tres en un día «+n más» abre la semana. el.<id>.from y el.<id>.to son el periodo visible (AAAA-MM-DD) – como parámetros de la consulta carga solo ese. Selección se ejecuta al hacer clic en una entrada (con item, también el.<id>.selected), clic en un día con date (p. ej. Rellenar formulario con {"day": "{{date}}"} y abrir un diálogo para crear).
HTML: HTML libre para mosaicos, avisos o tarjetas propias. Los marcadores se escapan antes de insertarse – un valor con <b> aparece como texto, no como marcado. Después el HTML se depura: sin scripts, sin controladores de eventos (onclick …), sin enlaces javascript:, sin bloques <style>, formularios ni marcos; los estilos en línea (style="…"), los enlaces (también mailto:, tel:) y las imágenes se mantienen. Los enlaces con target="_blank" se abren sin acceso a la app. El navegador muestra imágenes de otras direcciones solo si los ajustes de seguridad lo permiten. Con una consulta el elemento carga sus datos por sí mismo: {{record.name}} es el registro (o el primero), {{records}} la lista.
Archivo: Ejecutar consulta con una consulta Subir un archivo envía cada archivo elegido del formulario (o del campo de archivo elegido en la acción) al registro, uno a uno – con un permiso de escritura justo sobre esa tabla, nunca más de lo que la cuenta ya puede. El tamaño (como máximo 50 MB por archivo) y los tipos permitidos los define además la columna de adjuntos; se comprueba el contenido, no la extensión. Un registro nuevo con archivo: primero Crear registro, luego Subir un archivo con {{query.<crear>.record.id}} como registro. el.<id>.value es la lista de archivos elegidos; Vaciar formulario la vacía.
Kanban: una columna por valor del campo de columnas, la cabecera muestra el número y (con un campo de suma) la suma. Las tarjetas se arrastran a otra columna con el ratón o el dedo; con el teclado, Flecha izquierda/derecha mueve la tarjeta activa, Intro la selecciona. Mover se ejecuta con item (la tarjeta), lane (la columna de destino) y from – normalmente Ejecutar consulta con una consulta de cambio {"id": "{{item.id}}", "stage": "{{lane}}"} y luego Recargar consulta. La tarjeta aparece enseguida en la nueva columna; si una acción falla, vuelve. Números, importes y porcentajes solos como insignia se muestran en gris neutro.
Galería: si el campo de imagen es una columna de adjuntos, el mosaico muestra la primera imagen como miniatura; sin un evento Selección propio, un clic abre la imagen en grande (Esc cierra). Las imágenes y archivos de las columnas de adjuntos pasan por la dirección propia de la app (ver fileUrl en Enlaces y acciones) – también para usuarios de apps y apps públicas, que no pueden usar la API REST.
Selección con búsqueda: busca mientras escribes – la consulta recibe el texto en su parámetro de búsqueda, p. ej. una lista con el filtro name contiene {{params.q}} (texto vacío = todos). Para claves foráneas en tablas grandes, donde una Selección sería demasiado larga. Obligatorio significa una entrada de la lista, no solo texto. Cuando Rellenar formulario fija un valor, la etiqueta mostrada (p. ej. {{query.lead.record.client_name}}) muestra su nombre; el.<id>.label es la etiqueta de la elección. Selección múltiple entrega una lista – como parámetro de tipo cualquiera.
Separador y espacio estructuran una página: un separador es una línea, si quieres con un pequeño título (a la izquierda, centrado o a la derecha) o vertical entre dos columnas. Un espacio es espacio vacío, por ejemplo para mantener un botón a la derecha. En el móvil, donde todos los elementos se apilan, los espacios y los separadores verticales desaparecen; los separadores horizontales se quedan.
Mapa
El mapa muestra registros como puntos o colorea países y regiones según un valor.
- Puntos: campo de latitud y longitud (por defecto
latitude/longitude, grados decimales). Título y texto por punto con marcadores ({{item.name}}) aparecen al pasar el ratón. El campo de color admite un color de etiqueta (red, blue …),#hexo una categoría (hasta ocho, con leyenda). Los puntos cercanos se agrupan en un número; un clic acerca, y si están en el mismo lugar aparece una lista para elegir. Evento selección conitem. - Áreas: el campo de área contiene un código de país (ISO 3166 alfa-2 como
DEo alfa-3 comoDEU), un código de región (ISO 3166-2 comoDE-BY) o el nombre de un país; además campo de valor y agregar (suma, recuento, media). Cinco tonos de un color, una leyenda con el valor menor y el mayor y un tooltip con nombre y valor. Evento selección conarea(code,name,value). - Encuadre: se ajusta a los datos (en áreas, al territorio continental, sin territorios de ultramar); centro (
lat, lng) y zoom lo fijan. Arrastrar desplaza; doble clic, + / − y Ctrl + rueda hacen zoom – la rueda sola solo tras un clic en el mapa, si no se desplaza la página; ⤢ vuelve a mostrar todo. Teclado: flechas, + / −, 0. En pantallas táctiles un deslizamiento vertical desplaza la página hasta que tocas el mapa; dos dedos hacen zoom. - Mapa base: integrado, de Natural Earth (dominio público): países, costas y desde el zoom 5 los límites de las regiones – sin peticiones externas, también sin internet. No muestra calles ni lugares. Si hay un servidor de teselas configurado (Ajustes → Seguridad → Mapas), sus teselas quedan debajo; mapa base: outline usa igualmente el integrado.
- Las coordenadas a partir de direcciones (geocodificación) no están integradas – las traen los datos, por ejemplo mediante un script o un workflow con tu propio servicio.
Valores de los elementos
- Campo, selección, fecha, casilla:
el.<id>.value– p. ej.{{el.search.value}}como parámetro de una consulta. - Formulario:
el.<id>.values– nombre del campo (o su ID) → valor. Al enviar, el mismo contenido está disponible comovalues. - Tabla y lista:
el.<id>.selected– el último registro seleccionado; en el evento selección comorow(tabla) oitem(lista). - Pestañas:
el.<id>.tab– el ID de la pestaña abierta.
Elementos de datos
Tablas, listas, gráficos y selecciones con consulta cargan sus datos solos: en cuanto cambia un parámetro (un campo de búsqueda, por ejemplo), vuelven a consultar poco después. Sin lista de columnas, una tabla muestra todos los campos de la consulta. Formatos: fecha, fecha y hora, número, moneda, sí/no, insignia (el valor como pastilla de color) y progreso (0–100 como barra). Sin color propio, los estados habituales reciben uno elocuente: Done, Paid, Won, Approved, Active verde, Overdue, Lost, Urgent, Blocked rojo, Review, Sent, Proposal, In progress, High ámbar, Qualified, Scheduled, Medium azul, New, Open, To do, Backlog, Draft, Low gris; cualquier otro valor siempre el mismo color.
La vista de detalle muestra un registro como lista de campos con etiquetas – por ejemplo el registro elegido en una tabla o el resultado de una consulta Un registro (en una lista, su primera entrada). Las columnas se ordenan solas: en superficies estrechas los campos se apilan. Además de los formatos de la tabla hay aquí Markdown (para textos largos, a todo el ancho). Los valores vacíos aparecen como «–», o no aparecen con Ocultar campos vacíos.