本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 頂端移動工具運算
<a name="top-movers-function"></a>

排名最高運算會依日期計算請求的類別數量 (在自動敘述資料集排名最高)。例如，您可以建立運算，依銷售營收尋找一段時間期間內位居頂端的產品。

若要使用此函數，您在 **Time (時間)** 欄位集至少需要有一個維度，在 **Categories (類別)** 欄位集至少需要有一個維度。

## Parameters
<a name="top-movers-function-parameters"></a>

*name*   
您指派或變更的唯一描述名稱。如果您未建立自己的名稱，則會指派一個名稱。您稍後可以編輯此名稱。

*類別*   
您想要排名的維度類別。

*Value*   
以此為基礎來運算的彙總度量。

*結果數量*   
您想要尋找的前幾項排名物品數量。

## 運算輸出
<a name="top-movers-computation-outputs"></a>

每個函數會產生一組輸出參數。您可以將這些輸出新增到自動敘述以自訂其顯示內容。您也可以新增自己的自訂文字。

若要尋找輸出參數，請開啟右側的**運算**標籤，並找出您想要使用的運算。運算的名稱是來自您建立洞見時所提供的名稱。選擇輸出參數 (僅按一下即可)。如果您按了兩下，您將新增兩次相同的輸出。以**粗體**顯示的項目為敘述中可用的項目。

**注意**  
這些輸出參數與底部移動器運算傳回的輸出參數相同。
+ `timeField`：為**時間**欄位集。
  + `name`：欄位的格式化顯示名稱。
  + `timeGranularity`：時間欄位精細程度 (**DAY**、**YEAR** 等)。
+ `categoryField`：為**分類**欄位集。
  + `name`：欄位的格式化顯示名稱。
+ `metricField`：為**數值**欄位集。
  + `name`：欄位的格式化顯示名稱。
  + `aggregationFunction`：用於指標 (**SUM**、**AVG** 等) 的彙總。
+ `startTimeValue`：日期維度的值。
  + `value`：原始值。
  + `formattedValue`：日期時間欄位格式化的值。
+ `endTimeValue`：日期維度的值。
  + `value`：原始值。
  + `formattedValue`：由日期時間欄位格式化的絕對值。
+ `itemsCount`：此運算中包含的項目數量。
+ `items`：頂端移動項目。
  + `categoryField`：類別欄位。
    + `value`：類別欄位的值 (內容)。
    + `formattedValue`：類別欄位格式化的值 (內容)。如果欄位為 null，這會顯示 '`NULL`'。如果欄位為，它會顯示 '`(empty)`'。
  + `currentMetricValue`：目前值欄位的指標。
    + `value`：原始值。
    + `formattedValue`：由指標欄位格式化的值。
    + `formattedAbsoluteValue`：由指標欄位格式化的絕對值。
  + `previousMetricValue`：指標欄位的之前值。
    + `value`：原始值。
    + `formattedValue`：由指標欄位格式化的值。
    + `formattedAbsoluteValue`：由指標欄位格式化的絕對值。
  + `percentDifference`：指標欄位目前和之前值的百分比差異。
    + `value`：百分比差異運算的原始值。
    + `formattedValue`：百分比差異的格式化值 (例如，-42%)。
    + `formattedAbsoluteValue`：百分比差異的格式化絕對值 (例如，42%)。
  + `absoluteDifference`：指標欄位目前和之前值之間的絕對差異。
    + `value`：絕對差異運算的原始值。
    + `formattedValue`：指標欄位格式偏好設定格式化的絕對差異。
    + `formattedAbsoluteValue`：由指標欄位格式化的差異絕對值。