DATTA BI — Filtro cruzado
Responder "e se eu olhar só para esta categoria?" costumava exigir reconstruir o dashboard com outro filtro. Com o filtro cruzado basta um clique: ao clicar numa categoria de um visual, todos os outros visuais do mesmo dashboard se filtram na hora por aquele valor — a análise inteira acompanha o seu foco, e um segundo clique desfaz tudo.
Como funciona
- Um clique numa barra, fatia, ponto ou marcador propaga o filtro para todo o dashboard.
- Clicar de novo no mesmo elemento remove o filtro — é um liga/desliga.
- No visual clicado: o elemento selecionado mantém a cor cheia; os demais ficam esmaecidos (opacidade 0,25). Na pizza, a fatia ativa ainda se destaca, expandida em 6 px.
- Nos demais visuais: todos re-renderizam já filtrados, com o valor clicado aplicado por cima dos filtros salvos do dashboard.
- Para limpar tudo de uma vez: o botão Limpar filtro na barra superior do dashboard.
Visuais que emitem filtro cruzado
- Barras, barras horizontais e colunas (
bar,bar-horizontal,column) - Linha e área (
line,area) - Pizza e donut (
pie,donut) - Dispersão e bubble (
scatter,bubble) - Heatmap e treemap (
heatmap,treemap) - Mapas (
map,map-google) — clique num marcador - Grafo (
graph) — clique num nó
Não emitem, por design: KPI e gauge, que não têm categoria clicável, e tabela, que já traz o próprio filtro de coluna.
Filtro cruzado × drill-down
| Aspecto | Filtro cruzado | Drill-down |
|---|---|---|
| Gatilho | Clique simples | Duplo clique |
| Escopo | Todos os visuais do dashboard | Apenas o visual clicado |
| Muda a granularidade | Não | Sim — desce na hierarquia do eixo |
| O que é re-renderizado | O dashboard inteiro | Só o visual clicado |
| Estado guardado | Um filtro global do dashboard (campo + valor, ou nenhum) | Um nível de detalhe por visual |
Os dois são independentes: você pode manter um filtro cruzado ativo e, ao mesmo tempo, aprofundar um visual específico com drill-down.
Exemplo prático — investigando um pico de casos
- Num dashboard com "Casos por UF" (barras), "Evolução mensal" (linha) e "Distribuição por classe" (pizza), clique na barra SP.
- A linha e a pizza re-renderizam mostrando apenas São Paulo — o pico de março fica evidente na linha.
- Clique na fatia da classe com maior participação: agora o dashboard mostra só aquela classe em SP.
- Clique novamente nos mesmos elementos para desfazer os filtros, ou use Limpar filtro para voltar à visão geral de uma vez.
Como o filtro é aplicado por baixo
- O estado do filtro cruzado é único por dashboard: um par campo + valor, ou nenhum filtro ativo.
- Cada tipo de visual recebe o filtro ativo e devolve o filtro que o clique produziu. É esse ida e volta que permite ligar e desligar pelo mesmo elemento.
- O esmaecimento e o cursor de "clicável" só aparecem nos visuais que de fato emitem filtro cruzado — quem não emite não sugere que emite.
- No servidor, o valor clicado chega como uma sobreposição e é mesclado aos filtros já salvos no dashboard. Quando o campo clicado não corresponde a nenhum filtro persistido, a plataforma cria na hora um filtro de texto equivalente, para que o valor seja aplicado do mesmo jeito. A plataforma expõe endpoints de re-renderização do dashboard (filtro cruzado) e de um visual com drill — veja a referência de API.
Limitações
- Visuais baseados em script DATTAX escrito à mão só recebem o filtro se o script referenciar o filtro pelo nome (
@<nomeDoFiltro>). Visuais montados pelos canais de colunas — dataset + vínculo de campos — recebem o filtro automaticamente. - Heatmap e sankey emitem o filtro apenas pelo eixo X / origem do fluxo.
- Cada filtro cruzado re-renderiza o dashboard inteiro. O cache da plataforma amortiza repetições do mesmo filtro, mas em dashboards muito grandes prefira hierarquias com drill-down para explorar detalhes.