ADD_DIM(引用維度+指定維度)

1.1 版本

1.2 函式簡介

函式傳回指定檢視表與函式宣告中的聯動維度集合，支援綁定動態維度機制。

1.3 注意事項

應用範圍：指標中心、組件（不包括明細表）

函式範圍：函式需要配合 def/window/field_in 使用；不支援在 def_add/def_sub 的維度參數中使用。

維度範圍：引用函式中可以宣告任何維度運算式

匹配規則：遵循「欄位ID」一致的規則，即同一個欄位即可匹配上。欄位設定了「自訂分組」或「時間分組」也能匹配。

1.4 檢視表概念

檢視表不是物理儲存的資料表，而是透過 SQL 查詢、資料模型或業務規則定義的 “虛擬表”。它動態映射底層資料源（如資料庫表、 Excel 檔案等），僅儲存查詢邏輯而非資料本身。為視覺化分析提供可直接呼叫的標準化業務語意資料表。

檢視表與物理表的對比：

「1.2 函式簡介」中提到的檢視表為計算檢視表，可以理解為計算中生成的虛擬結果表。我們目前有三種檢視表：

• 明細檢視表：可以理解為新增列計算場景，計算後結果粒度與明細表相同

• DEF檢視表：由 def 函式構造出來的獨立檢視表，計算後結果粒度與 def 中宣告的維度一致

例如，求 1 月各地區下部門的成本額 = DEF(SUM_AGG(成本),[地區,部門],[月份="2025-01"]

FineBI 無法直接查看 DEF 計算檢視表，虛擬表效果如下：

• 分析檢視表：根據分析區匯總計算後的檢視表，計算後結果粒度與分析區的維度一致

組件中除了「明細表」其他圖表都是構建的分析檢視表。

如何理解當前檢視表和外部檢視表？

• 欄位計算/分析所在的檢視表，為當前檢視表。

• 使用欄位再次參與計算/分析的檢視表，為外部檢視表。（相當於欄位血緣的子節點）

例如，動態銷售額=DEF(SUM_AGG(銷售額),[ADD_DIM()])

ADD_DIM() 所在的當前檢視表為「動態銷售額DEF檢視表」

把「動態銷售額」，put 命令分組表中，外部檢視表=分析檢視表

把「動態銷售額」，put 命令 DEF 中計算25年門店銷售額=DEF(SUM_AGG(動態銷售額),[門店],[年=2025]），外部檢視表=25年門店銷售額DEF檢視表

2.1 動態層級成本分析

如何在企業用「一份資料模型」適應不同分析層級的成本展示需求，無需切換資料源或計算欄位。查看從公司到個人層級的成本情況？

實現思路：

配合 FIELD_IN() 函式動態判斷計算檢視表是否引入了某維度。指標欄位用在組件（分析檢視表）中，則依據分析區維度進行成本計算。

設定鑽取目錄，逐層鑽取指標時，維度也在不斷變化，如果維度是「員工姓名」，則計算時使用「個人成本」，否則使用「公司成本」。

成本額=IF(FIELD_IN(ADD_DIM(), [員工姓名]), 個人成本, 公司成本)

詳情請參見文檔：動態層級維度成本分析

注：因為合計行的合計方式是「自動」，因此不依賴「員工姓名」，按月份和鑽取分組求合計，所以是展示「公司成本」。

2.2 動態為WINDOW/DEF引入分析區欄位 

前置條件：為保證外部檢視表是組件分析區，需下方匯出的計算欄位外面沒再嵌套 DEF 函式。

2.2.1 WINDOW函式

應用場景

WINDOW 無法動態查看不同維度的累計銷售額

運用 ADD_DIM 函式後，無需調整計算欄位，只需取代維度，即可查看相應的累計銷售額。

實現思路                                     

累計銷售額=WINDOW_SUM(SUM_AGG(銷售額),[ADD_DIM()],[SUM_AGG(銷售額),"asc"],["first",0])

操作步驟

IT在指標中心和資料目錄裏開發和管理該欄位：

1）點選「指標中心」，建立模型，新增資源。具體操作步驟見文檔：模型管理概述

2）新增指標「累計銷售額」，如下圖所示：

計算欄位：累計銷售額=WINDOW_SUM(SUM_AGG(銷售額),[ADD_DIM()],[SUM_AGG(銷售額),"asc"],["first",0])

具體操作步驟見文檔：指標管理概述

3）新增維度「大類」「產品名稱」「省份」「城市」，具體操作步驟見文檔：維度管理概述

4）新增指標集，包含指標「總銷售額」、維度「大類」「產品名稱」「省份」「城市」，並「發佈」到資料目錄，如下圖所示：

具體操作步驟見文檔：指標集概述

5）點選「資料目錄」，建立分析主題，如下圖所示：

效果預覽

IT在指標中心和資料目錄裏開發和管理該欄位後，其他企業使用者直接使用指標集做分析即可

將「省份」「城市」「總銷售額」拖入分析區，完成分析。如下圖所示：

維度切換：例如切換「省份」「城市」為「大類」「產品名稱」，會自動展示每個產品的總銷售額，如下圖所示：

2.2.2 DEF函式

組件存在計算欄位，動態銷售額=DEF(SUM_AGG(銷售額),[ADD_DIM()])

ADD_DIM() 從外部檢視表上找欄位

• 動態銷售額放置到分析區，外部為分析檢視表：動態銷售額 = DEF(SUM_AGG(銷售額),[分析區的維度欄位]) = DEF_ADD(SUM_AGG(銷售額),[])

• 動態銷售額作為聚合指標，放到新的「公式A」中進行DEF計算，外部檢視表為「公式A」：動態銷售額=DEF(SUM_AGG(銷售額),[公式A 的DEF檢視表維度參數內欄位])