NumDescendant

Ruft die Anzahl der abhängigen Elemente für das aktuelle oder ein angegebenes Dimensionselement ab. 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.


Abhängige Elemente in der Hierarchie

Syntax

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

Hinweis:

Verwenden Sie eine leere Zeichenfolge (""), um diese Funktion auf das aktuelle Element anzuwenden.

Tabelle 11-39 Syntax für die NumDescendant-Funktion

Parameter Beschreibung

<Object>

Eines der folgenden Objektschlüsselwörter:

  • Konto

  • Custom1...4

  • Custom(Custom Dimension Label)

  • Entity

  • Node

  • Parent

Element

Je nach ausgewähltem Objekt handelt es sich um den Namen eines gültigen Elements einer der folgenden Dimensionen:

  • Konto

  • Custom1...4

  • Custom

  • Entity

  • Node

  • Parent

Für Objekte der Dimension Account und Custom müssen Sie das Element angeben. Die Verwendung einer leeren Zeichenfolge ist nicht möglich.

Um die Anzahl der abhängigen Elemente in der gesamten Dimension abzurufen, geben Sie ALL wie in diesem Beispiel in Anführungszeichen an:

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

Scenario

Der Name eines gültigen Elements der Dimension Scenario.

Year

Ein gültiges Jahr.

Period

Eine gültige Periode.

Entity

Der Name eines gültigen Elements der Dimension Entity.

Rückgabewert

Die Anzahl der abhängigen Elemente des angegebenen Elements. Bei Knoten wird die Anzahl der aktiven abhängigen Entitys unterhalb des angegebenen Elements abgerufen.

Hinweis:

Ist eine abhängige Entity zwei Mal in einem Zweig vorhanden, wird die Entity doppelt gezählt.

Beispiel

Wenn die Entity France in diesem Beispiel keine abhängigen Entitys besitzt, werden Anweisungen zwischen den Anweisungen "If...Then" und "End If" ausgeführt.

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