Como configurar uma barra de filtro de texto para consultar campos de texto - Quick BI: Central de Documentação do Alibaba Cloud

A barra de filtro de texto permite que os visualizadores do relatório filtrem dados ao inserir ou selecionar valores de texto. Esse recurso facilita o foco nas informações essenciais dos gráficos.

Principais vantagens da barra de filtro de texto:

Alta flexibilidade: Oferece três tipos de exibição, incluindo lista suspensa, caixa de entrada de texto e seleção em árvore, com opções de configuração adaptáveis a diversos cenários.
Alta precisão: Disponibiliza múltiplas condições de correspondência, como contém, não contém, começa com e termina com, garantindo uma filtragem de dados precisa.

O Quick BI suporta três tipos de barras de filtro de texto: lista suspensa, caixa de entrada de texto e seleção em árvore. As seções a seguir detalham os casos de uso e a configuração de cada tipo.

Pré-requisitos

Você já criou um painel e os gráficos nele contêm campos de texto.
Você já adicionou uma barra de filtros vazia ao painel. Para mais informações, consulte Criar uma barra de filtros.

Configurar condições de filtro

Acesse a página de edição do painel. Para mais informações, consulte Criar um painel.
Na lista de painéis, localize e clique no painel desejado.

Os gráficos do painel devem conter campos de texto para configurar uma barra de filtro de texto. Este tópico utiliza um gráfico de linhas como exemplo. Para mais informações, consulte gráfico de linhas.
Siga as etapas ilustradas na figura para adicionar uma barra de filtros.
Configure a barra de filtros.
1. Defina o nome da condição de filtro como Level Query.
2. Selecione o gráfico associado line chart e o campo associado order_level.
3. Defina o tipo de exibição e conclua a configuração das condições de filtro.
  1. Ao selecionar drop-down list como display type, consulte lista suspensa para ver um exemplo.
  2. Ao selecionar text input box como display type, consulte caixa de entrada de texto para ver um exemplo.
  3. Ao selecionar tree drop como display type, consulte seleção em árvore para ver um exemplo.
Clique em OK.

Lista suspensa

A lista suspensa apresenta opções predefinidas para seleção pelos visualizadores do relatório. Quando o tipo de exibição é drop-down list, a origem dos valores das opções suporta automatic parsing, single dataset e manual input.

Análise automática

Ao escolher a análise automática como origem dos valores das opções, o Quick BI identifica automaticamente os valores de todos os campos associados e preenche a barra de filtros com a união desses valores.

Nota

Se os gráficos selecionados na seção Related Charts and Fields utilizarem o mesmo conjunto de dados, a análise automática recuperará os valores desse conjunto.
Caso os gráficos selecionados na seção Related Charts and Fields utilizem múltiplos conjuntos de dados, as opções na lista suspensa serão a união dos valores de todos os conjuntos associados.

Parâmetro	Descrição	Exemplo
Selection mode	Suporta single-select e multi-select.	Selection mode: Selecione multi-select. Query time: Selecione on-click query. Set filter defaults: Defina o nível do pedido como Advanced, a província como Guangdong Province e o tipo de produto como Furniture.
Query time	Suporta on-click query e pre-query. On-click query: Valor padrão. A consulta é executada somente quando o usuário clica no botão de consulta. Pre-query: Os valores da lista suspensa são obtidos antes do carregamento do painel. Isso permite que a lista exiba opções baseadas nas permissões de nível de linha de cada usuário e habilite valores padrão específicos por usuário. A opção pre-query é ideal para conjuntos de dados com permissão de nível de linha e pequeno volume de dados; caso contrário, pode aumentar o tempo de carregamento do relatório.
Show null values for filter options	Se você selecionar Show null values for filter options, os valores nulos na lista suspensa serão exibidos como (Null) para os visualizadores do relatório. Se esta opção não estiver selecionada, os valores nulos serão filtrados da lista. Nota Este parâmetro está disponível apenas quando Configure whether to display null values in each filter condition estiver selecionado nas Report Configurations no nível da organização.
Set filter defaults	Ao selecionar esta opção, a caixa de filtro exibirá Please select. Clique na caixa para abrir a caixa de diálogo Field e configurar os valores padrão. Nesta caixa de diálogo, você pode realizar as seguintes operações: Insira uma palavra-chave na caixa de pesquisa e clique na palavra abaixo para adicionar o valor do campo alvo da esquerda à lista Added à direita. Clique em Add all field values on the left para mover todos os valores de campo da esquerda para a lista Added à direita. Marque as caixas de seleção ao lado dos valores de campo à esquerda para adicioná-los à lista Added à direita. Clique em Exclude para excluir os valores presentes na lista Added. Nota Se você excluir um valor de campo como padrão e depois alterar o estilo da lista suspensa para mosaico, a seleção desse valor na barra de filtros o excluirá dos resultados. Caso configure primeiro o estilo de mosaico e depois exclua um valor de campo como padrão, o estilo mudará de mosaico normal para mosaico de exclusão. Clique em Clear para remover todos os valores de campo da lista Added. Nota Se houver mais de 1.000 opções de filtro, apenas as primeiras 1.000 serão exibidas por padrão. É possível pesquisar opções além desse limite.

Resumo deste exemplo:

A seção Related Charts and Fields inclui campos de múltiplos conjuntos de dados. A lista suspensa do filtro exibirá a união de todos os valores de campo associados.
O Selection mode está definido como multi-select, permitindo que os usuários selecionem várias opções simultaneamente.
O Query time está configurado como on-click query, o que significa que o visualizador deve clicar no botão de consulta para aplicar o filtro.
A opção Set filter defaults está configurada com Advanced, Guangdong Province e Furniture. Ao abrir o relatório, o visualizador verá inicialmente os resultados correspondentes a essas seleções.

O resultado é mostrado na figura a seguir: 112

Conjunto de dados único

Ao selecionar um conjunto de dados único como origem dos valores das opções, as opções da barra de filtros derivam de um campo específico dentro desse conjunto.

Parâmetro	Descrição	Exemplo
Select a dataset	É possível selecionar qualquer conjunto de dados dentro do workspace do painel atual. Recomendamos escolher o conjunto de dados que serve de origem para o gráfico.	Select a dataset: Neste exemplo, o conjunto de dados de origem `company_sales_record` foi selecionado. Query value field: order_level. Display name field: order_level. Sort field: Order Date. Selection mode: Selecione multi-select. Query time: Selecione on-click query. Set filter defaults: Selecione esta opção e defina o valor padrão como Advanced.
Query value field	Este campo do conjunto de dados selecionado é comparado ao campo associado. Seus valores são usados na consulta real, permitindo que os visualizadores do relatório selecionem um ou mais deles para filtrar os dados.
Display name field	Campo cujos valores aparecem como opções na barra de filtros. Geralmente, utiliza-se este campo para melhorar a experiência do usuário, ajudando os visualizadores a compreender melhor o significado das opções. Igual ao campo de valor de consulta: Se os valores no campo de valor de consulta forem claros e fáceis de entender, você pode definir o campo de nome de exibição como igual. Nesse caso, após selecionar o campo de valor de consulta, o sistema preenche automaticamente o campo de nome de exibição. Diferente do campo de valor de consulta: Caso os valores no campo de valor de consulta sejam códigos numéricos ou difíceis de compreender, selecione um campo de nome de exibição mais amigável em sua tabela de dados. Use esse campo para as opções de exibição na barra de filtros, enquanto a consulta real continua usando o campo de valor de consulta. Nessa situação, é necessário selecionar manualmente um campo de nome de exibição diferente após escolher o campo de valor de consulta.
Sort field	Permite classificar por um campo selecionado. Trata-se de um parâmetro opcional. Se deixado em branco, as opções seguem a ordem do conjunto de dados. Para classificar por um campo específico, como uma medida ou data, selecione-o na lista suspensa. As opções de classificação incluem Ascending, Descending e Custom. Se escolher Custom, arraste e solte os valores de campo na caixa de diálogo Custom Sort para organizar a ordem. Essa configuração afeta apenas a ordem das opções na lista suspensa do filtro. Ela não altera a ordem de classificação dos valores de dimensão nos gráficos, que ainda é controlada pelo conjunto de dados ou pelo painel de dados de cada gráfico.
Selection mode	Suporta single-select e multi-select.
Query time	Suporta on-click query e pre-query. On-click query: Valor padrão. A consulta é executada somente quando o usuário clica no botão de consulta. Pre-query: Os valores da lista suspensa são obtidos antes do carregamento do painel. Isso permite que a lista exiba opções baseadas nas permissões de nível de linha de cada usuário e habilite valores padrão específicos por usuário. Nota A opção pre-query é ideal para conjuntos de dados com permissão de nível de linha e pequeno volume de dados; caso contrário, pode aumentar o tempo de carregamento do relatório.
Show null values for filter options	Se esta opção não estiver selecionada, os valores nulos serão filtrados da lista. Nota Este parâmetro está disponível apenas quando Configure whether to display null values in each filter condition estiver selecionado nas Report Configurations no nível da organização.
Set filter defaults	Ao selecionar esta opção, o filtro exibirá valores predefinidos. Nota Se houver mais de 1.000 opções de filtro, apenas as primeiras 1.000 serão exibidas por padrão. É possível pesquisar opções além desse limite. Quando o query time estiver definido como on-click query, você poderá configurar valores de filtro padrão. Quando o query time estiver definido como pre-query, utilize Manual Setting ou uma Dynamic Function. A pré-consulta é ideal para cenários que exigem busca antecipada de dados, como exibir diferentes opções de filtro baseadas nas permissões de nível de linha de cada usuário. As funções dinâmicas permitem definir o padrão como Maximum Value of Query Field, Minimum Value of Query Field ou First Item of Query Field. Nota Se um sort field estiver definido, o First Item of Query Field será o primeiro valor de acordo com essa ordem de classificação. Sem um campo de classificação definido, o First Item of Query Field corresponde ao primeiro valor desse campo no conjunto de dados. Se o campo possuir uma ordem de classificação definida no conjunto de dados (como ascendente, descendente ou personalizada), o primeiro valor seguirá essa ordem.

Resumo deste exemplo:

O dataset é o conjunto de dados recomendado company_sales_record, que serve de origem para o gráfico atual.
O query value field coincide com o campo associado, portanto order_level é usado na consulta real.
O display name field é idêntico ao campo de valor de consulta, ambos sendo order_level.
O sort field está definido como Order Date para determinar a ordem de classificação das opções de filtro.
O Selection mode está configurado como multi-select, permitindo que os visualizadores escolham múltiplas opções.
O Query time está definido como on-click query, exigindo que o visualizador clique no botão de consulta para aplicar o filtro.
A opção Set filter defaults está configurada como Advanced, fazendo com que o relatório exiba inicialmente os resultados referentes ao nível de pedido Advanced ao ser aberto.

O resultado é mostrado na figura a seguir:

112

Entrada manual

Ao optar pela entrada manual como origem dos valores das opções, o autor do relatório define explicitamente as opções da barra de filtros.

Parâmetro	Descrição	Exemplo
Manual input	Clique em Manual Input e insira o Query Value e o Display Name na caixa de diálogo Manual Input. Query Value: O valor real proveniente do campo do gráfico. Neste exemplo, o campo selecionado é `order_level`, com valores como Advanced, Intermediate, Basic e Other. Display Name: O texto exibido na lista suspensa correspondente ao valor de consulta. Nota Na primeira vez que inserir valores manualmente, se o valor de consulta e o nome de exibição forem iguais, basta inserir o valor de consulta. Após clicar em OK, o sistema preencherá automaticamente o nome de exibição. Na primeira inserção manual, caso o valor de consulta e o nome de exibição sejam diferentes, ambos devem ser informados. Garanta que o número de linhas para valores de consulta e nomes de exibição seja idêntico para manter a correspondência um a um. Nas entradas manuais subsequentes, é obrigatório informar tanto o valor de consulta quanto o nome de exibição. Se apenas o valor de consulta for inserido, uma mensagem de erro será exibida.	Manual input: Neste exemplo, os valores de campo e seus respectivos nomes de exibição são: Advanced - Grade A; Intermediate - Grade B; Basic - Grade C; Other - Grade D. Selection mode: multi-select Set filter defaults: Selecione esta opção e defina o valor padrão como Grade A (correspondente a Advanced).
Selection mode	Suporta single-select e multi-select.
Set filter defaults	Ao selecionar esta opção, o filtro exibirá valores predefinidos.

Resumo deste exemplo:

A Manual input mapeia os valores do campo de nível de pedido para valores de exibição: Advanced para Grade A, Intermediate para Grade B, Basic para Grade C e Other para Grade D.
O Selection mode está definido como multi-select, exigindo que os visualizadores cliquem no botão de consulta para aplicar o filtro.
A opção Set filter defaults está configurada como Advanced, fazendo com que o relatório exiba inicialmente os resultados para Grade A ao ser aberto.

O resultado é mostrado na figura a seguir:

112

Pesquisa

Utilize a barra de pesquisa para localizar rapidamente opções específicas durante a filtragem.

Caso não encontre a opção desejada, tente usar Search from Database.
Quando houver mais de 1.000 opções de filtro, apenas as primeiras 1.000 serão exibidas por padrão. Pesquise diretamente por opções além desse limite. Se ainda assim não encontrar a opção desejada, tente Search from Database.

Nota

A opção Search from Database está disponível apenas quando o display type for drop-down list e a option value source estiver definida como automatic parsing ou single dataset.

Caixa de entrada de texto

A caixa de entrada de texto permite que os visualizadores recuperem dados rapidamente ao inserir palavras-chave, tornando as consultas mais precisas e flexíveis. Quando o tipo de exibição é text input box, defina o condition type como Single condition, OR condition ou AND condition. Esta seção utiliza uma OR condition como exemplo.

Parâmetro	Descrição	Exemplo
Condition type	Suporta Single condition, OR condition e AND condition. Single condition: Atende a um único critério. Por exemplo, Tipo de Produto é Régua. OR condition: Atende a pelo menos um de dois critérios. Por exemplo, Tipo de Produto é Régua ou Lápis. AND condition: Atende a dois critérios simultaneamente. Por exemplo, Valor do Pedido é maior que 100 E menor que 200.	Condition type: Selecione OR condition. Set default value: Configure a condição para contains o texto `ruler` ou starts with o texto table. Lock filter condition: Selecione esta opção.
Set default value	As regras disponíveis dependem do tipo de condição selecionado. A lista abaixo mostra as regras disponíveis e suas sintaxes SQL correspondentes ao definir um valor padrão para o campo product_sub_type: Exact match: `product_sub_type = 'ruler'` Does not match: `product_sub_type != 'ruler'` Contains: `product_sub_type LIKE '%ruler%'` Does not contain: `product_sub_type NOT LIKE '%ruler%'` Starts with: `product_sub_type LIKE 'ruler%'` Ends with: `product_sub_type LIKE '%ruler'` Is null: `product_sub_type IS NULL` Is not null: `product_sub_type IS NOT NULL` Is empty string: `product_sub_type = ''` Is not empty string: `product_sub_type != ''`
Lock filter condition	Ao ativar esta opção, os visualizadores do relatório não poderão alterar o tipo de condição na página de visualização. Nota Esta opção está disponível apenas quando Set default value estiver selecionado.

Resumo deste exemplo:

O Condition type está definido como OR condition, significando que os dados serão exibidos se atenderem a qualquer um dos critérios de filtro especificados.
A opção Set default value está configurada para contains o texto ruler ou starts with o texto table. Ao abrir o relatório, o visualizador verá inicialmente os resultados onde o tipo de produto contém "ruler" ou começa com "table".
A opção Lock filter condition está ativada, impedindo que os visualizadores alterem o tipo de condição na página do relatório.

O resultado é mostrado na figura a seguir:

112

Seleção em árvore

A seleção em árvore permite que os visualizadores filtrem dados hierárquicos, como estruturas organizacionais, regiões geográficas (País-Província-Cidade) ou categorias de produtos (Categoria-Subcategoria), expandindo e selecionando opções em cada nível.

Nota

Quando um gráfico associado utiliza uma combinação de conjuntos de dados e múltiplos campos associados são selecionados, a seleção em árvore fica indisponível.

Parâmetro	Descrição		Exemplo
Select a dataset	É possível selecionar qualquer conjunto de dados dentro do workspace do painel atual. Recomendamos escolher o conjunto de dados que serve de origem para o gráfico.		Select a dataset: Neste exemplo, o conjunto de dados de origem do gráfico company_sales_record foi selecionado. Tree structure design: Configure o Nível 1 com o campo region e o Nível 2 com o campo province. Display format: Selecione tile display. Selection mode: Selecione multi-select. Query time: Selecione on-click query. Set default value: Defina o padrão como Northeast > Liaoning. Quick association: Selecione esta opção.
Tree structure design	Clique em Start Configuration. Na caixa de diálogo Tree Structure Design, configure o query field, o display name field, o sort field e a sort rule para cada nível do filtro. Query field: Campo utilizado para a consulta real. Os visualizadores podem selecionar um ou mais de seus valores para filtrar os dados. Display name field: Se o campo de consulta contiver IDs ou códigos de negócio difíceis de entender, defina um campo de nome de exibição para tornar as opções de filtro mais amigáveis. Sort field: Permite classificar por um campo selecionado. Parâmetro opcional. Se deixado em branco, as opções seguem a ordem do conjunto de dados. Sort rule: As opções de classificação incluem Ascending, Descending e Custom. Se escolher Custom, arraste e solte os valores de campo na caixa de diálogo Custom Sort para organizar a ordem. Exemplo: Por exemplo, se você criar um filtro em árvore com a hierarquia "Região-Província-Cidade" e definir uma regra de classificação ascendente para cada campo de consulta: As opções de filtro serão classificadas em ordem ascendente para cada nível (Região, Província e Cidade): Nota Ao selecionar um query field, o sistema preenche automaticamente o display name field. Por padrão, o display name field é igual ao query field. Se precisarem ser diferentes, altere o campo de nome de exibição manualmente. A seleção em árvore suporta até dez níveis de filtragem.
Display format	Escolha entre tree display e tile display. Nota Para mais de 1.000 entradas de dados, recomendamos o formato tile display.	Exibição em árvore com seleção única Exibição em árvore com seleção múltipla Exibição em mosaico com seleção única Exibição em mosaico com seleção múltipla
Selection mode	Escolha entre single-select e multi-select.
Query time	Suporta on-click query e pre-query. On-click query: A consulta é executada somente quando o usuário clica no botão de consulta. Pre-query: Os valores da lista suspensa são obtidos durante o carregamento da página do painel. Isso permite que a lista exiba opções baseadas nas permissões de nível de linha de cada usuário, e o valor padrão também pode variar conforme o usuário. Nota A opção pre-query é ideal para conjuntos de dados com permissão de nível de linha e pequeno volume de dados; caso contrário, pode aumentar o tempo de carregamento do relatório.
Show null values for filter options	Se você selecionar Show null values for filter options, os valores nulos na lista suspensa serão exibidos como (Null) para os visualizadores do relatório. Se esta opção não estiver selecionada, os valores nulos serão filtrados. Nota Se um nó intermediário na árvore tiver um valor nulo, todo o ramo (incluindo o nó nulo e todos os seus filhos) não será exibido, mesmo que os nós filhos possuam valores não nulos. Nota Este parâmetro está disponível apenas quando Configure whether to display null values in each filter condition estiver selecionado nas Report Configurations no nível da organização.
Set default value	Ao selecionar esta opção e definir um valor, a barra de filtros exibirá o valor predefinido quando a página do relatório carregar. Nota O valor padrão aqui corresponde ao campo de nome de exibição no design da estrutura em árvore.
Quick association	Ao selecionar Quick association, os campos de subnível na estrutura em árvore são adicionados automaticamente à seção Related Charts and Fields para gráficos do mesmo conjunto de dados. Isso agiliza a configuração da barra de filtros. Por exemplo, ao configurar os gráficos e campos associados para o campo de segundo nível province, o sistema preenche automaticamente o campo province para o line chart e o column chart do mesmo conjunto de dados. No entanto, o campo associado para o pie chart, que pertence a um conjunto de dados diferente, deve ser inserido manualmente, conforme mostrado na figura abaixo. Nota Apenas os gráficos selecionados na seção Related Charts and Fields do nível principal suportam a sincronização automática de campos de subnível. Clique em Associate Chart na estrutura em árvore ou clique no nome de um subnível na lista de filtros à esquerda para associar subníveis a gráficos e campos de outros conjuntos de dados.

Resumo deste exemplo:

A opção Select a dataset está definida como company_sales_record, o conjunto de dados de origem para o gráfico atual.
O tree structure design está configurado com o campo region no Nível 1 e o campo province no Nível 2. Como os valores do campo de consulta são autoexplicativos, os campos de consulta e de nome de exibição são idênticos.
O Display format está definido como tile display.
O Selection mode está configurado como multi-select, permitindo que os visualizadores escolham múltiplas opções.
O Query time está definido como on-click query, exigindo que o visualizador clique no botão de consulta para aplicar o filtro.
A opção Set default value está configurada como Northeast > Liaoning, fazendo com que o relatório exiba inicialmente os resultados para esta região e província ao ser aberto.
A Quick association está ativada.

O resultado é mostrado na figura a seguir:

112