Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-10-04

Filtros e interacciones

Filtros del panel, filtro cruzado entre visuales y lo que pasa al hacer clic en un dato.

En esta página (8)

Hallazgo central: todo filtro/segmentador es del lado del cliente sobre el snapshot — nunca se convierte en SQL. Eso tiene tres consecuencias buenas: costo cero por interacción, ninguna superficie de inyección a través del segmentador, y el límite pasa a ser lo que está en el snapshot. Los ejemplos usan el workspace sintético Comércio Aurora Ltda.


Segmentadores (8 tipos) y ámbitos#

  1. Qué es — 8 tipos de segmentador: select, daterange, buttons, range, hier (encadenado), number ("y si"), field (campo-parámetro) y measure.
  2. Cuándo usarlo — recortar el panel por categoría, período, rango; o cambiar campo/medida (field/measure) y simular un número (number/what-if).
  3. Cómo funciona — cada segmentador tiene un ámbito: dashboard, página o por visual (destino); búsqueda en el filtro (≥20 opciones), selección múltiple (OR/AND), seleccionar todo/limpiar. Sincronización entre páginas (syncPages): un control en una página vale en todo el panel.
  4. Requisitos previos — snapshot con las columnas que usa el segmentador.
  5. Cómo validar — agrega un select de produtos.categoria en el ámbito del dashboard, selecciona "Bebidas" y confirma que todos los visuales se recortan; cambia el ámbito a un solo visual y confirma el aviso cuando "no alcanza nada".
  6. Límites y salvedades — el filtro personal por usuario (segmentador personal) está en Roadmap; lo que existe por usuario es la RLS (consulta Seguridad). Los segmentadores operan sobre el snapshot, no sobre la base en vivo.
  7. Datos de ejemplo (sintéticos) — categorías {Bebidas, Limpeza, Higiene}; seleccionar "Bebidas" deja solo ingresos=250.
  8. Evidencia (código/prueba) — DASH_FILTER_TYPES en dashboard-widgets.ts; renders en dashboard-filters.tsx; pruebas de segmentadores.

Fechas relativas#

  1. Qué es — presets de período: hoy, 7d, 30d, mes, año, y el genérico -Nd/-Nw/-Nm/-Ny (estilo Power BI), en la zona horaria del panel.
  2. Cuándo usarlo — unos "últimos 30 días" que avanzan solos cada día.
  3. Cómo funciona — presetRange calcula la ventana en la zona horaria configurada del panel.
  4. Requisitos previos — una columna de fecha en el snapshot.
  5. Cómo validar — configura "últimos 30 días" y confirma que el intervalo se desplaza al cambiar la fecha de referencia.
  6. Límites y salvedades — depende de la zona horaria del panel (America/Sao_Paulo por defecto).
  7. Datos de ejemplo (sintéticos) — hoy=2026-07-31 → ventana 2026-07-02..07-31.
  8. Evidencia (código/prueba) — presetRange (dashboard-widgets.ts) + prueba.

Filtro cruzado / resaltado cruzado y editor de interacciones#

  1. Qué es — hacer clic en un visual resalta la selección y recorta los demás; y un editor de interacciones origen→destino para definir, por par de visuales, si la acción es Filtrar / Resaltar / Ignorar.
  2. Cuándo usarlo — el gesto que "se parece a Power BI": hacer clic en una barra y ver reaccionar el resto del panel.
  3. Cómo funciona — el clic aplica el filtro cruzado (Ctrl acumula; volver a hacer clic limpia); el editor de pares define el modo por destino, heredando el modo global ("predeterminado") y con vista previa en memoria antes de guardar; saneamiento con allowlist (modos válidos, ids existentes, sin autorreferencia, tope de pares). La misma semántica vale en el visor autenticado, en el público y en el embed.
  4. Requisitos previos — dos o más visuales en la página.
  5. Cómo validar — en el editor de interacciones, define "Barras de categoría → Tabla = Filtrar"; haz clic en una barra y confirma que la tabla se recorta; cambia a "Ignorar" y confirma que la tabla no reacciona.
  6. Límites y salvedades — la persistencia de la selección entre sesiones es parcial (ver abajo).
  7. Datos de ejemplo (sintéticos) — hacer clic en "Bebidas" en las barras filtra la tabla a los ítems de Bebidas.
  8. Evidencia (código/prueba) — interactions-editor.tsx, interactions-sanitize.ts + prueba; applyCrossFilter (dashboard-widgets.ts); dashboard-view.tsx.

Drill-down / drill-up#

  1. Qué es — bajar/subir niveles por jerarquía de columnas y por fechas (año → mes → día).
  2. Cuándo usarlo — explorar de "Región" hasta "Ciudad", o de año hasta día.
  3. Cómo funciona — config.drill sobre la jerarquía; etiquetas de contexto + botón de drill-up; las fechas usan dateBucket.
  4. Requisitos previos — jerarquía definida en el modelo (consulta Modelo semántico).
  5. Cómo validar — en un visual con la jerarquía Região > UF > Cidade, haz clic para bajar de Sudeste a São Paulo y usa drill-up para volver.
  6. Límites y salvedades — el drill opera sobre el snapshot del visual.
  7. Datos de ejemplo (sintéticos) — Sudeste → SP → São Paulo.
  8. Evidencia (código/prueba) — config.drill (dashboard-widgets.ts), dashboard-filters.tsx.

Drill-through entre páginas#

  1. Qué es — saltar a otra página llevando el contexto (por columna), automático al hacer clic o mediante un botón, con una etiqueta "volver".
  2. Cuándo usarlo — hacer clic en un producto e ir a la página de detalle de ese producto.
  3. Cómo funciona — DashPageTab.drillthrough define la columna clave; el destino nace filtrado por el valor en el que se hizo clic.
  4. Requisitos previos — página de destino configurada como objetivo de drill-through.
  5. Cómo validar — configura "Detalle del producto" como destino por produtos.id; haz clic en un producto en la visión general y confirma que la página de detalle ya está filtrada.
  6. Límites y salvedades — el contexto se pasa por la columna configurada.
  7. Datos de ejemplo (sintéticos) — hacer clic en el producto id=10 abre "Detalle" con produto_id=10.
  8. Evidencia (código/prueba) — DashPageTab.drillthrough, dashboard-filters.tsx.

Tooltips y páginas de tooltip (tooltip pages)#

  1. Qué es — tooltips con campos extra, tooltip enriquecido (contenido más allá del número) y páginas de tooltip (una página entera del panel como tooltip, estilo Power BI).
  2. Cuándo usarlo — mostrar detalles al pasar el mouse sin saturar el visual.
  3. Cómo funciona — config.tooltipFields/tooltipPage; la página de tooltip queda oculta de la barra y aparece al pasar el mouse sobre el punto.
  4. Requisitos previos — campos extra y/o una página marcada como tooltip.
  5. Cómo validar — agrega produtos.marca como campo de tooltip y confirma que aparece al pasar el mouse; crea una tooltip page y confirma la vista previa.
  6. Límites y salvedades — el tooltip enriquecido es contenido estructurado; el motor de datos es el mismo del visual de origen.
  7. Datos de ejemplo (sintéticos) — tooltip de "Ingresos por categoría" mostrando marca y n.º de pedidos.
  8. Evidencia (código/prueba) — dashboard-tooltip.ts (+15 pruebas), tooltip-rich.ts + prueba.

Marcadores (bookmarks)#

  1. Qué es — hasta 10 marcadores que guardan el estado completo del panel, aplicables mediante un botón.
  2. Cuándo usarlo — guardar la "vista ejecutiva" y la "vista detallada" y alternar con un clic.
  3. Cómo funciona — el marcador guarda selecciones/filtros/estado; un botón puede aplicarlo.
  4. Requisitos previos — un estado configurado para guardar.
  5. Cómo validar — configura filtros, guárdalos como marcador "Julio", cambia todo y aplica el marcador para restaurar.
  6. Límites y salvedades — los marcadores son del dashboard, no por usuario.
  7. Datos de ejemplo (sintéticos) — marcador "Bebidas · Julio".
  8. Evidencia (código/prueba) — saveBookmarksAction, dashboard-filters.tsx.

Persistencia y compartir selecciones por URL#

  1. Qué es — la selección viaja en la URL (?f=, base64url) para compartir una vista filtrada.
  2. Cuándo usarlo — enviar un enlace ya filtrado a un colega.
  3. Cómo funciona — la URL guarda selección + fecha; los parámetros (field/measure/what-if) también viajan por el códec de estado.
  4. Requisitos previos — filtros/parámetros aplicados.
  5. Cómo validar — filtra "Bebidas", copia la URL, ábrela en otra pestaña y confirma el filtro restaurado.
  6. Límites y salvedades — rango/jerarquía no sobreviven solo con la URL (dependen de un marcador); no hay autoguardado por usuario.
  7. Datos de ejemplo (sintéticos) — ?f=… con categoría=Bebidas, período=Julio.
  8. Evidencia (código/prueba) — dashboard-filters.tsx (?f=), url-state.ts.

Enlaces relacionados