實作用於變更資訊的變數

您可以使用 Essbase 替代變數作為定期變更資訊的預留位置。由於變數值的變更會反映在使用變數的任何地方,因此需要將手動更新最小化。

例如,許多報表取決於報表期間;如果您根據目前月份產生報表,則每個月必須手動更新報表指令碼。使用在 Essbase 伺服器上設定的替代變數 (例如 CurMnth),您可以將每個月的指派值變更為適當的時間週期。當您在報表指令碼中使用變數名稱時,資訊會在您執行最終報表時動態更新。

您可以在下列區域中同時使用聚總儲存 (ASO) 和區塊儲存 (BSO) 應用程式 (除非另有說明) 的替代變數:

  • 彙總儲存大綱公式

  • 區塊儲存體大綱公式

  • 計算指令碼 (僅限區塊儲存資料庫)

    計算指令檔支援替代變數與執行時期替代變數。

  • 資料載入規則檔案表頭定義與欄位定義。您可以輸入維度和成員名稱的變數名稱。

  • SQL 資料來源之規則檔案中的資料來源名稱 (DSN) 規格

  • SQL 資料來源之規則檔案中的 SELECT、FROM 或 WHERE 子句

  • 安全性篩選器

  • MDX 查詢

  • 智慧型檢視

  • 報表命令檔

您可以在下列層次設定替代變數:

  • 全域:可讓您從 Essbase 伺服器上的所有應用程式和資料庫存取變數。

  • 應用程式:提供從應用程式內所有資料庫存取變數的功能。

  • 資料庫:存取指定資料庫內的變數。

允許的替代變數名稱與值

當您在 Essbase 中使用替代變數時,請遵循與可用於替代變數名稱和值的字元和資料類型相關的準則。

下列限制適用於替代變數名稱與值:

變數名稱中允許的字元

允許使用文數字字元和底線,但不能使用特殊字元或空格。字元數限制:請參閱限制

變數值中允許的字元

除了前置 & 符號 (&) 之外,允許使用任何字元。字元數限制:請參閱限制

用作變數值的 Essbase 成員名稱

將開頭為數字或包含任何特殊字元的成員名稱放在區塊儲存資料庫的引號 (" ") 中,以及括號 ([ ]) 中用於聚總儲存資料庫。如需詳細資訊,請參考計算指令檔、報表指令檔、公式、篩選和替代和環境變數值中的命名慣例

若要將替代變數值設定為重複成員名稱,請使用以雙引號括住的合格成員名稱;例如,&Period 的值可以是 "[2022].[Qtr1]"

請勿使用替代變數名稱作為限定成員名稱的一部分。例如,指定 "[2022].[&CurrentQtr]" 是無效的。

用作變數值的數字

以引號 (" ") 括住區塊儲存 (BSO) 資料庫的數值,並以括號 ([ ]) 括住聚總儲存 (ASO) 資料庫。

例如,如果變數名稱為 Month,且其值為 01,則對於區塊儲存,請將值設定為 "01"。若為聚總儲存,請將值設為 [01]

多個相同名稱的變數

只要變數是在不同的範圍中定義,變數的名稱即可。變數解析優先順序的運作方式如下:資料庫變數會在應用程式變數之前解析。應用程式變數會在全域變數之前解析。

建立或設定替代變數

設定替代變數之前,請參閱允許的替代變數名稱與值

您可以在 Essbase 伺服器、應用程式或資料庫層級建立或設定替代變數。

若要確保新的替代變數值可用於公式、分割區定義和安全性篩選器,請停止並重新啟動應用程式。使用替代變數時,會動態解析所有其他用法。

當您新增或更新替代變數時,這些變數會傳送至應用程式並動態解析。

若要使用 Essbase Web 介面設定替代變數,請參考使用替代變數。您也可以使用應用程式工作簿在應用程式層次設定變數,或使用下列 MaxL 敘述句:

移除替代變數

您可能要刪除不再需要的 Essbase 替代變數。

若要刪除替代變數,您可以將它從應用程式工作簿中移除並建置立方體、使用 Essbase Web 介面將其刪除,或使用這些 MaxL 陳述式:

更新替代變數

由於替代變數是變更資訊的預留位置,因此您可能需要經常更新其值。您可以使用 MaxLEssbase Web 介面來修改現有的替代變數。

若要更新替代變數,您可以使用下列其中一個 MaxL 陳述式 (要使用的陳述式取決於變數的環境定義):

如果您想要使用 Essbase Web 介面來更新變數,請參考使用替代變數以取得指示。