Como adicionar e editar filtros de painéis definidos pelo usuário

Esta página é sobre filtros de painel padrão. Para saber mais sobre os filtros cruzados de painéis, acesse a página de documentação Painéis com filtros cruzados.

Noções básicas sobre filtros de painel

Os filtros de dashboard permitem que um leitor limite os resultados de um dashboard apenas aos dados do interesse dele. Os filtros de dashboard podem ser aplicados a todos os blocos de um dashboard ou a apenas um bloco.

Ao visualizar um painel, um usuário pode atualizar temporariamente os valores do filtro do painel, o que não afeta outros usuários. Isso é diferente dos filtros que fazem parte de uma consulta subjacente a um bloco do dashboard. Os leitores não podem mudar esses filtros, a menos que tenham permissão para editar o bloco ou para Analisar a partir daqui.

Para fazer mudanças permanentes nos filtros que todos os usuários vão ver ou para adicionar ou excluir filtros, você precisa ter o nível de acesso Gerenciar acesso, Editar para o painel e estar no modo de edição.

Comportamento de substituição do filtro do painel

Os filtros em um painel podem ser aplicados em diferentes níveis. Quando vários filtros afetam o mesmo campo, o Looker determina a precedência de acordo com a seguinte hierarquia (da maior para a menor):

1. Filtros cruzados (maior precedência): criados quando os leitores interagem com pontos de dados em blocos de painel com filtro cruzado ativado.
2. Filtros no nível da visualização: colocados diretamente em um bloco de visualização específico.
3. Filtros no nível do painel: aplicados no nível do painel em um ou mais blocos.
4. Filtros no nível da consulta (menor precedência): configurados na consulta subjacente do bloco (Análise ou Look).

O comportamento de substituição entre esses filtros é determinado da seguinte maneira:

• Substituição do mesmo campo:
  • Quando um filtro no nível da visualização e um filtro no nível do painel são aplicados ao mesmo campo, o filtro no nível da visualização substitui o filtro no nível do painel para esse bloco. Somente o valor do filtro no nível da visualização é aplicado a esse bloco.
  • Quando um filtro no nível do dashboard ou da visualização é aplicado ao mesmo campo que um filtro na consulta subjacente do bloco, o filtro no nível do dashboard ou da visualização substitui o filtro da consulta. Somente o valor do filtro de nível mais alto é exibido e aplicado.
  • Os filtros cruzados substituem os filtros no nível da visualização, do painel e da consulta no mesmo campo.
• Expressões personalizadas: se a consulta subjacente usar uma expressão personalizada, os filtros de nível mais alto não vão substituir os campos no filtro de expressão personalizada, independentemente das colunas que estão sendo referenciadas. Nesse caso, os filtros de nível superior e de consulta são exibidos e aplicados.
• Filtros complexos (condições OR): se o agrupamento de filtros da consulta subjacente tiver pelo menos uma condição OR, o filtro será tratado como complexo, e os filtros de nível superior não vão substituir nenhum campo referenciado nesse filtro de consulta. Os dois filtros são mostrados e aplicados.

Em resumo, um filtro na consulta subjacente é tratado como um filtro personalizado que os filtros de nível superior nunca vão substituir se uma das seguintes condições for verdadeira:

• O agrupamento AND/OR mais interno contém pelo menos uma condição OR.
• O filtro contém uma expressão personalizada.

Filtros de painel e LookML

Se um modelo, uma Análise ou um campo usar o parâmetro label (modelo), label (Análise) ou label (campo), respectivamente, para mudar o nome no menu Análise ou no seletor de campos, o nome fornecido no parâmetro label será usado na janela Adicionar filtro.

Se você é desenvolvedor do LookML e está no Modo de Desenvolvimento, é possível criar um filtro de dashboard em um campo que aparece apenas na sua versão do Modo de Desenvolvimento de um modelo, mas o filtro não vai funcionar como esperado quando você sair do Modo de Desenvolvimento ou quando o filtro for usado por outros usuários. Da mesma forma, se um campo de filtro for excluído ou renomeado após a criação do filtro, ele não vai funcionar como esperado.

Como adicionar filtros de painel

Para começar, verifique se o dashboard está no modo de edição e se você tem pelo menos um bloco de consulta ou um bloco vinculado ao Look. Selecione Filtros na barra de ferramentas na parte de cima e, em seguida, selecione Adicionar filtro.

Importante: se você editar um painel com guias, todos os filtros vão aparecer em todas as guias no modo de edição. Depois que você sair do modo de edição, um filtro só vai aparecer em uma guia se for aplicado a pelo menos um bloco nela.

Dica: para adicionar um filtro diretamente a um bloco de visualização individual em vez de em todo o dashboard, consulte a seção Filtros em blocos de visualização nesta página.

Uma janela Adicionar filtro será exibida em seguida.

Janela "Add Filter"

A janela Adicionar filtro aparece pré-preenchida com campos (dimensões ou medições) de todas as Análises usadas na criação dos blocos desse painel.

Por exemplo, a janela Adicionar filtro a seguir mostra as análises usadas nos blocos do dashboard: a análise Flights do modelo E Faa e a análise Order Items do modelo MB ecommerce_demo.

Selecione a seta ao lado de uma Análise para mostrar as visualizações dela. Cada visualização pode ser expandida para revelar os campos dela.

Para filtrar um campo de uma dessas Análises, use a caixa de diálogo Filtrar por para pesquisar campos ou insira manualmente o nome de um campo. Também é possível clicar no nome de um campo, como ID do pedido, para adicioná-lo à caixa de diálogo Filtrar por.

Se você selecionar um campo que já está sendo usado por outro filtro, o Looker vai alertar você. Embora ainda seja possível criar o filtro, não é possível aplicar vários filtros que usam o mesmo campo ao mesmo bloco do painel.

Se você quiser criar um filtro em um campo de uma Análise que não é usada no dashboard, consulte a seção Filtros avançados nesta página.

Dica: se você já tiver selecionado um campo na caixa de diálogo Filtrar por da janela Adicionar filtro, selecionar a chave Avançado não vai resultar em mudanças na janela Adicionar filtro, e um filtro avançado não será iniciado.

Depois de selecionar o campo que você quer filtrar, clique em Adicionar.

Filtros avançados

Com os filtros avançados, é possível criar filtros de painel usando campos que estão fora das Análises usadas para criar blocos no painel. Na janela Adicionar filtro, ative a opção Avançado para usar filtros avançados. Isso atualiza a janela Adicionar filtro com opções para selecionar um modelo, uma Análise e um campo para criar o filtro:

Primeiro, selecione um nome de modelo no menu suspenso Modelo. O menu suspenso contém todos os modelos do LookML que você pode acessar.

Depois que um modelo é selecionado, a caixa de diálogo Análise é preenchida com um menu suspenso de todas as Análises presentes no modelo selecionado.

Depois que o modelo e a Análise forem selecionados, os campos disponíveis nessa Análise vão preencher a janela Adicionar filtro. Use a barra de pesquisa para encontrar o campo que você quer filtrar ou selecione um nome de campo.

Depois de selecionar o campo que você quer filtrar, clique em Adicionar.

Como personalizar a configuração do filtro

Depois de selecionar um campo de filtro e clicar em Adicionar, a janela Adicionar filtro mostra várias configurações personalizáveis nas guias Configurações e Blocos para atualizar.

Observação: se o painel tiver guias, você poderá aplicar filtros aos blocos do painel que estão em guias diferentes na guia Blocos para atualizar. Consulte Aplicar filtros a blocos em guias diferentes na página Painel com guias para mais detalhes sobre como adicionar filtros a painéis com guias.

A guia Configurações

• Título: insira o título do filtro como você quer que ele apareça no painel. A opção de título é pré-preenchida com o nome do campo de filtro.
• Controle: selecione em uma lista de tipos de controle, que variam de acordo com o tipo de dados que você está filtrando. Consulte a seção Controles de filtro do painel nesta página para saber mais sobre os diferentes tipos de controles.
• Exibição: para controles que podem ser mostrados como inline ou popover, selecione como o filtro será exibido. Consulte a seção Como exibir filtros de painel nesta página para saber mais sobre as diferentes maneiras de exibir filtros. Se um controle puder ser exibido de apenas uma maneira, essa opção não vai aparecer.
• Valores: para definir opções de valor específicas para o filtro, escolha uma opção no menu suspenso ou insira as opções de valor nesse campo. Deixe em branco para que as opções de valor do banco de dados sejam mostradas, até o número máximo de valores disponíveis para esse controle. Para dados numéricos, esse campo é substituído pelos campos Mín. e Máx..
• Configurar valor padrão: se quiser, defina o valor padrão do filtro.
• Exigir um valor de filtro: clique em Opções adicionais para ver a opção Exigir um valor de filtro. Clique na caixa de seleção para exigir um valor para o filtro. Consulte a seção Exigir um valor de filtro nesta página para saber mais sobre como exigir valores de filtro.
• Selecione os filtros que você quer atualizar quando este filtro for alterado: clique em Opções adicionais para ver a opção Selecione os filtros que você quer atualizar quando este filtro for alterado. Clique na caixa de seleção para vincular outros filtros a este. Consulte a seção Configurar filtros vinculados nesta página para saber mais sobre eles. Se não houver outros filtros no painel, essa opção será desativada.
• Adicionar e Cancelar: clique em um desses botões para salvar ou cancelar o novo filtro.

A guia Blocos para atualizar permite determinar quais blocos vão usar o filtro.

Comportamento padrão da guia Blocos a serem atualizados

Observação: se o painel tiver guias, os blocos serão listados abaixo do nome da guia em que estão localizados.

Por padrão, o Looker aplica automaticamente o filtro a todos os blocos criados com base na mesma Análise do filtro e define o valor de Campo para filtrar como o mesmo campo escolhido para o filtro.

Se novos blocos forem adicionados ao painel após a criação do filtro, se tiverem sido criados na mesma Análise do filtro, o filtro do painel será aplicado automaticamente a esse bloco.

Observação: se os filtros do painel forem aplicados a um bloco de resultados combinados e a mesclagem mudar de alguma forma (por exemplo, se alguém reordenar as consultas de mesclagem ou adicionar ou remover consultas), todos os filtros do painel serão desativados para esse bloco. Para reaplicar os filtros, ative o bloco na guia Blocos a serem atualizados da janela Adicionar/editar filtros do painel.

Como fazer edições na guia Blocos a serem atualizados

Observação: se o painel tiver guias, os blocos serão organizados de acordo com o nome da guia em que estão localizados.

Se você quiser ajustar quais blocos ouvem qual filtro ou quais campos são afetados por filtros, as configurações a seguir estão disponíveis.

• Selecione Todos ou Nenhum para ativar ou desativar o filtro em todos os blocos.

  Dica: a partir do Looker 26.8, você pode usar as opções Todos ou Nenhum para ativar ou desativar globalmente um filtro para blocos no nível do dashboard ou, de forma mais granular, no nível da guia. Os blocos em uma guia que são de uma Análise diferente serão excluídos da opção Todos ou Nenhum.

• Na seção Campo para filtrar, escolha qual campo será afetado pelo filtro em cada bloco ou decida não aplicar o filtro a um bloco específico. Se o campo de um novo filtro já estiver sendo usado por um filtro preexistente, os blocos filtrados pelo filtro preexistente não estarão disponíveis para o novo filtro.

• Selecione Adicionar ou Cancelar para salvar ou cancelar as novas configurações de filtro.

Controles de filtro do painel

Com os controles de filtro do painel, você pode personalizar a aparência dos filtros para os leitores do painel. Os tipos de controle de filtro disponíveis no menu suspenso Controle ao criar um filtro de dashboard dependem do type de dados do LookML atribuído ao campo que você está filtrando.

Observação: para ver o tipo de dados de um campo que você está filtrando, é necessário ter a permissão see_lookml. Para ver o LookML do campo, selecione Acessar LookML no menu de engrenagem do campo no seletor de campo.

S = funciona com o tipo de dados string

N = funciona com o tipo de dados number e medições numéricas

T = funciona com o tipo de dados tier

ZC = funciona com o tipo de dados zipcode

YN = funciona com o tipo de dados yesno

DI = funciona com o tipo de dados distance

DU = funciona com o tipo de dados duration

DT = funciona com a maioria dos tipos de dados de data e hora ^*

L = funciona com o tipo de dados location

P = funciona com o parâmetro parameter

Controle	Descrição	Aparência	Tipos de dados
Seleção múltipla
Grupo de botões	Esse tipo de filtro é útil para oferecer aos espectadores um conjunto selecionado de opções limitadas. Até 30 opções podem ser selecionadas na configuração Valores. Para os tipos de dados string, tier e zipcode, se a configuração Valores for deixada em branco, os primeiros 30 valores do banco de dados serão mostrados. Um botão fica colorido quando é selecionado.		S N T ZC YN DI DU
Caixas de seleção	Como um grupo de botões, mas com um design um pouco diferente, esse tipo de filtro é útil para oferecer aos leitores um conjunto selecionado de opções limitadas. Até 50 opções podem ser selecionadas na configuração Valores. Para os tipos de dados string, tier e zipcode, se a configuração Valores for deixada em branco, os primeiros 50 valores do banco de dados serão mostrados.		S N T ZC YN DI DU
Lista de tags	Uma combinação de filtros de menu suspenso e caixa de seleção. As opções do menu suspenso podem ser selecionadas na configuração Valores. Para os tipos de dados string, tier e zipcode, todos os valores podem ser mostrados no banco de dados se a configuração Valores for deixada em branco. Para abrir o menu de valores, os leitores podem clicar no campo de filtro ou na divisa. Os usuários podem selecionar ou desmarcar valores individuais clicando na caixa de seleção de um valor. Os usuários também podem clicar no ícone X ao lado de um valor de filtro para desmarcá-lo. Os usuários podem selecionar todos os valores disponíveis clicando na caixa de seleção (Número selecionado) de (Número de opções) (por exemplo, 0 de 200 selecionados) para adicionar todos os valores correspondentes ao filtro e podem selecionar Desmarcar tudo para remover todos os valores correspondentes. Todas as mudanças serão aplicadas automaticamente, a menos que o usuário clique no botão Cancelar. Os controles de lista de tags só podem aparecer na orientação popover ou atrás do botão Mais. A opção Selecionar tudo não fica disponível se o URL do painel tiver mais de 2.083 caracteres.		S N T ZC DI DU
Controle deslizante do intervalo	O mínimo e o máximo do controle deslizante de intervalo podem ser definidos na guia Configurações da janela de configuração do filtro. Os leitores podem definir o intervalo de valores do filtro ajustando as duas extremidades do controle deslizante.		N DI DU
Seleção única
Botões de alternância	Esse tipo de filtro é útil para oferecer aos espectadores um conjunto selecionado de opções limitadas. Até 30 opções podem ser selecionadas na configuração Valores. Para os tipos de dados string, tier e zipcode, se a configuração Valores for deixada em branco, os primeiros 30 valores do banco de dados serão mostrados. Um botão fica colorido quando é selecionado.		S N T ZC YN DI DU P
Botões de opção	Como um botão de alternância, mas com um design um pouco diferente, esse tipo de filtro é útil para oferecer aos leitores um conjunto selecionado de opções limitadas. Até 50 opções podem ser selecionadas na configuração Valores. Para os tipos de dados string, tier e zipcode, se a configuração Valores for deixada em branco, os primeiros 50 valores do banco de dados serão mostrados.		S N T ZC YN DI DU P
Menu suspenso	As opções do menu suspenso podem ser selecionadas na configuração Valores. Para os tipos de dados string, tier e zipcode, todos os valores podem ser mostrados no banco de dados se a configuração Valores for deixada em branco. Para abrir o menu suspenso, os leitores podem clicar no campo de filtro ou na divisa. Os usuários podem selecionar uma opção no menu suspenso ou digitar na caixa para restringir as opções. Os espectadores também podem selecionar Qualquer valor. Os controles de menu suspenso só podem aparecer na orientação inline ou atrás do botão Mais.		S N T ZC YN DI DU P
Controle deslizante	Os valores mínimo e máximo do controle deslizante podem ser definidos na guia Configurações da janela de configuração do filtro. Os leitores podem definir o valor do filtro ajustando a extremidade direita do controle deslizante.		N DI DU
Datas e horas
Um dia	Os leitores podem selecionar a data para abrir o calendário e escolher um novo dia. Os controles de menu de um único dia só podem aparecer na orientação inline ou atrás do botão Mais.		DT^*O controle de um único dia pode ser usado com a maioria dos períodos e tipos baseados em tempo, mas os leitores só podem selecionar datas únicas com esse tipo de controle.
Período	Os leitores podem selecionar o período para abrir a agenda e escolher um novo período. Os controles do menu de período só podem aparecer na orientação inline ou atrás do botão Mais.		DT^* O controle de período pode ser usado com a maioria dos períodos e tipos baseados em tempo, mas os leitores só podem selecionar períodos com esse tipo de controle.
Períodos	Os leitores podem selecionar um dos períodos integrados ao Looker ou criar um período personalizado selecionando a guia Personalizado. Consulte a página de documentação Como visualizar painéis para conferir todas as opções de períodos de um filtro de períodos. As opções de período, como Últimos 7 dias, incluem o dia atual. Para um período que exclui o dia atual, selecione Avançado no menu suspenso de controle e configure o valor usando dias completos. Acumulado no ano inclui do início do ano até o segundo atual. Os espectadores podem selecionar o período para ver as opções de período. Os controles do menu de períodos só podem aparecer na orientação inline ou atrás do botão Mais.		DT^* O controle de período pode ser usado com a maioria dos períodos e tipos baseados em tempo, mas os leitores não podem selecionar opções de tempo com esse tipo de controle.
Outro
Avançado	Consulte a seção Como usar controles avançados nesta página para saber mais sobre eles. Os controles avançados só podem aparecer na orientação popover ou atrás do botão Mais.		S N T ZC YN DT DI DU L P
^*Observação sobre dados de data e hora: alguns períodos e tipos baseados em tempo são interpretados como tipos de dados diferentes quando o Looker seleciona opções de controle para eles. Dois exemplos são o período yesno, que é interpretado como um tipo de dados yesno e, portanto, tem as opções de controle disponíveis para o tipo yesno, e o período hour_of_day, que é interpretado como um tipo de dados number e, portanto, tem as opções de controle disponíveis para o tipo number.

Como usar controles avançados

Observação: os controles avançados não são iguais aos filtros avançados.

Um controle avançado pode ser aplicado a todos os tipos de dados e oferece mais flexibilidade nas condições de filtro que você pode configurar. Para criar um controle avançado, abra o menu suspenso Controle na janela de configuração do filtro e selecione Avançado.

Depois de selecionar Avançado, a seção Configurar opções de filtro é preenchida com as opções de condição de filtro adequadas para o tipo de dados que você está filtrando. Por exemplo, se você criou um filtro para um campo com um tipo de dados string, as opções de condição de filtro, como é, contém e começa com, vão aparecer. Os filtros em outros tipos de dados, como number ou date, mostram opções de condição diferentes. Para definir as opções de condição do filtro, clique na caixa de cada opção.

A opção Permitir múltiplos valores de filtro permite que os usuários selecionem mais de um valor para o filtro. O padrão é ativado. Quando ativado, um símbolo + Adicionar aparece ao lado do campo Configurar valor padrão. Selecione o símbolo + para adicionar outro valor de filtro. Para restringir os usuários para que eles possam selecionar apenas um valor, desative essa opção. A opção Permitir múltiplos valores de filtro não está disponível para filtros baseados no tipo de dados location ou no parâmetro parameter.

Depois de selecionar a opção de condição de filtro, escolha um valor no menu Configurar valor padrão, que é preenchido com valores do seu banco de dados. Ou insira um valor para receber uma sugestão.

Você também pode inserir um valor e pressionar Enter (PC) ou Return (Mac) para criar um valor.

Selecione o + ao lado do valor do filtro para adicionar novas condições a ele, que serão adicionadas como condições OR ou AND, dependendo dos tipos de condições e valores.

Para remover uma condição, clique no X ao lado dela.

Controles avançados, datas e horas

Embora existam vários controles de filtro que permitem filtrar por datas, você também pode usar controles avançados com datas. Entre outras coisas, o uso de controles avançados permite que os usuários selecionem períodos "completos" que não incluem o período atual, selecionando períodos como dias completos ou semanas completas nas opções de condição. Isso é diferente do controle de filtro de período, que inclui o período atual.

Os controles avançados também permitem que os usuários selecionem valores de tempo, como horas, minutos e segundos.

Corresponde a um atributo do usuário

Os controles avançados também oferecem a opção de selecionar corresponde a um atributo de usuário na seção Configurar opções de filtro. Com essa opção, você pode definir filtros que mudam dinamicamente com base nos atributos de usuário dos leitores do painel. Consulte a página de documentação Como filtrar e limitar dados para mais informações.

Corresponde a (avançado)

Se você clicar em corresponde ao avançado na seção Configurar opções de filtro, poderá inserir uma expressão de filtro do Looker para personalizar um filtro além das opções fornecidas no menu de opções.

Também é possível referenciar atributos do usuário em filtros avançados de correspondência usando a seguinte sintaxe:

{{ _user_attributes['name_of_your_attribute'] }}

Como exibir filtros do painel

Há várias opções para alterar a forma como os filtros do dashboard são exibidos. É possível ajustar a aparência de controles de filtro individuais ou de toda a barra de filtros.

Aparência de filtros individuais

Para definir como um filtro aparece, primeiro verifique se o painel está no modo de edição e selecione o estilo de exibição no campo Exibição da janela de configuração do filtro que aparece quando você seleciona Editar no menu do filtro. A maioria dos filtros de painel pode ser exibida das seguintes maneiras:

Importante: se você editar um painel com guias, todos os filtros vão aparecer em todas as guias no modo de edição. Depois que você sair do modo de edição, um filtro só vai aparecer em uma guia se for aplicado a pelo menos um bloco nela.

• Inline: o filtro é exibido diretamente na barra de cima do painel.

  

• Popover: um valor de resumo aparece na barra superior do painel. Selecione o valor para ver o filtro completo.

  

• Os filtros também podem ser colocados atrás de um botão Mais: um botão Mais vai aparecer na barra de filtros com um indicador que mostra o número de filtros que a barra contém. Os leitores podem selecionar o botão para ver os filtros e os valores deles.

  

Alguns controles de filtro só podem ser mostrados na orientação inline. Ao editar um painel com esses controles, você não vai encontrar um campo Exibição na janela de configuração do filtro. Esses controles de filtro só podem ser exibidos na orientação inline:

• Menu suspenso
• Um dia
• Períodos
• Período

Além disso, alguns controles de filtro só podem ser exibidos na orientação popover. Ao editar um painel com esses controles, você não vai encontrar um campo Exibição na janela de configuração do filtro. Esses controles de filtro só podem ser mostrados na orientação popover:

• Lista de tags
• Avançado

Em geral, recomendamos que os filtros importantes ou usados com frequência sejam exibidos como inline ou popover, e os filtros usados com menos frequência sejam exibidos como overflow.

Aparência da barra de filtros

Para definir como uma barra de filtros aparece, siga estas etapas:

1. Verifique se o painel está no modo de edição.

Importante: se você editar um painel com guias, todos os filtros vão aparecer em todas as guias no modo de edição. Depois que você sair do modo de edição, um filtro só vai aparecer em uma guia se for aplicado a pelo menos um bloco nela.

1. Abra a janela Configurações do painel.
2. Selecione a guia Filtros na janela Configurações.
3. Você pode definir a opção Visualização com filtro padrão como Expandida ou Recolhida. O padrão é Expandido.
4. A opção Local dos filtros permite colocar a barra de filtros na parte de cima ou à direita do painel. O padrão está na parte de cima.

Exigir um valor de filtro

Importante: para limitar o acesso aos dados dos leitores do dashboard, use o parâmetro access_filter do LookML em vez dos filtros obrigatórios.

Por padrão, os filtros não exigem valores. Se um filtro que não exige um valor for deixado em branco, os dados não serão restringidos pelo campo do filtro. Por exemplo, se você tiver um filtro em um campo Estado em um painel e esse filtro não tiver um valor, o painel vai retornar dados de todos os estados.

Se um filtro exigir um valor, o painel não será executado até que você selecione um valor de filtro. Um filtro obrigatório sem valor selecionado mostra avisos ao lado do filtro e quando o ponteiro é mantido sobre o ícone de atualização até que um valor seja escolhido.

Além disso, não é possível criar uma programação de painel sem selecionar um valor para um filtro obrigatório ou limpar o cache e atualizar um bloco vinculado a um filtro obrigatório que não tem um valor.

Para exigir que um usuário insira um valor em um filtro antes de executar o dashboard:

1. Verifique se o painel está no modo de edição.

Importante: se você editar um painel com guias, todos os filtros vão aparecer em todas as guias no modo de edição. Depois que você sair do modo de edição, um filtro só vai aparecer em uma guia se for aplicado a pelo menos um bloco nela.

1. Abra a janela de configuração do filtro adicionando um novo filtro de painel ou editando um filtro de painel atual.
2. Selecione a seta ao lado do título Opções adicionais para revelar as opções adicionais.
3. Marque a caixa de seleção Exigir um valor de filtro.
4. Selecione Atualizar para salvar a mudança.

A caixa de seleção Exigir um valor de filtro exige que os leitores selecionem qualquer valor. Para restringir os valores que um leitor pode selecionar, defina os valores permitidos no campo Valores da janela de configuração do filtro.

Os filtros obrigatórios são úteis para limitar os tamanhos das consultas enviadas ao banco de dados. Para limitar o acesso aos dados dos leitores do dashboard, use o parâmetro LookML access_filter.

Como configurar filtros vinculados

Observação: os filtros vinculados não afetam as sugestões em campos que têm uma suggest_dimension fornecida.

Os filtros de dashboard podem ser vinculados para que as opções de valor de um filtro sejam limitadas com base no valor ou nos valores selecionados para outro filtro no mesmo dashboard.

Por exemplo, é possível vincular um filtro de painel para Cidade a um filtro separado para Estado. As opções de valor do filtro "Cidade" vão mudar com base no estado ou nos estados selecionados no filtro "Estado".

Depois de selecionar um valor de filtro para Estado, um ícone de link aparece com o filtro Cidade. Se você passar o cursor sobre o ícone de link, uma caixa vai aparecer informando que as opções de valor para esse filtro foram limitadas pelo filtro "Estado".

Você pode ir além e vincular um filtro de CEP aos filtros de cidade e estado, limitando as opções de valor para CEP de acordo com a cidade e o estado selecionados. Por exemplo, se o filtro de estado for Nova Jersey e o de cidade for Asbury Park, o menu suspenso do filtro de CEP vai mostrar apenas o valor do CEP em Asbury Park.

Se você vincular filtros e seus dados não tiverem valores para um filtro "filho" (o filtro a ser limitado), considerando os valores selecionados no filtro "pai" (o filtro que limita as opções do filtro filho), os leitores vão receber uma mensagem Nenhuma correspondência encontrada para o filtro filho.

Os filtros vinculados funcionam em uma direção, do pai para o filho. Se você fizer uma seleção em um filtro filho, isso não vai afetar as opções de valor apresentadas para o filtro pai.

Como vincular filtros

Ao vincular filtros, qualquer um deles pode ser usado como filtro "principal" (aquele que restringe as opções de outro filtro), mas o filtro "secho" (aquele que será restrito) só pode usar um campo do tipo string, usados com frequência para palavras ou frases, ou do tipo zipcode, usados com frequência para CEPs.

Se houver apenas um filtro no painel, a capacidade de vincular filtros será desativada.

Para vincular um filtro a outro:

1. Verifique se o painel está no modo de edição.

Importante: se você editar um painel com guias, todos os filtros vão aparecer em todas as guias no modo de edição. Depois que você sair do modo de edição, um filtro só vai aparecer em uma guia se for aplicado a pelo menos um bloco nela.

1. Abra a janela de configuração do filtro "principal" adicionando um novo filtro de painel ou editando um filtro de painel atual.
2. Selecione a seta ao lado do título Opções adicionais para revelar as opções adicionais.
3. Marque a caixa de seleção Selecione os filtros que você quer atualizar quando este filtro for alterado.
4. Selecione a caixa de campo para revelar um menu suspenso com os outros filtros string e zipcode presentes no painel.
5. Selecione os filtros de string ou zipcode que você quer vincular a esse filtro.
6. Selecione Atualizar para salvar a mudança.

Como mover e reposicionar filtros de painel

Depois que os filtros forem colocados em um painel, você poderá movê-los ou reposicioná-los:

1. Entrar no modo de edição no painel.

Importante: se você editar um painel com guias, todos os filtros vão aparecer em todas as guias no modo de edição. Depois que você sair do modo de edição, um filtro só vai aparecer em uma guia se for aplicado a pelo menos um bloco nela.

1. Passe o cursor sobre o filtro para exibir o ícone de seis pontos. O ícone de seis pontos aparece no canto superior esquerdo do filtro.

2. Selecione e mantenha pressionado o ícone de seis pontos e arraste o filtro para a posição desejada.

   Esse método de arrastar pode ser usado para reposicionar filtros inline e popover, reconfigurar quais filtros são colocados atrás de um botão Mais e reposicionar filtros no menu suspenso do botão Mais.

   Se não houver filtros atrás do botão Mais, um botão Mais vazio vai aparecer temporariamente enquanto você arrasta um filtro. Mova o filtro sobre o botão Mais para colocá-lo dentro do botão Mais. Se você não colocar o filtro no botão Mais, ele vai desaparecer quando você parar de segurá-lo.

Se o cruzamento de filtros estiver ativado em um painel, não será possível reposicionar os filtros cruzados usando o recurso de arrastar e soltar. Além disso, ao entrar no modo de edição, todos os filtros cruzados definidos no painel serão apagados.

Filtros como blocos

O recurso Filtros como blocos permite colocar filtros do painel diretamente na tela do painel como blocos, em vez de restringi-los à barra de filtros na parte de cima do painel. Esse recurso permite que os criadores de painéis coloquem controles de filtro ao lado dos blocos de visualização específicos que eles afetam.

Além disso, os filtros como blocos permitem que os usuários vejam a lista de filtros aplicados a um bloco de visualização específico.

Como colocar filtros como blocos de dashboard

Os editores de painéis podem converter filtros em blocos arrastáveis na tela do painel das seguintes maneiras:

• Para enviar um filtro da barra de filtros para a tela do painel:

  • Arraste o filtro para o espaço Arraste os filtros aqui para adicionar ao painel na barra de filtros.
  • Como alternativa, selecione o ícone de três pontos Menu de filtro ao lado do filtro e selecione Enviar para o painel.

• Para enviar um filtro da tela do painel de volta para a barra de filtros:

  • Selecione o ícone de três pontos Menu de filtro no bloco de filtro e selecione Enviar para a barra de filtro.

Um editor pode arrastar e organizar blocos de filtro na tela do painel da mesma forma que outros blocos. Um filtro pode estar na barra de filtros superior ou na tela do painel, e a posição dele não afeta os blocos em que ele é aplicado.

Um filtro só pode aparecer uma vez no painel, seja na barra de filtros superior ou na tela. Se você duplicar um bloco de filtro em uma tela de painel, um novo filtro com um ID diferente será criado.

Ao duplicar uma guia do painel

Se uma guia incluir um filtro colocado como um bloco, a duplicação dessa guia também vai duplicar o bloco de filtro na nova guia. O bloco duplicado permanece na mesma instância de filtro, compartilhando o mesmo ID de filtro do original. Portanto, mudar um valor em um atualiza o outro.

Desativar o botão de pré-lançamento Filtros como blocos e contexto de filtro no nível do bloco

Se você desativar o botão de pré-lançamento, as seguintes mudanças vão ocorrer:

• Todos os filtros adicionados anteriormente à tela do painel como blocos vão aparecer na barra de filtros na parte de cima do painel.
• Os blocos de filtro na tela do painel vão aparecer em branco.
• No modo de edição, uma observação será exibida nos blocos em branco do painel para indicar que eram blocos de filtro.

Mostrar filtros aplicados a um bloco de visualização

Quando o recurso em fase de pré-lançamento Filtros como blocos e contexto de filtro no nível do bloco ou Filtros em blocos de visualização está ativado, os leitores podem verificar quais filtros são aplicados a um bloco de visualização específico.

Para conferir os filtros aplicados em um bloco de visualização, siga um destes procedimentos:

• Selecione o ícone de filtro Mostrar filtros no cabeçalho superior direito do bloco de visualização.
• Mantenha o ponteiro sobre o bloco de visualização, selecione o ícone de três pontos Ações do bloco e, em seguida, selecione Mostrar filtros.

Um menu lateral mostra todos os filtros aplicados e os valores selecionados, organizados nas seguintes categorias:

• Filtros de visualização: mostra os filtros aplicados diretamente ao bloco de visualização (se o recurso em fase de pré-lançamento Filtros em blocos de visualização estiver ativado).
• Filtros do painel: mostra os filtros no nível do painel que se aplicam ao bloco. Isso inclui filtros cruzados.
• Filtros de consulta: mostra os filtros configurados na consulta subjacente do bloco (na Análise ou no Look).

Se nenhum filtro relevante se aplicar ao bloco, o menu vai mostrar Sem filtros.

Os criadores e editores de painéis podem configurar se e quais filtros são exibidos nos blocos de visualização usando a configuração Informações do filtro do bloco na guia Filtros da janela Configurações do painel:

• Mostrar tudo: exibe filtros no nível do painel, filtros no nível da consulta (configurados na Análise subjacente) e filtros no nível da visualização (se o recurso em fase de pré-lançamento Filtros em blocos de visualização estiver ativado).
• Ocultar filtros de consulta (padrão): exibe apenas filtros no nível do painel e filtros no nível da visualização (se o recurso em fase de pré-lançamento Filtros em blocos de visualização estiver ativado).
• Não mostrar: impede que a opção e o ícone Mostrar filtros apareçam nos blocos de visualização.

Quando os filtros no nível da consulta são mostrados, eles se comportam da seguinte maneira:

• Eles aparecem com um ícone de informações ao lado para se diferenciarem dos filtros no nível do painel.
• Se uma lógica complexa (como AND/OR) tiver sido implementada nas consultas da Análise, o contexto do filtro será resumido em um rótulo de filtro personalizado.

Filtros como blocos em dashboards do LookML

Os filtros como blocos são compatíveis com os dashboards do LookML. Os elementos de filtro podem ser configurados na seção elements do código do dashboard do LookML para serem colocados como blocos na tela do dashboard. Além disso, um parâmetro de configuração de contexto de filtro controla a exibição de filtros aplicados em blocos de visualização. Se esse parâmetro for omitido, o comportamento padrão será ocultar os filtros de consulta.

Filtros em blocos de visualização

Visualizar

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Observação: use o formulário de filtros do Looker em blocos de visualização: problemas de pré-lançamento para enviar feedback ou informar problemas com esse recurso em fase de pré-lançamento.

O recurso Filtros em blocos de visualização permite que os criadores de dashboards coloquem e gerenciem filtros diretamente em blocos de visualização individuais, em vez de apenas na barra de filtros na parte de cima do dashboard. Esse recurso oferece controles de filtragem contextualizados e localizados que se aplicam exclusivamente ao bloco específico em que estão configurados.

Para usar esse recurso, um administrador do Looker precisa ativar a opção Filtros em blocos de visualização na página Recursos em fase de pré-lançamento no painel Administrador.

Adicionar um filtro a um bloco de visualização

Para adicionar filtros a um bloco de visualização, você precisa ter privilégios de edição do painel. Para adicionar um filtro diretamente a um bloco de visualização individual, faça o seguinte:

1. Verifique se o painel está no modo de edição.
2. No bloco de visualização em que você quer adicionar um filtro, selecione o ícone Adicionar filtro de visualização no cabeçalho do bloco.
3. Na caixa de diálogo que aparece, selecione a opção Adicionar filtro.
4. Uma janela Adicionar filtro é exibida, pré-preenchida com campos da Análise que foi usada para criar o bloco. Selecione o campo que você quer usar como filtro.
5. Defina as configurações do filtro, como título, tipo de controle e valor padrão.
6. Selecione Adicionar.
7. Quando terminar de editar o painel, selecione Salvar na barra de ferramentas de edição para salvar as alterações e sair do modo de edição.

O controle de filtro aparece em uma barra de filtro na parte de cima do bloco de visualização. A barra de filtro do bloco só aparece quando os filtros são configurados nesse bloco.

Interagir e organizar filtros no nível da visualização

Os leitores e editores do painel podem interagir com os filtros no nível da visualização diretamente no bloco:

• Atualizar temporariamente os valores do filtro: os leitores podem mudar os valores do filtro diretamente na barra de filtros do bloco sem obstruir a visualização.
• Reordenar filtros: quando o dashboard está no modo de edição, os editores podem clicar e manter pressionado o ícone Manter pressionado e arrastar para reordenar na barra de filtros do bloco para mudar a ordem de exibição.
• Rolagem horizontal: os filtros no nível da visualização são posicionados na parte de cima do bloco e não se estendem por várias linhas. Se o número de filtros exceder a largura do bloco, uma barra de rolagem horizontal vai aparecer na barra de filtros do bloco.

Editar ou excluir filtros no nível da visualização

Você precisa ter privilégios de edição de painel para editar ou excluir filtros em um bloco de visualização. Para editar ou excluir um filtro em um bloco de visualização, faça o seguinte:

1. Verifique se o painel está no modo de edição.
2. Clique no ícone de três pontos Menu de filtro ao lado do filtro.
3. Para editar o filtro, selecione Editar. Atualize a configuração do filtro na janela de configuração do filtro e selecione Atualizar.
4. Para excluir o filtro, selecione Excluir.
5. Quando terminar de editar o painel, selecione Salvar na barra de ferramentas de edição para salvar as alterações e sair do modo de edição.

Considerações e limitações

Lembre-se das seguintes considerações e limitações ao usar filtros em blocos de visualização:

• Escopo específico do bloco: um filtro no nível da visualização se aplica apenas ao bloco específico em que ele é colocado. Isso não afeta outros blocos no painel.
• Um filtro por campo por bloco: é possível adicionar apenas um filtro de visualização por campo em cada bloco. Se você tentar adicionar outro filtro para um campo que já tem um filtro nesse bloco, o Looker vai mostrar um erro.
• Diferente dos filtros no nível do painel: os filtros no nível da visualização não podem ser movidos para se tornarem filtros no nível do painel, e os filtros no nível do painel não podem ser movidos diretamente para um bloco.
• Analisar a partir daqui: se um usuário selecionar Analisar a partir daqui no menu de três pontos Ações do bloco, os filtros no nível da visualização não serão transferidos para a Análise (consistente com os filtros no nível do dashboard).
• Exportação e download: quando você baixa ou imprime um painel como PDF ou imagem, os filtros no nível da visualização são capturados em um formato baseado no frame visível. Se uma barra de filtros de bloco tiver filtros em excesso que exigem rolagem, somente os filtros visíveis na tela serão incluídos na exportação. Os filtros em excesso serão cortados.
• URLs do painel: os valores de filtro ativos no nível da visualização são capturados no URL do painel (por exemplo, com sintaxe de parâmetro como vis_id<id>.<field_name>=<value>), permitindo que os usuários compartilhem visualizações filtradas específicas de um painel.
• Dashboards do LookML: nos dashboards do LookML, os filtros no nível da visualização são especificados usando o subparâmetro vis_filter: true no parâmetro filters:. Para filtros padrão no nível do painel, não é necessário definir vis_filter: false.

Como ocultar filtros de painel

Observação: em painéis com guias, se um filtro não for aplicado a nenhum bloco em uma guia específica, ele será ocultado para essa guia.

Para ocultar os filtros de um painel, altere o URL dele para incluir um parâmetro hide_filter para cada filtro que você quer ocultar. Sempre que os usuários acessarem o painel com esse URL, eles vão ver uma versão com esses filtros ocultos. No entanto, se os usuários acessarem o painel de outras maneiras ou com um URL que não contenha o parâmetro hide_filter, os filtros não serão ocultados.

Atenção: ocultar filtros do painel pelo URL não é um recurso de segurança. Os usuários ainda poderão ver e modificar os filtros do painel se acessarem o painel navegando até ele no Looker ou usando um URL que não contenha o parâmetro hide_filter.

Por exemplo, este é o URL de um painel com dois filtros que não estão ocultos: Estado do usuário, que tem um valor de filtro definido como Nova Jersey, e Data, que não tem um valor de filtro definido.

https://mycompany.looker.com/dashboards/390?User+State=New+Jersey&Date=

Para ocultar um filtro, adicione um parâmetro hide_filter ao URL, precedido por um "e" comercial (&) e seguido por um sinal de igual (=). Atribua ao parâmetro o valor do nome do filtro, substituindo os espaços no nome por símbolos de adição (+). Não é necessário incluir o valor do filtro (se houver) no parâmetro hide_filter.

Para ocultar apenas o filtro Estado do usuário, altere o URL para o seguinte:

https://mycompany.looker.com/dashboards/390?User+State=New+Jersey&Date=&hide_filter=User+State

Para ocultar os filtros Estado do usuário e Data, adicione outro parâmetro hide_filter para o filtro Data:

https://mycompany.looker.com/dashboards/390?User+State=New+Jersey&Date=&hide_filter=User+State&hide_filter=Date

Para nomes de filtros com caracteres especiais, como os parênteses e a barra em Primeira compra (Sim / Não), o URL codifica os caracteres especiais:

https://mycompany.looker.com/dashboards/390?First+Purchase+%28Yes+%2F+No%29=

Para ocultar esse filtro, copie o nome do filtro codificado que já existe no URL (First+Purchase+%28Yes+%2F+No%29) e use-o como o valor do parâmetro hide_filter.

Há mais alguns pontos importantes sobre como ocultar filtros de painel:

• Qualquer usuário com acesso de visualização a um painel pode ocultar os filtros dele com o URL. O usuário não precisa ter acesso de edição ao painel.
• Os filtros ocultos ainda se aplicam aos resultados do painel, mesmo que os controles de filtro não estejam visíveis.
• Os valores dos filtros ocultos ainda podem ser alterados e aplicados ao painel, basta mudar os valores no URL.
• Para revelar os filtros ocultos, remova os parâmetros hide_filter do URL.
• Os filtros ocultos não aparecem no modo de edição.
• Ocultar um filtro obrigatório sem um valor faz com que os blocos do dashboard produzam erros de filtros inválidos. Para resolver um desses erros, atribua um valor ao filtro obrigatório.
• Se os painéis estiverem sendo programados ou enviados, os links de painel incluídos na entrega não vão incluir o parâmetro hide_filter.
• Se os painéis tiverem alertas, os links dos painéis incluídos no envio do alerta não vão incluir o parâmetro hide_filter.

Como aplicar filtros de painel a alertas

O menu Filtros também permite aplicar edições de filtro aos alertas presentes nos blocos de um painel. Para mais informações, consulte a página de documentação Efeito das edições do painel nos alertas.

Como editar filtros de painel

No modo de edição, um ícone de três pontos do Menu de filtros aparece ao lado de cada filtro. Para editar um filtro, selecione o ícone. O menu de filtros será aberto, mostrando as opções para editar ou excluir um filtro.

Importante: se você editar um painel com guias, todos os filtros vão aparecer em todas as guias no modo de edição. Depois que você sair do modo de edição, um filtro só vai aparecer em uma guia se for aplicado a pelo menos um bloco nela.

Observação: para editar ou excluir um filtro localizado diretamente em um bloco de visualização individual, consulte Editar ou excluir filtros no nível da visualização.

Selecione a opção de menu Editar para abrir uma janela de configuração de filtro, semelhante à usada para adicionar um filtro, preenchida com a configuração atual do filtro. Nessa seção, é possível atualizar o campo de filtragem, as configurações do filtro ou os blocos que serão atualizados. Selecione Atualizar ou Cancelar na janela de configuração do filtro para salvar ou cancelar as mudanças.

Depois de editar os filtros, selecione o botão Atualizar do dashboard para aplicar as novas configurações de filtro aos blocos.

Selecione Salvar na barra de ferramentas de edição do painel para salvar as mudanças e sair do modo de edição.

Como excluir filtros de painel

No modo de edição, o ícone de três pontos do Menu de filtros aparece ao lado de cada filtro.

Importante: se você editar um painel com guias, todos os filtros vão aparecer em todas as guias no modo de edição. Depois que você sair do modo de edição, um filtro só vai aparecer em uma guia se for aplicado a pelo menos um bloco nela.

Observação: para editar ou excluir um filtro localizado diretamente em um bloco de visualização individual, consulte Editar ou excluir filtros no nível da visualização.

Para excluir um filtro:

1. Selecione o ícone de três pontos do Menu de filtros.
2. O menu de filtros será aberto. Esse menu mostra opções para editar ou excluir um filtro.
3. Selecione a opção de menu Excluir para excluir o filtro.
4. Selecione Salvar na barra de ferramentas azul para salvar as mudanças e sair do modo de edição.
5. Depois de excluir os filtros, selecione o botão Atualizar do dashboard para aplicar as novas configurações de filtro aos blocos.

Como alternativa, selecione a opção de menu Editar, que abre a janela de configuração do filtro. Selecione o botão Excluir na janela de configuração do filtro para excluí-lo.

Não é possível desfazer a exclusão de um filtro.