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.
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:
| 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. 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. 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:
| 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 '|');
