IsDescendant

判斷目前成員或指定成員是否為指定父項的子代。此函數可用於下列規則類型中：

  • 計算

  • 轉譯

  • 整合

  • 配置

    註：

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

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


階層中的子代

語法

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

註：

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

表格 11-33 IsDescendant 函數的語法

參數 描述

<Object>

下列物件關鍵字之一：

  • Account

  • Custom1...4

  • 自訂 (自訂維度標籤)

  • Entity

  • Parent

Parent

有效父項成員的名稱。父項為必需。

Element

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

  • Account

  • Custom1...4

  • 自訂

  • Entity

  • Parent

Entity

有效 Entity 維度成員的名稱。

Scenario

有效 Scenario 維度成員的名稱。

Year

有效年度。

Period

有效期間。

註：

將節點當作物件時，本函數會判斷成員是否為指定父項的作用中子代。

傳回值

如果元素是指定父項的子代，則布林值運算式為 True；如果元素不是指定父項的子代，則布林值運算式為 False。

若為「節點」，如果元素是指定父項的作用中子代，則布林運算式為 True；如果元素不是指定父項的作用中子代，則布林運算式為 False。

範例

在下列範例中，如果 Connecticut 是 Regional 的子代，則會執行 If...Then 和 End If 行之間的陳述式。

If HS.Entity.IsDescendant("Regional","Connecticut") = TRUE Then
  ...
End If
If HS.Custom("Prod").IsDescendant("All_Phones", P3000_Phones")
...
End If