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 num elemento de qualquer gráfico (barra, ponto da linha, fatia, célula da tabela, marcador do mapa...) propaga o filtro para todo o dashboard.
- Clicar de novo no mesmo elemento remove o filtro — é um liga/desliga.
- No visual clicado: o elemento escolhido fica cheio e os demais esmaecem.
- Nos demais visuais: re-renderizam já filtrados pelo valor clicado, por cima dos filtros salvos do dashboard — em cada visual que tem a coluna clicada. O visual clicado não se filtra: ele só destaca o elemento escolhido.
- Barra superior: o selo Filtro: mostra a coluna e o valor aplicados (por exemplo
uf = SP), com o ✕ para limpar — também no painel aberto só para visualização. - Visual com drill-down: num visual que desce por duplo clique, o clique simples espera um quarto de segundo antes de filtrar, para não ser confundido com o primeiro clique de um duplo clique. Nos demais, filtra na hora.
- Para limpar tudo de uma vez: o botão Limpar filtro na barra superior do dashboard.
Visuais que emitem filtro cruzado
| Visual | O clique filtra por |
|---|---|
| Barras e colunas (todas as variantes, com ou sem legenda) | a categoria do eixo |
| Linha e área | a categoria do eixo: vale o clique em qualquer altura da coluna, não só no ponto (a área não tem marcador) |
| Pizza, rosca, treemap e funil | a categoria da fatia/bloco |
| Dispersão | a legenda do ponto; sem legenda, o valor do eixo X |
| Heatmap | a coluna (eixo X) da célula |
| Sankey | o nó clicado (origem ou destino); na ligação, a origem |
| Tabela | a coluna e o valor da célula clicada; se a coluna é uma medida agregada, a primeira coluna de categoria da linha |
| Mapa | o rótulo do marcador |
| Grafo | o nó clicado: no grafo de Origem/Destino, a coluna em que ele aparece; no grafo exportado do chat, a coluna da tabela com o nome do nó (sem ela, o clique só abre o detalhe). O clique continua abrindo o detalhe do nó, espera um quarto de segundo e o duplo clique segue expandindo os relacionamentos, sem filtrar |
| Cascata | a categoria do degrau |
| Radar | a categoria do polígono (a linha que ele desenha) |
| Box plot | a categoria da caixa |
| Candlestick | a data da vela |
| Calendário | o dia, como a linha do visual o traz |
Não emitem o clique: KPI, card e gauge (não têm categoria) e histograma (cada barra é uma faixa de valores, e o filtro cruzado é de igualdade). Eles recebem o filtro normalmente; para filtrar a partir de uma dimensão que só aparece neles, use um slicer ou o painel Filtros.
Tooltip
O well Tooltip (barras, linha, área, pizza, rosca, treemap, funil, dispersão, heatmap, sankey e mapa) acrescenta colunas ao que aparece ao passar o mouse. Quando o visual agrega os valores, cada campo usa a agregação escolhida na engrenagem do chip — por padrão, a mesma dos valores; texto, data e booleano entram com Contagem distinta. Quando o visual não agrega (a dispersão, por exemplo), o campo mostra o valor da própria linha. São no máximo 10 campos por visual.
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 "Casos por classe" (barras horizontais), clique na barra SP.
- A linha e as barras por classe re-renderizam mostrando apenas São Paulo — o pico de março fica evidente na linha.
- Clique na barra da classe com mais casos: o filtro passa a ser essa classe (o filtro cruzado guarda um valor por vez) e o dashboard mostra os casos dela em todas as UFs.
- Clique novamente na mesma barra para desfazer o filtro, ou use Limpar filtro para voltar à visão geral de uma vez.
Interações entre visuais
No modo de edição, Editar interações define, para cada par de visuais, o que um clique no visual de origem faz com o visual de destino:
| Interação | O que acontece no visual de destino |
|---|---|
| Filtrar (padrão) | Re-renderiza só com as linhas do valor clicado. |
| Destacar | Não filtra: mostra todas as linhas, realça as que têm o valor clicado e esmaece as outras — quando o visual de destino mostra a mesma coluna. |
| Sem interação | Ignora o clique. |
Slicers (busca, lista e data) não têm visual de origem: o valor deles filtra todos os visuais que têm a coluna.
Filtro cruzado e os filtros salvos
O clique soma com os filtros gravados no painel Filtros:
- Filtros em todas as páginas valem no dashboard inteiro.
- Filtros nesta página valem na página aberta. Num dashboard com páginas, cada página guarda os seus; sem páginas, o canvas é a página.
- Filtros neste visual valem só no visual selecionado.
Salvar um filtro no painel, ou mudar o valor de um filtro da barra superior, re-renderiza o dashboard na hora. Uma linha recém-adicionada, ainda sem coluna ou sem valor, não filtra nada.
Os filtros da barra superior (variáveis do dashboard) também filtram: num visual montado por campos, o filtro cujo nome é uma coluna do dataset entra na consulta como os filtros do painel (o filtro uf filtra a coluna uf; uma lista vira "está em"). Filtro cujo nome não é coluna do dataset não muda aquele visual, sem aviso — ele existe para outro visual. Nos visuais com consulta própria, o filtro chega como a variável @nome, e vale onde a consulta a lê.
Como o filtro é aplicado por baixo
- O estado do filtro cruzado é único por dashboard: o visual clicado, a coluna e o valor — ou nenhum filtro ativo.
- O filtro vira uma condição na consulta de cada visual, e não um ajuste de tela: o total, as barras e a tabela chegam já calculados só com as linhas do valor. Nos visuais montados por canais (dataset + colunas nos eixos), a condição entra antes do agrupamento — somas e contagens refletem o filtro. Nos visuais com consulta própria (DATTA Query escrita à mão, painel exportado do chat), ela entra sobre as linhas que a consulta devolve.
- O filtro só entra onde a coluna existe. Um visual que não tem a coluna clicada continua mostrando os seus dados e exibe o aviso "O filtro … não se aplica a este visual: ele não tem a coluna …" — nunca fica vazio por causa do filtro.
- O visual clicado recebe de volta o destaque do elemento; os demais só realçam um valor quando a interação é Destacar. O realce é desenhado em todos os visuais que emitem o clique (tabela e mapa inclusive).
- 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
- Total calculado dentro da própria consulta: um visual cuja consulta já devolve só o agregado (por exemplo o cartão Total de registros do painel exportado do chat, que conta dentro da consulta) não tem a coluna clicada e não é filtrado — mostra o aviso.
- Visual com consulta própria e limite de linhas: a condição vale sobre as linhas que a consulta devolveu; se a consulta corta em N linhas, o filtro escolhe entre essas N.
- Visual sem a coluna: o filtro chega pelo relacionamento do Modelo quando há um ativo até um dataset que tem a coluna (acima de 1.000 chaves, ou com dois caminhos possíveis, ele não se aplica e o visual avisa). Sem relacionamento, o visual mostra o aviso de coluna ausente. Veja Relacionamentos.
- Destacar realça o valor, mas não desenha a "parte do todo" (a fração filtrada sobre o total).
- Um valor por vez: o clique guarda uma coluna e um valor; num gráfico com legenda, o clique filtra pela categoria do eixo, não pelo par categoria + série.
- Cada filtro cruzado re-renderiza o dashboard inteiro. O cache da plataforma amortiza repetições do mesmo filtro.