Filtros

Tipo

Conceito

Para

Analista

Na tela

DataViz › Aplicação › Editar

Uma Aplicação tem quatro filtros, configurados em quatro lugares. Eles tiram linhas antes da conta, e todos os Widgets que leem as mesmas linhas mudam juntos. Saber qual filtro está agindo explica quase todo "mudei o filtro e esse número não mexeu".

Filtro	Onde se configura	Nome na tela	Vale para	O leitor vê e muda?
Da tabela	Aba Tabelas, ao selecionar a tabela	Filtros Pré Aplicados	Toda consulta que usa a tabela	Não
Do Widget	Configurador do Widget, aba Dados	Filtros (Filtros Pré Aplicados no Widget Svelte)	Só aquele Widget	Não
De abertura	Aba Geral do editor da Aplicação, sub-aba Dashboards	Filtros Padrões ou Filtros de inicialização desta aba	O Dashboard inteiro, quando abre	Vê na barra e troca o valor
Do usuário	A barra de filtros, ou um clique no gráfico	Adicionar Filtro	O Dashboard inteiro	É dele: põe e tira

A restrição de linha, que limita o que cada usuário pode ver, é outro mecanismo e fica fora desta página: veja Acesso a dados.

Filtro da tabela

É um recorte fixo do dado, como "só produtos do tipo Combustível" ou "só clientes ativos". Vale em todo Widget e em todo relatório do Explorer, e o leitor não sabe que ele existe.

Ponha na dimensão. Um filtro na dimensão desce para todas as fatos ligadas a ela. Um filtro numa tabela fato só entra quando a consulta usa alguma coluna daquela fato; um Widget que lista só as empresas ignora o filtro posto em Faturamento. A regra de passagem está em Modelo de dados, e o passo a passo, em Tabelas e relacionamentos.

Filtro do Widget

É o recorte de um Widget só: o KPI que mostra sempre o ano corrente enquanto o resto da tela segue o período escolhido. Os outros Widgets não são afetados.

No mesmo campo, o filtro do Widget vence. Se o KPI tem um filtro de data próprio, o filtro de data que o leitor escolhe na barra não chega a ele. É a causa mais comum de "mudei o período e o KPI não mexeu": antes de suspeitar do dado, abra o configurador do Widget e veja se há filtro de data lá dentro.

Para somar os dois em vez de trocar, marque Combinar com filtros do dashboard no filtro do Widget. Aí os dois valem juntos (E): o Widget mostra só o que passa pelo filtro dele e pelo da barra.

Filtro de abertura

São os filtros com que o Dashboard abre, como "Ano = Ano Atual". Ficam na aba Geral do editor da Aplicação, sub-aba Dashboards, em Modo de filtros:

Modo	Onde se configura a lista	Efeito
Um conjunto para toda a aplicação	Filtros Padrões, logo abaixo do modo	A mesma lista em todos os Dashboards. Trocar de aba não muda nada
Um conjunto por dashboard	Filtros de inicialização desta aba, no cartão de cada Dashboard, na mesma sub-aba	Cada aba tem a sua lista. A lista da Aplicação fica guardada e volta a valer se você voltar ao outro modo

Cada filtro da lista vem com valor (Data = Hoje) ou vazio (o campo aparece na barra esperando o leitor escolher). No modo por dashboard, isso decide o que acontece ao trocar de aba:

• Campo com valor é a identidade da aba: ela sempre abre com esse valor, mesmo que o leitor estivesse vendo outro na aba anterior.
• Campo vazio herda o valor que o leitor tinha na aba anterior. Declare o mesmo campo vazio em duas abas para a escolha acompanhar a navegação. Isso vale também para limpar.
• Campo que a aba não declara fica para trás.

As abas não guardam memória: voltar a uma aba reaplica a lista dela.

Cada filtro tem uma Obrigatoriedade do filtro:

Opção	Efeito
Padrão (opcional)	O leitor pode deixar sem valor
Opcional (valor único)	Pode ficar vazio, mas aceita um valor por vez
Obrigatório (um ou mais valores)	O Dashboard só mostra dados depois que o leitor preenche. A tela pede "Selecione os filtros obrigatórios"
Obrigatório (valor único)	Igual, com um valor por vez

Permitir que o usuário edite a lista de filtros decide se o leitor sai da lista. Desligado, ele fica restrito aos campos da lista: não adiciona, não remove nem limpa filtros, inclusive ao clicar num gráfico.

Filtro do usuário

É o filtro que o leitor põe na barra ou ao clicar numa barra, fatia ou ponto de um gráfico. Vale para todos os Widgets do Dashboard, salvo os que têm filtro próprio no mesmo campo. Como o leitor usa a barra está em Filtrar um Dashboard.

Um filtro que não tem caminho de ligação até a tabela de uma medida é ignorado para aquela medida. No Explorer, a coluna avisa ("O filtro Turno não se aplica a Valor Total de Vendas e foi ignorado nesta coluna."); num Widget, o número não muda e nada avisa. Por isso, ofereça como filtro só as dimensões que todas as fatos alcançam.

Filtros que não são da Aplicação

Dois outros lugares usam a palavra filtro com outro sentido. O filtro de um Indicador é parte da definição do número; veja Indicadores. Os Filtros Padrões de uma Dimensão Dinâmica escolhem quais atributos viram coluna; veja Configurações da Aplicação.

Onde isso aparece

• Filtro da tabela: Tabelas e relacionamentos
• Filtro de abertura e datas: Calendário e filtros por data
• O que o leitor faz na barra: Filtrar um Dashboard

Pelo Lumo CLI

Os filtros de abertura (filtros, filter_mode) e os filtros de tabela e de Widget também se versionam em YAML. Veja a referência de app e a de app-dashboard.