Tema
Cruzamento entre widgets
Clicar num gráfico filtra outro widget do mesmo ecrã, e os dois ficam à vista. É o mecanismo de exploração: "e no Norte, como é que isto se distribui?"

Não confundir com o detalhe
| Cruzamento | Detalhe (drill) | |
|---|---|---|
| O que acontece | Outro widget do mesmo ecrã re-filtra | Abre um ecrã por cima |
| Os dois ficam à vista | Sim | Não, o detalhe cobre |
| Como se configura | Uma condição na consulta do widget que segue | Nas propriedades do widget que dispara |
| Para que serve | Explorar sem sair | Ver tudo sobre uma linha |
Ver Drill para o detalhe.
Como se configura
O cruzamento define-se no widget que segue, não no que é clicado: é uma condição na consulta desse widget, cujo valor vem da selecção activa noutro.
Lojas.loja eq {selecção do widget w_barras, campo loja}Ainda não há editor para isto no construtor
A secção Condições do construtor visual aceita valores fixos e a opção do período mais recente. A origem selecção existe no formato do ecrã, mas ainda não tem seletor na interface.
Hoje configura-se por um de dois caminhos:
- o editor de código do documento do ecrã, pelo ícone
</>no editor visual; - um assistente ligado por MCP, pedindo-lhe que ligue os dois widgets.
No modo Entidade única — o outro modo de fonte de dados, sem junções nem agregados — o editor de origens existe e a selecção escolhe-se em seletores.
Feito isso, clicar numa barra faz a consulta do gráfico que segue recorrer com o valor dessa barra.
Sem selecção, mostra tudo
Uma condição ligada a uma selecção vazia não é aplicada. O widget mostra o panorama completo.
É um comportamento deliberado: um ecrã acabado de abrir mostra tudo, e só restringe depois de alguém clicar. A alternativa — widgets vazios à espera de um clique — seria pior.
Limpar a selecção
Clicar fora limpa. Também se pode limpar por código, com keplin.ui.clearDrilldown() num botão — ver Eventos e código.
A limpeza afecta apenas as selecções de cruzamento; nunca toca nos filtros do dashboard nem nas condições configuradas nas consultas.
De que widgets se pode seleccionar
Qualquer widget que mostre linhas ou pontos:
- gráfico — o ponto ou barra clicado;
- tabela — a linha clicada;
- lista e cartões — o registo clicado.
O campo indicado na condição tem de existir no conjunto de dados do widget de origem. Se o gráfico de barras agrupa por loja, é loja que a selecção oferece.
Vários widgets a seguir o mesmo
Nada impede que três widgets tenham condições ligadas à mesma selecção. Clicar numa barra actualiza os três de uma vez.
É a forma habitual de montar um ecrã de exploração: um gráfico geral em cima, e por baixo dois ou três widgets que respondem ao que estiver seleccionado.
Encadear
Um widget que segue a selecção de outro pode ele próprio ser fonte de selecção para um terceiro. Região → loja → produto, tudo no mesmo ecrã.
Dois níveis funcionam bem. Três começam a ser difíceis de perceber sem uma explicação escrita no ecrã — que vale a pena acrescentar num widget de Markdown.
Diga às pessoas que podem clicar
A interactividade não é visível. Uma linha de texto — "clique numa barra para ver o detalhe dessa loja" — é a diferença entre um dashboard interactivo e um dashboard que parece estático.