Centro de suporte da Workiva

Definir campos de consulta

Para adicionar colunas específicas ou fontes completas aos resultados da consulta, selecione-as no painel Fontes, clique em Add to Fields ou mova-as para a guia Fields .

Depois de adicionar uma coluna à consulta, você poderá selecioná-la na guia Fields para visualizar sua fonte, ID e tipo de dados no painel direito Field Properties . Nesse painel, você também pode ajustar como o nome ou os dados de um campo aparecem nos resultados da consulta.

1. Para esclarecer os dados do campo, em Header, digite seu nome para aparecer nos resultados da consulta. Por exemplo, se a consulta incluir vários campos com o mesmo nome de fontes diferentes, atualize seus nomes para obter mais contexto.
2. Para retornar um tipo de dados diferente nos resultados, como para converter dados numéricos de texto em decimais ou inteiros, em Cast Type, selecione o tipo de dados a ser usado.

   Observação: os valores da tag são salvos como cadeias de caracteres. Para usar uma tag como outro tipo de dados, selecione o tipo desejado em Cast Type.

3. Para ajustar a forma como as datas aparecem em um resultado de Date ou Timestamp, em Function, selecione a abreviação - como Day ou Quarter - a ser exibida; ou, para um Custom Format, digite a expressão do novo formato de seus valores, como %Y-%m para YYYY-mm:

   Expressão	Exibições
   %b	O nome abreviado do mês, como Jan ou Dec
   %M	O nome completo do mês, como janeiro ou dezembro
   %c	O valor numérico do mês como um dígito simples ou duplo, como 1 para janeiro ou 12 para dezembro
   %m	O valor numérico do mês como um dígito duplo, como 01 para janeiro
   %D	O dia do mês com um sufixo em inglês, como 1st ou 23rd
   %Y	O ano inteiro com quatro dígitos
   %y	O ano abreviado com dois dígitos

   Observação: Por padrão, as datas ou carimbos de data/hora aparecem no formato ISO 8601 .

4. Em Aggregation Type, selecione se deseja retornar um cálculo - ou agregação- dos valores do campo nos resultados. Por exemplo, um campo pode retornar uma contagem de seus registros ou uma média ou soma de seus valores. Para fornecer um cálculo, selecione a agregação a ser executada:

   Agregação	Campo ou tipo de elenco	Resultado
   Soma de	Número	O total dos valores do campo
   Contagem de	Todos	O número total de registros com um valor no campo
   Máximo de	Inteiro, Número, Data, Carimbo de data/hora	O maior ou o último valor do campo
   Mínimo de	Inteiro, Número, Data, Carimbo de data/hora	O menor valor ou o valor mais antigo do campo
   Média de	Inteiro, Número	A média dos valores do campo

   Observação: Para incluir apenas registros com valores exclusivos no cálculo, selecione Use distinct aggregation.

5. Clique em Aplicar.

Definir cálculos

Com um cálculo, você pode aplicar automaticamente uma fórmula a várias colunas de origem, usando 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

To add a calculation to a query's results, select Calculation on the Sources panel, and then click Add to Fields or move it to the Fields tab. After you add the calculation to the query, select it on the Fields tab, and set up its formula from the Field Properties panel:

1. Mova Calculation do painel Sources para a consulta e, em seguida, selecione-o na consulta.
   
2. No painel Properties (Propriedades) , em Header (Cabeçalho), digite como o nome do cálculo deve aparecer nos resultados da consulta.
   

   Observação: Para definir o alias do cálculo, digite-o como cabeçalho. Os cálculos não são compatíveis com a sintaxe que contém AS para definir um alias.

3. Mova as colunas a serem incluídas no cálculo do painel Sources (Fontes) para Included Columns (Colunas incluídas) no painel Properties (Propriedades).

   Dica: Para incluir uma coluna em um cálculo, você também pode selecionar o cálculo na consulta e, em seguida, selecionar Add to Calculation no menu do botão direito do mouse da coluna no painel Sources .

4. Em Cálculo, digite a fórmula ou expressão a ser calculada, usando operadores e funções e as colunas incluídas representadas como seu token numérico atribuído, como {1} + {2}.
   • Para adicionar rapidamente o token numérico de uma coluna ao cálculo, clique em seu nome em Included Columns.
   • Para adicionar rapidamente a sintaxe de uma função ou operador, selecione-a no menu Calculation .
   • Para fazer referência a um valor de parâmetro no cálculo, selecione o parâmetro no menu Parameters ou digite seu nome após dois pontos, como :ReportingPeriod.

     Observação: Para adicionar um parâmetro, selecione Criar novo parâmetro no menu Parâmetros .

5. Clique em Aplicar.
<!--

Note: To quickly add a column's numerical token to the calculation, click its name under Included Columns.

-->

Organizar campos de consulta e cálculos

Para definir como os campos e cálculos aparecem nos resultados da consulta, organize-os na ordem em que devem aparecer. Para mover um campo de consulta ou cálculos na guia Fields , arraste-o para a posição apropriada ou clique com o botão direito do mouse nele e selecione se deseja movê-lo para cima, para baixo ou para a parte superior ou inferior dos campos.

Duplicar um campo de consulta ou cálculo

Para criar uma cópia de um campo de consulta ou cálculo, por exemplo, para usar com uma agregação ou fórmula diferente:

1. Na guia Fields da consulta, clique com o botão direito do mouse no campo ou cálculo a ser copiado e selecione Duplicate Field.
2. Selecione a duplicata - com um cabeçalho de [copied_fieldname]_copy- e atualize seu cabeçalho e quaisquer propriedades adicionais no painel direito Field Properties .
3. Clique em Salvar .

Remover um campo de consulta ou cálculo

Para remover um campo ou cálculo de uma consulta, na guia Fields , clique no campo Delete , ou clique com o botão direito do mouse nele e selecione Remove Field.