

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 dos produtos com maior rotatividade
<a name="top-movers-function"></a>

A computação dos produtos com maior rotatividade conta o número solicitado de categorias por data que estão classificados na parte superior do conjunto de dados da narrativa automática. Por exemplo, é possível criar uma computação para encontrar os principais produtos por receita de vendas por determinado período.

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

## Parâmetros
<a name="top-movers-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ê deseja encontrar.

## Saídas das computações
<a name="top-movers-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 transportadores inferiores.
+ `timeField`: da fonte do campo **Hora**.
  + `name`: o nome de exibição formatado do campo.
  + `timeGranularity`: a granularidade do campo de hora (**DIA**, **ANO** e assim por diante).
+ `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).
+ `startTimeValue`: o valor na dimensão da data.
  + `value`: o valor bruto.
  + `formattedValue`: o valor formatado pelo campo de data e hora.
+ `endTimeValue`: o valor na dimensão da data.
  + `value`: o valor bruto.
  + `formattedValue`: o valor absoluto formatado pelo campo de data e hora.
+ `itemsCount`: o número de itens incluídos na computação.
+ `items`: Itens de movimentaçã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)`'.
  + `currentMetricValue`: o valor atual para 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.
  + `previousMetricValue`: o valor anterior para 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.
  + `percentDifference`: a diferença percentual entre os valores atuais e anteriores do campo da métrica.
    + `value`: o valor bruto do cálculo da diferença percentual.
    + `formattedValue`: o valor formatado da diferença percentual (por exemplo, -42%).
    + `formattedAbsoluteValue`: o valor absoluto formatado da diferença percentual (por exemplo, 42%).
  + `absoluteDifference`: a diferença absoluta entre os valores atuais e anteriores do campo da métrica.
    + `value`: o valor bruto do cálculo da diferença absoluta.
    + `formattedValue`: a diferença absoluta formatada pelas configurações das preferências de formato do campo da métrica.
    + `formattedAbsoluteValue`: o valor absoluto da diferença formatada pelo campo da métrica.