NumBase

取得目前成員或指定成員的基礎成員數量。此函數可用於下列規則類型中:

  • 計算

  • 轉譯

  • 整合

  • 配置

    註:

    如果成員沒有子項,即為基礎成員 (也就是位於樹狀階層中分支的末端)。

語法

HS.<Object>.NumBase("Element")
HS.Node.NumBase("S#Scenario.Y#Year.P#Period.E#Entity")
HS.<Object>.NumBase("")
HS.Custom(Dimension).NumBase(Member)

註:

使用空白字串 ("") 將此函數套用到目前的成員。

表格 11-37 NumBase 函數的語法

參數 描述

<Object>

下列物件關鍵字之一:

  • Account

  • Custom1...4

  • 自訂 (自訂維度標籤)

  • Entity

  • Parent

  • Node

Element

依照選取的物件,下列維度之一的有效成員名稱如下所示:

  • Account

  • Custom1...4

  • 自訂

  • Entity

  • Parent

  • Node

對於 Account 和自訂物件,您必須指定成員,不能使用空白字串。

若要取得整個維度中的基礎成員數,請在雙引號內指定 ALL,如下列範例所示:

iAcctBase = HS.Account.NumBase("ALL")

Scenario

有效 Scenario 維度成員的名稱。

Year

有效年度。

Period

有效期間。

Entity

有效 Entity 維度成員的名稱。

您也可以在 Exp 函數中內嵌 NumBase 函數。如果內嵌了 NumBase 函數請勿使用雙引號將 NumBase 的引數括起,如下列範例所示:

HS.Exp "A#AverageSales = A#Sales/HS.Entity.NumBase(Regional)"

傳回值

表示基礎成員數量的長整數。若為「節點」,則會取得指定成員的作用中基本元素的數量。

註:

如果基礎實體在分支中出現兩次,則會將該實體計數兩次。

範例

在下列範例中,應用程式包含名為 SalesAlloc 的帳戶,其中儲存了位於 Regional 實體下基礎實體的平均銷售額。為計算 SalesAlloc 數額,本範例會將 Sales 帳戶的數額,除以 Regional 下的基礎實體數量。

If HS.Exp"A#SalesAlloc = A#Sales/HS.Entity.NumBase(Regional)" then
  ...
End If
If HS.Exp"ASalesAlloc = A#Sales/HS.Custom("Prod").NumBase("TotalProducts")
...
End If