Bestimmt, ob das aktuelle bzw. angegebene Element ein abhängiges Element des angegebenen übergeordneten Elements ist. Diese Funktion kann in den folgenden Regeltypen verwendet werden:
Berechnung
Umrechnung
Konsolidierung
Umlage
Hinweis:
Ein Element wird als abhängig von einem übergeordneten Element bezeichnet, wenn es sich in einer Baumhierarchie auf einer beliebigen Ebene unterhalb dieses Elements befindet. Abhängige Elemente befinden sich innerhalb desselben Zweiges der Baumhierarchie.
So sind beispielsweise in dieser Hierarchie FosterCity und Sunnyvale abhängige Elemente von California und UnitedStates.
Syntax
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)
Hinweis:
Verwenden Sie eine leere Zeichenfolge (""
), um diese Funktion auf das aktuelle Element anzuwenden.
Tabelle 11-33 Syntax für die IsDescendant-Funktion
Parameter | Beschreibung |
---|---|
<Object> |
Eines der folgenden Objektschlüsselwörter:
|
Parent |
Der Name eines gültigen übergeordneten Elements. Übergeordnetes Element muss angegeben werden. |
Element |
Je nach ausgewähltem Objekt handelt es sich um den Namen eines gültigen Elements einer der folgenden Dimensionen:
|
Entity |
Der Name eines gültigen Elements der Dimension Entity. |
Scenario |
Der Name eines gültigen Elements der Dimension Scenario. |
Year |
Ein gültiges Jahr. |
Period |
Eine gültige Periode. |
Hinweis:
Wenn Sie als Objekt Knoten verwenden, bestimmt die Funktion, ob das Element ein aktives abhängiges Element des angegebenen übergeordneten Elements ist.
Rückgabewert
Ein Boolescher Ausdruck, der True ist, wenn das Element ein abhängiges Element des angegebenen übergeordneten Elements ist. Der Wert lautet False, wenn das Element kein abhängiges Element des angegebenen übergeordneten Elements ist.
Bei Knoten ist der Ausdruck True, wenn das Element ein aktives abhängiges Element des angegebenen übergeordneten Elements ist, und False, wenn das Element kein aktives untergeordnetes Element des angegebenen übergeordneten Elements ist.
Beispiel
Wenn in diesem Beispiel Connecticut ein abhängiges Element von Regional ist, werden Anweisungen zwischen den Zeilen "If...Then" und "End If" ausgeführt.
If HS.Entity.IsDescendant("Regional","Connecticut") = TRUE Then
...
End If
If HS.Custom("Prod").IsDescendant("All_Phones", P3000_Phones")
...
End If