Construir páginas y tiles
Una App es una pila de páginas, y cada página es una rejilla de tiles — el mismo modelo de tiles que usan los dashboards. Si ya ha construido un dashboard de Saiku, esto le resultará idéntico; la única capa nueva son las páginas de la App y la navegación a su alrededor.
Páginas
Toda App empieza con una página. En modo edición:
- Añada una página desde el menú de navegación (raíl o superior) —
el
+junto a la lista de páginas. - Renombre una página en el sitio; el nombre es lo que se ve en la navegación.
- Cambie de página haciendo clic en ellas en la navegación. Cada página recuerda su propio estado de filtros mientras se mueve entre ellas.
Ordene sus páginas para que sigan la historia que quiere contar — una página de resumen primero, páginas de detalle después.
Añadir tiles
En una página en modo edición, haga clic en + Añadir tile para abrir el menú de tiles. Los tipos integrados son:
| Tile | Qué muestra |
|---|---|
| Gráfico | Dieciséis tipos de gráfico — barras / línea / área / tarta / donut / cascada / treemap / sunburst / heatmap / radar / dispersión / burbuja / mapa. Vea El tile de Gráfico |
| Tabla | Registros de celdas de medida con cabeceras de fila |
| KPI | Una sola medida como número grande, con comparación y sparkline opcionales |
| Texto / nota | Una anotación en Markdown — sin datos |
| Imagen | Un logo, diagrama o captura desde una URL o una subida |
Elija un tipo y el tile cae en la rejilla. Colocación y tamaño funcionan igual que en un dashboard — arrastre para mover, arrastre el tirador para redimensionar.
Los filtros no están en este menú — se añaden en el panel Filtros de la página, encima de la rejilla.
Vincular un tile a los datos
Añadir un tile elige su tipo; el ⚙ editor del tile es donde le da datos. Ábralo desde el botón de edición del tile. Según el tipo de tile, configura:
- El cubo y la consulta — para tiles de gráfico, tabla y KPI, elija la conexión / cubo y construya la consulta (medidas, dimensiones en filas o columnas, slicers). Vea De dónde sale la consulta de un tile más abajo.
- El tipo de gráfico, y tras el botón Opciones de gráfico un segundo editor con ejes duales, tipos de serie combo, líneas de tendencia, orden / Top N, formato numérico, líneas y bandas de referencia. Un tile de gráfico también puede detectar anomalías, proyectar una previsión y emitir un filtro cruzado al arrastrar sobre él. Todo eso tiene su propia página: El tile de Gráfico.
- La medida y la comparación — para un KPI, qué medida es el número
grande y (opcionalmente) contra qué se compara. Use el patrón de
formato
$cNpara moneda compacta ($48.2K). Vea Comparaciones de KPI más abajo. - El contenido — el cuerpo Markdown de un tile de texto, o la URL / subida de un tile de imagen (esos dos no necesitan consulta).
- Formato condicional — los tiles de tabla admiten reglas por columna: color de fondo, barras de datos, color de fuente o un icono (↑ ↓ →), atados a umbrales relativos (percentil) o absolutos. Una tabla también puede añadir una columna de sparkline al final, dibujando un minigráfico por fila con los valores de medida de esa fila — significativo cuando esas columnas forman una serie (meses, digamos), menos entre medidas no relacionadas.
- Formato numérico (por columna) — los tiles de tabla aceptan un
patrón de visualización por columna, casado por la caption de la
cabecera, con el mismo vocabulario que los tiles de KPI y lista
rankeada:
$cNmoneda compacta,$Nmoneda simple,N%porcentaje,Na secas para decimales. Merece la pena en cualquier medida entera cuya cadena de formato del cubo lleve un decimal — si no, un conteo de unidades se dibuja como10759.0. Las columnas que omita conservan el formato del propio cubo. - Auto-refresco — cualquier tile ligado a consulta puede re-ejecutarse cada 1, 5, 15, 30 o 60 minutos, respetando los filtros activos y pausándose mientras la pestaña del navegador está oculta.
Para los tiles personalizados de ECharts option el editor añade opciones de visualización: un conmutador en vivo Trend / Breakdown (cambiar la serie entre línea y barras sobre los mismos datos), enfatizar el último punto (un marcador de acento de «periodo actual») y un formato del eje de valores. Vea Tiles personalizados.
Los tiles de texto e imagen son los dos que no llevan consulta; todo lo demás se vincula a un cubo.
De dónde sale la consulta de un tile
Hay dos formas de darle su consulta a un tile, y están en sitios distintos del editor ⚙.
Constrúyala aquí. Haga clic en Editar consulta visualmente y el constructor de consultas completo de Saiku se abre dentro del editor del tile: el árbol del cubo a la izquierda, las zonas de suelta Medidas / Columnas / Filas / Filtro, y una rejilla de resultados en vivo debajo. Se ejecuta mientras construye, así que ve los números reales antes de comprometer el tile. Aplicar fija la consulta; guardar el tile la persiste. Ésta es la vía habitual — elija un cubo primero, o el botón sigue deshabilitado.
O apunte a algo existente, bajo Origen de la consulta:
- Consulta guardada — elija un archivo
.saikuexistente y el tile se dibuja en vivo desde él. El servidor carga la consulta guardada, fusiona los filtros de dashboard aplicables y la re-ejecuta en cada refresco — así que una consulta guardada puede respaldar tiles en varias Apps y todos siguen cuando la cambia. - JSON en línea — vea abajo.
JSON en línea toma un cuerpo AiQueryRequest directamente. Recurra
a él cuando quiera una forma de consulta que el constructor no ofrece —
una jerarquía concreta cuando dos comparten nombre de nivel, digamos — o
al copiar una consulta entre tiles.
Una jerarquía no puede estar en un eje y en los filtros
Ponga Time / Time / Month en Filas y luego intente filtrar por
Time / Time / Year, y la consulta se rechaza:
Hierarchy ‘Time’ is already on the rows/columns axis. Mondrian rejects the same hierarchy on two independent axes. Either move the filter members onto the axis selection’s
members[], or filter on a different hierarchy/dimension.
Ésta es una regla del motor OLAP subyacente, no una limitación de Saiku.
Para acotar un eje a parte de una jerarquía, nombre los miembros en el
propio eje en lugar de filtrar aparte — en JSON en línea eso es el
array members[] de la fila:
"rows": [{ "dimension": "Time", "hierarchy": "Time", "level": "Month", "members": ["[Time].[Time].[1998].[Q1].[January]", "…"]}]La misma técnica es la salida de emergencia cuando los miembros de un nivel vuelven en un orden que no quiere: listarlos explícitamente fija la secuencia, ya que Ordenar categorías del tile de gráfico ordena por valor de medida, no por categoría. La App de referencia FoodMart Ops usa exactamente esto para fijar su gráfico de tendencia a ocho semanas nombradas.
Comparaciones de KPI
El texto de delta de un KPI — el «+6.7% vs last month» bajo el número — se deriva del propio nivel de tiempo del tile, así que siempre describe la comparación que el tile hizo de verdad. Consulte a granularidad de mes y dice «vs last month»; a granularidad de semana, «vs last week».
Fije primero el nivel de tiempo
Ese nivel de tiempo es algo que usted elige, no algo que el tile infiera — y hasta que lo fije, una comparación no tiene contra qué comparar.
Cerca del fondo del editor de KPI, bajo Nivel de tiempo (para comparación + sparkline), elija Dimensión, Jerarquía y Nivel (p. ej. Time / Time / Month). Entonces:
- la comparación tiene un periodo previo contra el que medir, y
- la casilla Sparkline queda disponible — traza la medida a lo largo de ese nivel.
Puede sobrescribir la redacción con Etiqueta de delta cuando un cubo tiene su propio vocabulario («vs last trading day»), pero el valor por defecto ya no puede contradecir a los datos.
Periodos finales incompletos
El cubo más nuevo de una serie temporal a menudo se está llenando aún — la semana o el mes en curso — o es un límite de datos donde el último periodo tiene un par de días. Medido contra un periodo previo completo produce un número que describe el calendario en vez del negocio: un −84 % que significa que no cambió nada salvo la fecha.
Fije Periodos finales incompletos para decirle al tile cuántos de los periodos más nuevos siguen siendo parciales. Esos periodos:
- conservan sus valores reales — no se oculta nada, y la sparkline sigue trazando todos los puntos
- se etiquetan «Week 52 · partial» bajo el número
- no muestran porcentaje frente a ellos, porque no hay uno honesto que mostrar
Guardar
Guarde la App desde el editor. Se persiste como documento .saikuapp en
el repositorio, en la carpeta que eligió al crearla. Vuelva a abrirla
cuando quiera desde la lista de Apps, o
incrústela en otro sitio — vea Incrustar una
App.
Relacionado
- Visión general de App Builder — qué es una App y en qué se diferencia de un dashboard.
- Tiles personalizados — renderizadores declarativos de ECharts y grafos más allá de los cinco integrados.
- Analyze — construya y guarde las consultas que sus tiles reutilizan.