# Below - função de gráfico

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.<br><br>A especificação de um deslocamento igual a 0 avaliará a expressão na linha atual.<br><br>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](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/RangeFunctions/RangeFunctionsInCharts.htm) |
| 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.<br><br>[Definindo o escopo de agregação](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) |

Na última linha de um segmento de coluna, um valor NULL é retornado, já que não há uma linha abaixo dela.

Nota informativaUm segmento de coluna é definido como um subconjunto consecutivo de células que contêm os mesmos valores para as dimensões na ordem de classificação atual. As funções de inter-registro de gráficos são computadas no segmento de coluna, excluindo a dimensão mais à direita no gráfico de tabela simples equivalente. Se houver apenas uma dimensão no gráfico ou se o qualificador TOTAL for especificado, a expressão avalia a tabela completa.

Nota informativaSe a tabela ou o equivalente de tabela tiver várias dimensões verticais, o segmento de coluna atual incluirá somente linhas com os mesmos valores que a linha atual em todas as colunas de dimensão, exceto na coluna que mostrar a última dimensão na ordem de classificação entre os campos.

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: expressões de gráfico

| Exemplo | Resultado |
| --- | --- |
| `Below( Sum(Sales) )` | Retorna o valor de `Sales` para a linha abaixo da linha atual. |

## Exemplo - Fundamentos de Below

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/below.htm)

#### Expressão de gráfico

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 &gt; Formatação simples &gt; 12,34%.

Tabela de resultados

| 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.

Nota de dicaEssa função também pode ser usada para gráficos além de tabelas, como gráficos de barra.

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

Gráfico de barras mostrando os resultados da função Below

Gráfico de barras mostrando os resultados da função BelowBelow ![Gráfico de barras mostrando a variação anual da soma das vendas em comparação com o ano seguinte](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-below-example.png)

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

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/below.htm)

#### Expressão de gráfico

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`.

Tabela de resultados

| 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.

Nota de dicaEssa função também pode ser usada para gráficos além de tabelas, como gráficos de barra.

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

Gráfico de barras mostrando o valor acumulado de vendas resumidas por ano

Gráfico de barras mostrando o valor acumulado de vendas resumidas por ano ![Gráfico de barras mostrando os valores acumulados de vendas resumidas.](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-below-example2.png)

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.

## Exemplo – Expressão de gráfico usando Below

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/below.htm)

#### Expressão de gráfico

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:

* Duas tabelas de dados chamadas `Monthnames` e `Sales2013`.

Script de carregamento

```
Monthnames:
LOAD *, Dual(MonthText,MonthNumber) as Month INLINE [
MonthText, MonthNumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
May, 5
Jun, 6
Jul, 7
Aug, 8
Sep, 9
Oct, 10
Nov, 11
Dec, 12
];

Sales2013:
Crosstable (MonthText, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15
Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|'); 
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* `Customer`

Crie as seguintes medidas:

* `=Sum(Sales)` para calcular a soma das vendas.

* `=Below(Sum(Sales))` para mostrar a soma das vendas na linha anterior.

* `=Sum(Sales)+Below(Sum(Sales))` para somar a soma de vendas com a soma de vendas da linha do cliente abaixo da linha atual.

* `=Sum(Sales)+Below(Sum(Sales), 3)` para somar o valor `Sum(Sales)` do `Customer` atual com o valor do `Customer` que está três linhas abaixo.

* `=If(Sum(Sales)>Below(Sum(Sales)), 'Higher')` para adicionar o rótulo "`Higher`" aos clientes cujos resultados de `Sum(Sales)` são maiores que o `Sum(Sales)` do cliente na linha abaixo.

Tabela de resultados

| Customer | Sum(Sales) | Below(Sum(Sales)) | Sum(Sales)+Below(Sum(Sales)) | Sum(Sales)+Below(Sum(Sales), 3) | If(Sum(Sales)&gt;Below(Sum(Sales)), 'Higher') |
| --- | --- | --- | --- | --- | --- |
| Totals | 2566 | - | - | - | - |
| Astrida | 587 | 539 | 1126 | 1334 | Higher |
| Betacab | 539 | 683 | 1222 | - | - |
| Canutility | 683 | 757 | 1440 | - | - |
| Divadip | 757 | - | - | - | - |

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. Para ver um exemplo que demonstra o uso da ordem de classificação, consulte [Exemplo – Above cenário baseado na ordem de classificação](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/above.htm#Example).

A medida `Below(Sum(Sales))` retorna NULL para o cliente `Divadip`, porque não há nenhuma linha abaixo dele. 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.

Para a medida `Sum(Sales)+Below(Sum(Sales))`, a linha para `Astrida` retorna o resultado da adição dos valores de `Sum(Sales)` para as linhas `Betacab` + `Astrida` (`539+587`). O resultado da linha `Betacab` mostra o resultado da soma dos valores `Sum(Sales)` para `Canutility` + `Betacab` (`539+683`).

A medida `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 `Customer`três linhas abaixo. Os valores para as três linhas inferiores `Customer` são null.

A medida `IF(Sum(Sales)>Below(Sum(Sales)), 'Higher')` retorna o valor `Higher` para o cliente `Astrida` porque seus resultados de vendas são maiores que a soma das vendas do cliente na linha abaixo, `Betacab`.

Nota de dicaEssa função também pode ser usada para gráficos além de tabelas, como gráficos de barra.

Nota de dicaPara outros tipos de gráficos, converta o gráfico para o equivalente de tabela simples, para que você possa interpretar facilmente a qual linha a função está relacionada.

## Exemplo – Usando a função Below com RangeAvg

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/below.htm)

#### Expressão de gráfico

Visão geral

A função Below pode ser usada como entrada para as funções range. Este exemplo usa a função em uma RangeAvg.

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:

* Duas tabelas de dados chamadas Monthnames, Sales2013.

Script de carregamento

```
Monthnames:
LOAD *, Dual(MonthText,MonthNumber) as Month INLINE [
MonthText, MonthNumber
Jan, 1
Feb, 2
Mar, 3
Apr, 4
May, 5
Jun, 6
Jul, 7
Aug, 8
Sep, 9
Oct, 10
Nov, 11
Dec, 12
];

Sales2013:
Crosstable (MonthText, Sales) LOAD * inline [
Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
Astrida|46|60|70|13|78|20|45|65|78|12|78|22
Betacab|65|56|22|79|12|56|45|24|32|78|55|15
Canutility|77|68|34|91|24|68|57|36|44|90|67|27
Divadip|57|36|44|90|67|27|57|68|47|90|80|94
] (delimiter is '|'); 
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

* Customer

Crie a seguinte medida:

* =RangeAvg (Below(Sum(Sales),1,3))

Tabela de resultados

| Customer | RangeAvg (Below(Sum(Sales),1,3)) |
| --- | --- |
| Totals | - |
| Astrida | 660 |
| Betacab | 720 |
| Canutility | 757 |
| Divadip | - |

Nos argumentos para a função Below, offset é definido como 1 e count é definido como 3. A função encontra os resultados da expressãoSum(Sales) nas três linhas imediatamente abaixo da linha atual no segmento da 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.

## Saiba mais

* [Above - função de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/above.htm)
* [Bottom - função de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/bottom.htm)
* [Top - função de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/InterRecordFunctions/top.htm)
* [RangeAvg Função de script e de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/RangeFunctions/rangeavg.htm)