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

Com os filtros de dashboard, um leitor pode restringir 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 painel. Os leitores não podem mudar esses filtros, a menos que tenham permissão para editar o bloco ou 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 do painel com filtros cruzados ativados.
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 superior não vão substituir os campos no filtro de expressão personalizada, independentemente das colunas que estão sendo referenciadas. Nesse caso, o filtro de nível superior e o filtro 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 exibidos 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 do 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 de LookML e está no Modo de Desenvolvimento, pode 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.

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 vinculado a um 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 painel, 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 medidas) de todas as Análises usadas na criação dos blocos desse dashboard.

Por exemplo, a janela Adicionar filtro a seguir mostra as análises usadas nos blocos do painel: 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 código 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 da LookML a que você tem acesso.

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 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 do painel nesta página para saber mais sobre as diferentes maneiras de exibir filtros. Se um controle só puder ser mostrado de uma maneira, essa opção não vai aparecer.
• Valores: para definir opções de valor específicas para o filtro, escolha 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.

Na guia Blocos para atualizar, você pode 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 a ser filtrado 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 combinação mudar de alguma forma (por exemplo, se alguém reordenar as consultas de combinação 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.

Fazer edições na guia Blocos a serem atualizados

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

Se você quiser ajustar quais blocos usam qual filtro ou quais campos são afetados por filtros, as seguintes configurações 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 a ser filtrado, para cada bloco, escolha qual campo será afetado pelo filtro ou escolha não aplicar o filtro a um bloco individual. Se o campo de um novo filtro já for usado por um filtro preexistente, os blocos filtrados por ele 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 conferir o tipo de dados de um campo em que você está filtrando, é necessário ter a permissão see_lookml. Para ver o LookML do campo, selecione Acessar o 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 medidas 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 leitores 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	Semelhante a um grupo de botões, mas com um design um pouco diferente, esse tipo de filtro é útil para oferecer aos espectadores um conjunto limitado de opções selecionadas. É possível selecionar até 50 opções 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 exibidos do banco de dados se a configuração Valores for deixada em branco. Os espectadores podem abrir o menu de valores clicando no campo de filtro ou no chevron. Os usuários podem marcar 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. Também é possível clicar em 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. É possível selecionar até 50 opções 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 exibidos do banco de dados se a configuração Valores for deixada em branco. Os espectadores podem abrir o menu suspenso clicando no campo de filtro ou no chevron. 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 do 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	O mínimo e o máximo do controle deslizante podem ser definidos na guia Configurações da janela de configuração do filtro. Os espectadores podem definir o valor do filtro ajustando a extremidade direita do controle deslizante.		N DI DU
Datas e horários
Um dia	Os espectadores 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 dia único 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 o calendário 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 na 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. 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. Os controles do menu de períodos podem aparecer apenas 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. 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 uma delas.

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 só possam selecionar um valor, desative essa opção. A opção Permitir vários valores de filtro não está disponível para filtros baseados no tipo de dados location ou no parâmetro parameter.

Depois de selecionar uma 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 você pode inserir um valor para receber uma sugestão.

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

Selecione o + ao lado do valor do filtro para adicionar novas condições ao filtro, 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, datas e horários avançados

Embora haja vários controles de filtro que permitem filtrar por datas, também é possível 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, é possível definir filtros que mudam dinamicamente com base nos atributos do usuário dos leitores do painel. Consulte a página de documentação Filtrar e limitar dados para mais informações.

Partidas avançadas

Se você clicar em corresponde a 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 "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 dos 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 do painel pode ser mostrada 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, não aparece um campo Mostrar 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 mostrados na orientação popover. Ao editar um painel com esses controles, o campo Mostrar não aparece 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 mostrados como inline ou popover, e os filtros menos usados sejam mostrados 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 da 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 de 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 restritos pelo campo de 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 dele e quando você mantém o ponteiro sobre o ícone de recarregar 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 apenas que os leitores selecionem um 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 ajudam a limitar os tamanhos das consultas enviadas ao banco de dados. Para limitar o acesso aos dados dos leitores de dashboards, use o parâmetro access_filter do LookML.

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 do painel podem ser vinculados para que as opções de valor de um filtro sejam reduzidas com base no valor ou nos valores selecionados para um filtro diferente no mesmo painel.

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 de acordo com o estado ou os estados selecionados no filtro "Estado".

Depois de selecionar um valor de filtro para Estado, um ícone de link vai aparecer com o filtro Cidade. Se você mantiver o ponteiro sobre o ícone de link, uma caixa vai aparecer informando que as opções de valor desse filtro foram reduzidas pelo filtro "Estado".

Você pode ir além e vincular um filtro de CEP aos filtros de cidade e estado, restringindo as opções de valor para o CEP de acordo com a cidade e o estado selecionados. Por exemplo, se o filtro de estado for New 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 filtro pode ser usado como o filtro "principal" (o filtro que restringe as opções de outro filtro), mas o filtro "secundário" (o filtro a ser restringido) 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 o filtro ou os filtros de string ou zipcode que você quer vincular.
6. Selecione Atualizar para salvar a mudança.

Como mover e reposicionar filtros de painel

Depois que os filtros são colocados em um painel, é possível movê-los ou reposicioná-los das seguintes maneiras:

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 na parte de cima à esquerda 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 movê-lo para dentro dele. 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 arrastar e soltar. Além disso, entrar no modo de edição limpa todos os filtros cruzados definidos no painel.

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. Com esse recurso, os criadores de painéis podem colocar 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.

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:Filtros como blocos está disponível como um recurso de prévia. Para usar esse recurso, um administrador do Looker precisa ativar a opção Filtros como blocos e contexto de filtro no nível do bloco na página Prévia das configurações de Administrador. A opção fica desativada por padrão.

O recurso de filtros como blocos está em pré-lançamento com suporte limitado. Compartilhe sua opinião para nos ajudar a melhorar. Para informar bugs ou problemas, use este formulário e forneça os seguintes detalhes:

• Uma descrição clara do problema e do comportamento esperado.
• Etapas para a reprodução do problema
• Outros detalhes relevantes

Como colocar filtros como blocos de painel

Depois que a opção Filtros como blocos e contexto de filtro no nível do bloco estiver ativada, os editores do painel poderão 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 filtro:

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

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 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 visualização Filtros como blocos e contexto de filtro no nível do bloco

Se você desativar o botão de prévia, 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 vai aparecer nos blocos em branco do dashboard para indicar que eles eram blocos de filtro.

Como 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 de prévia 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 dashboards podem configurar se e quais filtros são mostrados nos blocos de visualização usando a configuração Informações do filtro do bloco na guia Filtros da janela Configurações do dashboard:

• 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): mostra apenas os filtros no nível do painel e 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 a lógica 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 "Problemas de prévia dos filtros do Looker em blocos de visualização" para enviar feedback ou informar problemas com esse recurso de prévia.

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 o título, o tipo de controle e o 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 filtros diretamente 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 de painéis podem interagir com filtros no nível da visualização diretamente no bloco:

• Atualização temporária de valores de filtro: os leitores podem mudar os valores de filtro diretamente na barra de filtros do bloco sem obstruir a visualização subjacente.
• Reordenar filtros: quando o painel 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 do Menu de filtro ao lado do filtro.
3. Para editar o filtro, selecione Editar. Atualize a configuração na janela correspondente 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 está inserido. Isso não afeta outros blocos no painel.
• Um filtro por campo por bloco: é possível adicionar apenas um filtro no nível da visualização por campo em cada bloco. Se você tentar adicionar outro filtro a um campo que já tem um filtro no 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 excedentes que exigem rolagem, somente os filtros visíveis na tela serão incluídos na exportação. Os filtros excedentes 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 com filtro 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 qualquer bloco em uma guia específica, ele será ocultado nessa guia.

Para ocultar os filtros do painel, altere o URL do painel 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 nã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 codificado dele 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 leitura 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 mudados e aplicados ao painel alterando os valores no URL.
• Para mostrar 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 painel 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 incluídos na entrega não vão incluir o parâmetro hide_filter.
• Se os painéis tiverem alertas, os links incluídos na entrega de alertas não terão 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. Lá, é possível atualizar o campo "Filtrar por", as configurações do filtro ou os blocos a serem 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 painel para aplicar as novas configurações 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 Menu de filtro.
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 painel 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.