NumDescendant

取得目前維度成員或指定成員的子代數量。此函數可用於下列規則類型中：

  • 計算

  • 轉譯

  • 整合

  • 配置

    註：

    如果某個成員在樹狀階層中的層級位於父項之下，則屬於子代。子代位於樹狀結構的同一個分支內。

例如，在下列階層中，FosterCity 和 Sunnyvale 是 California 和 UnitedStates 的子代。


階層中的子代

語法

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

註：

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

表格 11-39 NumDescendant 函數的語法

參數 描述

<Object>

下列物件關鍵字之一：

  • Account

  • Custom1...4

  • 自訂 (自訂維度標籤)

  • Entity

  • Node

  • Parent

Element

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

  • Account

  • Custom1...4

  • 自訂

  • Entity

  • Node

  • Parent

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

若要取得整個維度中的子代數量，請在雙引號內指定 ALL，如下列範例的引數所示：

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

Scenario

有效 Scenario 維度成員的名稱。

Year

有效年度。

Period

有效期間。

Entity

有效 Entity 維度成員的名稱。

傳回值

指定的成員的子代數量。若為節點，則為指定的成員下的作用中子代實體的數量。

註：

如果子代實體在分支中出現兩次，則會將該實體計數兩次。

範例

在下列範例中，如果實體 France 沒有子代，則會執行 If...Then 和 End If 陳述式之間的陳述式：

If HS.Entity.NumDescendant("France") = 0 Then
  ...
End If
If HS.Custom("Product").NumDescendant("P3000-Phones") = 0 Then
...
End If