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
| 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 classificaçã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.
| Exemplo | Resultado |
|---|---|
|
Below( Sum(Sales) ) |
Retorna o valor de Sales para a linha abaixo da linha atual. |
Exemplo - Fundamentos de Below
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
-
Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
-
Os campos a seguir na tabela de dados:
-
Year
-
Sales
-
Script de carregamento
Example:
LOAD * INLINE [
Year, Sales
2019, 1000
2020, 1500
2021, 1200
2022, 1800
2023, 1700
];Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
-
Year
Crie as seguintes medidas:
-
=Sum(Sales) para encontrar as vendas anuais.
-
=Below(Sum(Sales)) para encontrar o valor de vendas do próximo ano.
-
=Sum(Sales) - Below(Sum(Sales)) para calcular a variação entre o valor de Sales do ano atual e o valor do próximo ano.
-
=RangeSum(Below(Sales, 1, 2)) para demonstrar uma agregação de dois anos consecutivos dos próximos dois anos de vendas.
-
=(Sales - Below(Sales)) / Below(Sales) para retornar a alteração em Sales como uma razão/porcentagem. Para mostrar esse valor como uma porcentagem, em Formatação de números, selecione Número > Formatação simples > 12,34%.
| Year | Sum(Sales) | Below(Sum(Sales)) | Sum(Sales) - Below(Sum(Sales)) | RangeSum(Below(Sales, 1, 2) | (Sales - Below(Sales)) / Below(Sales) |
|---|---|---|---|---|---|
| Totals | 7200 | - | - | 0 | - |
| 2019 | 1000 | 1500 | -500 | 2700 | -33.33% |
| 2020 | 1500 | 1200 | 300 | 3000 | 25.00% |
| 2021 | 1200 | 1800 | -600 | 3500 | -33.00% |
| 2022 | 1800 | 1700 | 100 | 1700 | 5.88% |
| 2023 | 1700 | - | - | 0 | - |
Observando os resultados, você pode comparar os valores de Sales no período atual com o próximo período.
-
A medida Sum(Sales) - Below(Sum(Sales)) retorna a alteração nos valores de Sales, comparando o período atual com o próximo período.
-
A medida RangeSum(Below(Sales, 1, 2)) retorna a soma dos dois próximos valores de Sales.
-
A medida (Sales - Below(Sales)) / Below(Sales) retorna a alteração em Sales em comparação com o período seguinte como uma porcentagem.
Faça o seguinte:
Crie um gráfico de barras e adicione este campo como uma dimensão:
-
Year
Crie a seguinte medida:
-
=Sum(Sales) - Below(Sum(Sales)) para retornar a variação ano a ano.
Gráfico de barras mostrando os resultados da função Below
O uso da função Below em um gráfico de barras fornece uma comparação visual da variação entre as vendas do período atual e do próximo período.
Exemplo - Cenário de Below
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
-
Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
-
Os campos a seguir na tabela de dados:
-
SalesYear
-
SalesAmount
-
Script de carregamento
Example:
LOAD * INLINE [
SalesYear, SalesAmount
2019, 500
2020, 800
2021, 400
2022, 700
2023, 600
];Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:
-
SalesYear
Crie as seguintes medidas:
-
=Sum(SalesAmount) para agregar as vendas.
-
=RangeSum(Below(SalesAmount, 0, NoOfRows() - RowNo())) para calcular um total resumido dos valores de SalesAmount.
| SalesYear | Sum(SalesAmount) | RangeSum(Below(SalesAmount, 0, NoOfRows() - RowNo())) |
|---|---|---|
| Totals | 3000 | 0 |
| 2019 | 500 | 2400 |
| 2020 | 800 | 1900 |
| 2021 | 400 | 1100 |
| 2022 | 700 | 700 |
| 2023 | 600 | 0 |
Os resultados mostram como você pode usar a combinação da função RangeSum e da função Below para criar um total acumulado.
Faça o seguinte:
Crie um gráfico de barras e adicione este campo como uma dimensão:
-
SalesYear
Crie a seguinte medida:
-
=RangeSum(Below(SalesAmount, 0, NoOfRows() - RowNo())) para retornar o valor acumulado das vendas resumidas.
Gráfico de barras mostrando o valor acumulado de vendas resumidas por ano
O uso da função Below em combinação com a RangeSum em um gráfico de barras fornece uma exibição visual dos valores acumulados de vendas resumidas.