# Rank - função de gráfico

Rank() avalia as linhas do gráfico na expressão e, para cada linha, exibe a posição relativa do valor da dimensão avaliada na expressão. Ao avaliar a expressão, a função compara o resultado com o resultado de outras linhas que contêm o segmento de coluna atual e retorna a posição da linha atual dentro do segmento.

Para gráficos que não sejam tabelas, o segmento de coluna atual é definido conforme ele é exibido no equivalente de tabela estática do gráfico.

Sintaxe:

Rank([TOTAL expr[, mode[, fmt]])

Tipo de dados de retorno: dual

Argumentos:

* expr: A expressão ou campo que contém os dados a serem medidos.

* mode: Especifica a representação numérica do resultado da função.

* fmt: Especifica a representação textual do resultado da função.

* TOTAL: Se o gráfico for unidimensional ou se a expressão for precedida pelo qualificador TOTAL, a função será avaliada na coluna inteira. Se 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.

  [Definindo o escopo de agregação](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm)

A classificação é retornada como um valor duplo, que, quando cada linha tiver uma classificação única, será um número inteiro entre 1 e o número de linhas do segmento de coluna atual.

Caso várias linhas compartilhem a mesma posição, a representação textual e numérica poderá ser controlada com os parâmetros mode e fmt.

###### mode

O segundo argumento, mode, pode ter os seguintes valores:

Valores do segundo argumento

| Valor | Descrição |
| --- | --- |
| 0 (padrão) | Se todas as posições dentro do grupo de compartilhamento estiverem no lado inferior do valor intermediário da posição, todas as linhas receberão a posição mais baixa dentro do grupo.<br><br>Se todas as posições de compartilhamento dentro do grupo estiverem no lado superior do valor intermediário da posição, todas as linhas receberão a posição mais alta dentro do grupo.<br><br>Se as posições dentro do grupo se estenderem além do valor intermediário de toda a posição, todas as linhas receberão o valor correspondente à média da posição superior e inferior de todo o segmento de coluna. |
| 1 | Posição mais baixa em todas as linhas. |
| 2 | Posição média em todas as linhas. |
| 3 | Posição mais alta em todas as linhas. |
| 4 | Posição mais baixa na primeira linha, depois, aumentada em incrementos de um para cada linha. |

###### fmt

O terceiro argumento, fmt, pode ter os seguintes valores:

Valores do terceiro argumento

| Valor | Descrição |
| --- | --- |
| 0 (padrão) | Valor baixo - valor alto em todas as linhas (por exemplo 3-4). |
| 1 | Valor baixo em todas as linhas. |
| 2 | Valor baixo na primeira linha, em branco nas linhas seguintes. |

A ordem das linhas para mode 4 e fmt 2 é determinada pela ordem de classificação das dimensões do gráfico.

Exemplos e resultados:

Crie dois gráficos a partir das dimensões Product e Sales e outro a partir de Product e UnitSales. Adicione medidas, conforme mostrado na tabela a seguir.

Exemplo 1:

Crie uma tabela com as dimensões `Customer` e `Sales` e com a medida `Rank(Sales)`.

O resultado dependerá da ordem de classificação das dimensões. Se as tabelas forem classificadas em Customer, a tabela listará todos os valores de Sales para Astrida e Betacab e assim por diante. Os resultados de Rank(Sales) mostrarão 10 para o valor 12,9 de Sales para o valor 13 de Sales, e assim por diante, com o valor de classificação de 1 retornado para o valor 78 de Sales. O próximo segmento de coluna começa com Betacab, para o qual o primeiro valor de Sales no segmento é 12. O valor da posição de Rank(Sales) para este é dado como 11.

Se a tabela for classificada em Sales, os segmentos da coluna consistirão nos valores de Sales e do Customer correspondente. Como existem dois valores de 12 de Sales (para Astrida e Betacab), o valor de Rank(Sales) para esse segmento de coluna é 1-2, para cada valor de Customer. Isso ocorre pois existem dois valores de Customer para o valor de 12 de Sales. Se existissem 4 valores, o resultado seria 1-4 para todas as linhas. Isso mostra qual seria o resultado para o valor padrão (0) do argumento fmt.

Exemplo 2:

Substitua a dimensão Customer por Product e adicione a medida `Rank(Sales,1,2)`.

Isto retorna 1 na primeira linha em cada segmento de coluna e deixa todas as outras linhas em branco, pois os argumentos mode e fmt são definidos para 1 e 2, respectivamente.

` `

**Dados usados nos exemplos:**

`ProductData:` `Load * inline [` `Customer|Product|UnitSales|UnitPrice` `Astrida|AA|4|16` `Astrida|AA|10|15` `Astrida|BB|9|9` `Betacab|BB|5|10` `Betacab|CC|2|20` `Betacab|DD|0|25` `Canutility|AA|8|15` `Canutility|CC|0|19` `] (delimiter is '|');` ` ` `Sales2013:` `crosstable (Month, 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 '|');` ` `

## Saiba mais

* [Sum - função de gráfico](https://help.qlik.com/pt-BR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/BasicAggregationFunctions/sum.htm)