NumChild

Ruft die Anzahl der untergeordneten 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 einem anderen Element untergeordnet bezeichnet, wenn es sich in einer Baumhierarchie genau eine Ebene unterhalb dieses Elements befindet. Es werden nur die Elemente gezählt, die sich genau eine Ebene unter dem angegebenen Objekt befinden.

Syntax

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

Hinweis:

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

Tabelle 11-38 Syntax für die NumChild-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 untergeordneten Elemente in der gesamten Dimension abzurufen, geben Sie ALL wie in diesem Beispiel in Anführungszeichen an:

iAcctBase = HS.Account.NumChild("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.

Sie können die NumChild-Funktion in die Exp-Funktion einbetten. Wenn Sie die NumChild-Funktion einbetten, dürfen Sie das Argument der NumChild-Funktion nicht in Anführungszeichen setzen.

Rückgabewert

Eine Zeichenfolge, die die Anzahl der untergeordneten Elemente angibt. Bei Knoten wird die Anzahl der aktiven untergeordneten Elemente des angegebenen Elements abgerufen.

Beispiel

In diesem Beispiel enthält die Anwendung ein Konto namens SalesChild, in dem der durchschnittliche Umsatzbetrag der Entitys unmittelbar unterhalb der Entity Regional gespeichert ist. Um den Betrag des Kontos SalesChild zu berechnen, wird der Betrag des Kontos Sales durch die Anzahl der dem Element Regional direkt untergeordneten Elemente dividiert.

HS.Exp "A#SalesChild = A#Sales/HS.Entity.NumChild(Regional)"