Centro de suporte da Workiva

Para limitar os registros incluídos nos resultados da consulta, por exemplo, com base na região ou no período de tempo, é possível definir os filtros no modo Construtor. Você pode filtrar os resultados com base em:

• Dados de uma coluna de origem
• Valor da tag de um conjunto de dados
• Um cálculo aplicado a dados de várias colunas

Observação: No SQL Editor, defina os filtros da consulta como sintaxe SQL. Para fazer referência a um parâmetro no SQL, digite seu nome após dois pontos (:), como, por exemplo, :ReportingPeriod.

Filtrar por dados de uma coluna de origem

Para filtrar os resultados de uma consulta com base nos dados de uma coluna de origem:

1. No painel esquerdo Fontes, adicione a fonte à consulta e mova sua coluna para a guia Filtros.
2. No painel Propriedades de campo, ajuste o tipo ou o formato dos valores do filtro, conforme necessário, e clique em Aplicar.
   
   
   • Em Tipo, selecione o tipo de dados a ser usado com os valores do filtro. Por exemplo, para filtrar dados numéricos do Text como números inteiros, selecione Integer.
   • Para um filtro de data ou registro de data e hora, em Função, defina como formatar seus valores:
     • Para truncar a data ou o registro de data e hora, como, por exemplo, apenas o dia ou o trimestre, escolha a unidade a ser exibida.
     • Para usar um formato diferente do padrão ISO 8601, selecione Custom Format (Formato personalizado) e selecione o novo formato. Para definir sua própria configuração, selecione Custom, defina como formatar os valores e clique em Aplicar.
3. Na guia Filtros, selecione o campo de valor do filtro.
4. No painel Filtrar propriedades, defina os critérios do filtro:
   • Para usar um valor estático, insira-o em Valor.
   • Para usar um valor de parâmetro, clique em Selecionar parâmetro e selecione a consulta ou o parâmetro global a ser usado. Para adicionar um novo parâmetro à consulta, selecione Criar novo parâmetro.
   • Para derivar o valor de um cálculo, ative Calculado, e componha o cálculo como Structured Query Language (SQL).
5. Na guia Filters , selecione o operador do filtro.

   Operador	Detalhes
   Equal To, =, Not Equal To, or !=	Para um Text, Decimal ou Integer, corresponde aos registros com base no fato de a coluna ter o valor exato
   On Date ou Not On Date	Para uma data ou carimbo de data/hora, corresponde aos registros com base no fato de a coluna ter exatamente a data
   > ou <	Para um Decimal ou Integer, corresponde aos registros com base no fato de sua coluna ter um valor maior ou menor, respectivamente
   After Date ou Before Date	Para uma Date ou Timestamp, faz a correspondência de registros com base no fato de a coluna ter uma data anterior ou posterior, respectivamente
   >= ou <=	Para um Decimal ou Inteiro, corresponde aos registros com base no fato de sua coluna ter o valor exato ou um valor maior ou menor, respectivamente
   After or On Date ou Before or On Date	Para uma Date ou Timestamp, faz a correspondência de registros com base no fato de a coluna ter a data exata, ou uma data posterior ou anterior, respectivamente
   Como	Para Text, faz a correspondência de registros quando a coluna tem um valor semelhante, com base em curingas. Por exemplo: %gland% retorna registros que contêm "gland" de qualquer forma, como England, England's, e gland. _ngland retorna registros com "ngland" nesse local exato, como England, mas e não Rengland.
   Is Null ou Is Not Null	Corresponde a registros com base no fato de sua coluna ter algum valor
   Is In List ou Is Not In List	Corresponde a registros com base no fato de sua coluna ter um valor de uma lista de opções. Se você selecionar esse operador, em List Options, insira cada opção em sua própria linha. Para uma data ou registro de data e hora, insira cada opção no formato AAAA-MM-dd. Observação: Selecione Is In List ou Is Not In List para usar a parâmetro de seleção múltipla como critério do filtro.

6. Clique em Salvar .

Filtrar por um cálculo aplicado a várias colunas

Para filtrar os resultados com base em um cálculo aplicado a várias colunas, configure uma fórmula com uma expressão que inclua:

• Operadores, como {1} + {2} para calcular a soma dos valores das colunas
• Funções, como concat({1}, {2}) para gerar uma cadeia de valores de colunas

1. No painel esquerdo Fontes, adicione as fontes a serem incluídas no cálculo para a consulta.
2. Mova Calculation de Sources para a guia Filters .
3. No painel Propriedades de campo, em Included Columns, adicione as colunas de origem a serem usadas no cálculo.
4. Em Cálculo, digite a fórmula ou expressão a ser calculada usando operadores e funções SQL. Na fórmula, represente as colunas incluídas como seu token numérico atribuído, como {1} + {2}.

   Observação: Para adicionar rapidamente o token numérico de uma coluna ao cálculo, clique em seu nome em Colunas incluídas.

5. Clique em Aplicar.
6. Na guia Filters (Filtros), selecione o valor do filtro e, em seguida, no painel Filter Properties (Propriedades do filtro), selecione o tipo de dados a ser usado com os valores do filtro, como Integer ou Decimal.
   
7. Defina os critérios dos registros a serem incluídos e clique em Aplicar:
   • Para incluir registros com base em um valor estático, insira-o no campo Valor .
   • Para usar um valor de parâmetro, clique em Selecionar parâmetro e selecione a consulta ou o parâmetro global a ser usado. Para adicionar um novo parâmetro à consulta, selecione Criar novo parâmetro.

<!--

Filter by a source table's tags

Your organization may set up tags to track details about your tables' datasets, such as Version, Source, or Scenario. To filter results based on this detail:

1. From the Sources left panel, add the the table as a query source.
2. Move the table's Tags column from Sources to the Filters tab.
3. From the Field Properties panel, select the tag to filter by, and click Apply.
4. On the Filters tab, select the filter's value.
5. From the Filter Properties panel, select the tag value of the records to include, and click Apply.

-->

Filtrar por etiquetas de uma tabela de origem

Com as tabelas Wdata, sua organização pode configurar etiquetas para rastrear detalhes sobre conjuntos de dados, como versão, fonte ou cenário. Para filtrar os resultados de uma consulta com base nesse detalhe:

1. No painel esquerdo Sources, adicione a tabela como uma fonte de consulta.
2. Selecione por qual das etiquetas da tabela você deseja filtrar:
   
   • Mova a etiqueta a ser filtrada de Etiquetas para a guia Filtros.
   • Mova Etiquetas para a guia Filtros e, em seguida, selecione o nome da etiqueta no painel Propriedades de campo e clique em Aplicar.
3. Na guia Filtros, selecione o operador do filtro:
   
   

   Operador	Detalhes
   Equal To ou Not Equal To	Corresponde a registros com base no fato de a etiqueta ter um valor exato
   Like ou Not Like	Com um valor que contém caracteres curinga, faz a correspondência de registros com base no fato de a etiqueta ter um valor semelhante. Por exemplo: %gland% retorna registros que contêm "gland" de qualquer forma, como England, England's, e gland. _ngland retorna registros com "ngland" nesse local exato, como England, mas e não Rengland.
   Is Null ou Is Not Null	Corresponde a registros com base no fato de a etiqueta ter algum valor
   Is In List ou Is Not In List	Corresponde a registros com base no fato de a etiqueta ter um ou vários valores

4. Selecione o campo de valor do filtro e, no painel Filtrar propriedades , especifique e aplique os valores de etiqueta para filtrar por:
   • Para usar os valores configurados da etiqueta , selecione-os em Valor.
   • Para usar um valor de parâmetro, clique em Selecionar parâmetro e selecione a consulta ou o parâmetro global a ser usado. Para adicionar um novo parâmetro à consulta, selecione Criar novo parâmetro.
   • Para derivar o valor de um cálculo, ative Calculado, e componha o cálculo como Structured Query Language (SQL).
   • Para usar outro valor, como um valor personalizado com curingas para um operador Like, insira-o em Valor.
5. Clique em Aplicar e Salvar .

<!--

Set Filter Criteria

To define the records to include in the results, set each filter's criteria based on:&nbsp;

• Static custom&nbsp;values,&nbsp;such as specific accounts or time periods
• Parameters, to choose values&nbsp;dynamically when the query runs, such as to slice-and-dice its data in real time
• Calculations derived from multiple columns' data

<h3>Static Custom Value</h3>

To filter the query based on a when field contains a static custom value, enter it in the Value field.&nbsp;

<h3>Parameter Value</h3>

To filter the query based on a field contains a dynamic parameter value, click Parameter , and select the parameter or click Create New Parameter to add one.

<h3>Calculated Value</h3>

To filter the query based on a formula:

1. Enable Calculated.
   
2. Under Included Columns, add the source columns to use in the formula.
3. Under Calculation, enter the formula or expression to calculate. To compose the calculation, use SQL operators and functions, with the included columns represented as their assigned numerical token, such as {1} + {2}.
4. Click Apply.

-->

Ajustar a fórmula dos filtros

Por padrão, a consulta corresponde a registros que atendem a todos os critérios de seus filtros. Para fazer a correspondência de registros que atendam a uma combinação de filtros, use os operadores AND e OR na barra de fórmulas da guia Filtros para definir os critérios cumulativos dos filtros:

• Para agrupar filtros, coloque-os entre parênteses, como, por exemplo, ({1} AND {2}) OR ({3} AND {4}).
• Para combinar registros que atendam a ambos de dois filtros ou grupos, separe-os com um AND, como {1} AND {2}.
• Para combinar registros que atendam a ou de dois filtros ou grupos, separe-os com um OR, como {2} OR {3}.

<!--

Filter Criteria and Case-Sensitivity

A filter's values are case-sensitive. For example, if you set a regional filter to "Iowa", it returns records with uppercase "Iowa", but not the lowercase "iowa". To include records regardless of casing:

• In Builder, use a calculation with a LOWER() function as the filter, which converts its values to lowercase. For example, LOWER(TBL.STATE) = 'iowa'.
• In SQL Editor, use a regular expression REGEXP_LIKE condition with an i flag, which makes the criteria case-insensitive. For example, SELECT * FROM table WHERE REGEXP_LIKE(column, ‘(?i)ab’).

-->