As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Computação das melhores classificações
<a name="top-ranked-function"></a>

A computação de classificação superior localiza as dimensões melhor classificadas por valor. Por exemplo, é possível criar uma computação para localizar os três estados com maior receita de vendas. 

Para usar essa função, você precisa de pelo menos uma dimensão no campo **Categories (Categorias)**. 

## Parâmetros
<a name="top-ranked-function-parameters"></a>

*name*   
Um nome descritivo exclusivo que você atribui ou altera. Um nome será atribuído se você não criar o seu próprio. Você poderá editar isso mais tarde.

*Categoria*   
A dimensão da categoria que você deseja classificar. 

*Valor*   
A medida agregada na qual a computação é baseada. 

*Number of results (Número de resultados)*   
O número de itens de classificação superior que você quer encontrar.

## Saídas das computações
<a name="top-ranked-computation-outputs"></a>

Cada função gera um conjunto de parâmetros de saída. Você pode adicionar essas saídas às narrativas automáticas para personalizar a exibição. Você também pode adicionar seu próprio texto personalizado. 

Para localizar os parâmetros de saída, abra a guia **Computations (Computações)** à direita, e localize a computação que você deseja usar. Os nomes das computações derivam do nome fornecido ao criar o insight. Escolha o parâmetro de saída clicando nele apenas uma vez. Se você clicar duas vezes, a mesma saída será adicionada duas vezes. Os itens exibidos em **negrito** podem ser usados na narrativa. 

**nota**  
Esses são os mesmos parâmetros de saída que os retornados pela computação de classificação inferior.
+ `categoryField`: da fonte do campo **Categorias**.
  + `name`: o nome de exibição formatado do campo.
+ `metricField`: da fonte do campo **Valores**.
  + `name`: o nome de exibição formatado do campo.
  + `aggregationFunction`: a agregação usada para a métrica (**SUM**, **AVG** e assim por diante).
+ `itemsCount`: o número de itens incluídos na computação.
+ `items`: Itens de classificação superior.
  + `categoryField`: o campo da categoria.
    + `value`: o valor (conteúdo) do campo da categoria.
    + `formattedValue`: o valor formatado (conteúdo) do campo da categoria. Se o campo for nulo, ele exibirá '`NULL`'. Se o campo estiver vazio, ele exibirá '`(empty)`'.
  + `metricValue`: o campo da métrica.
    + `value`: o valor bruto.
    + `formattedValue`: o valor formatado pelo campo da métrica.
    + `formattedAbsoluteValue`: o valor absoluto formatado pelo campo da métrica.