Below() avalia uma expressão na linha abaixo da linha atual dentro de um segmento de coluna em uma tabela. A linha para a qual ela é calculada depende do valor de offset; se estiver presente, o padrão será a linha diretamente inferior. Para gráficos que não sejam tabelas, Below() avalia a linha abaixo da coluna atual no equivalente de tabela estática do gráfico.
Sintaxe:
Below([TOTAL] expr [ , offset [,count ]])
Tipo de dados de retorno: dual
Argumentos:
| Argumento | Descrição |
|---|---|
| expr | A expressão ou campo que contém os dados a serem medidos. |
| offset |
Especificar um offsetn, maior que 1 move a avaliação da expressão para as linhas n abaixo da linha atual. A especificação de um deslocamento igual a 0 avaliará a expressão na linha atual. Especificando um número de compensação negativa faz a função Below funcionar como a função Above com o número de compensação positiva correspondente. |
| count |
Ao especificar um terceiro parâmetro count maior que 1, a função retornará uma série de valores count, um para cada count linhas da tabela, contado para baixo da célula original. Dessa forma, a função pode ser usada como um argumento para qualquer uma das funções de intervalo especiais. Funções de intervalo |
| TOTAL |
Se a tabela for unidimensional ou se o qualificador TOTAL for usado como argumento, o segmento de coluna atual será sempre igual à coluna inteira. |
Na última linha de um segmento de coluna, um valor NULL é retornado, já que não há uma linha abaixo dela.
Limitações:
-
As chamadas recursivas retornarão NULL.
-
A classificação por valores y em gráficos ou por colunas de expressão em tabelas não é permitida quando essa função de gráfico é usada em qualquer uma das expressões do gráfico. Essas alternativas de ordenação estão, portanto, automaticamente desabilitadas. Quando você usar essa função de gráfico em uma visualização ou tabela, a classificação da visualização será revertida para a entrada classificada dessa função.
Exemplos e resultados:
Exemplo 1:
Na tabela mostrada na captura de tela do Exemplo 1, a visualização de tabela é criada a partir da dimensão Customer e das medidas: Sum(Sales) e Below(Sum(Sales)).
A coluna Below(Sum(Sales)) retorna NULL para a linha Customer contendo Divadip, porque não há nenhuma linha abaixo dela. O resultado para a linha Canutility mostra o valor de Sum(Sales) para Divadip, o resultado para Betacab mostra o valor para Sum(Sales) para Canutility e assim por diante.
A tabela também mostra medidas mais complexas, que podem ser usadas nas colunas rotuladas: Sum(Sales)+Below(Sum(Sales)), Below +Offset 3 e Higher?. Estas expressões funcionam conforme descrito nos parágrafos a seguir.
Para a coluna rotulada Sum(Sales)+Below(Sum(Sales)), a linha para Betacab mostra o resultado da soma dos valores Sum(Sales) para as linhas Astrida + Astrida (539+587). O resultado da linha Betacab mostra o resultado da soma dos valores Sum(Sales) para Canutility + Betacab (539+683).
A medição rotulada Below +Offset 3 criada usando a expressão Sum(Sales)+Below(Sum(Sales), 3) tem o argumento offset, definido como 3 e tem o efeito de obter o valor na linha três linhas abaixo da linha atual. Ele soma o valor Sum(Sales) para o atual Customer ao valor Customertrês linhas abaixo. Os valores para as três linhas inferiores Customer são null.
A medida rotulada Higher? é criada a partir da expressão:IF(Sum(Sales)>Below(Sum(Sales)), 'Higher'). Isto compara os valores da linha atual na medida Sum(Sales) com a linha abaixo dela. Se a linha atual for um valor maior, o texto "Higher" será a saída.
Para gráficos com mais de uma dimensão, os resultados de expressões que contêm as funções Above, Below, Top e Bottom dependem da ordem em que as dimensões da coluna são classificadas pelo Qlik Sense. O Qlik Sense avalia as funções com base nos segmentos de coluna que resultam da dimensão que é classificada por último. A ordem de classificação da coluna é controlada no painel de propriedades em Classificação e não é necessariamente a ordem em que as colunas aparecem na tabela.Consulte o exemplo: 2 na função Above para obter detalhes adicionais.
|
Exemplo 2: |
Resultado | ||
|---|---|---|---|
|
A função Below pode ser usada como entrada para as funções range. Por exemplo: RangeAvg (Below(Sum(Sales),1,3)). |
Nos argumentos da função Below(), offset é definido como 1 e count é definido como 3. A função encontra os resultados da expressão Sum(Sales) nas três linhas imediatamente abaixo da linha atual no segmento de coluna (onde há uma linha). Estes três valores são usados como entrada para a função RangeAvg(), que encontra a média de valores na variação de números fornecidos. Uma tabela com Customer como dimensão dá os seguintes resultados para a expressão RangeAvg(). |
||
|
Dados usados nos exemplos: