# RANGETOHIERARCHY

#### Syntax

**RANGETOHIERARCHY**(*range;* *numLevels; numExpandLevels; aggregationType*)

1. *range* - den Bereich, der die Hierarchieinformationen enthält - ***Wertetyp**: Bereich*
2. *numLevels* - die Anzahl der Spalten am Anfang des Bereichs, der die Hierarchie definiert - ***Wertetyp**: Zahl*
3. *numExpandedLevels* - die Anzahl der Ebenen der Hierarchie, die erweitert werden sollen - ***Wertetyp**: Zahl(optional, Standardwert: numLevels)*
4. *aggregationType* - gibt an, wie leere Werte in den zusätzlichen Spalten der Hierarchie aggregiert werden sollen - ***Wertetyp**: Text (optional, Standardwert: “none”)*\
   Mögliche Werte sind:
   1. "none" - keine zusätzliche Aggregation
   2. "sum" - die Summe der Kind-Elemente wird verwendet
   3. "min" - das Minimum der Kind-Elemente wird verwendet
   4. "max" - das Maximum der Kind-Elemente wird verwendet
   5. "avg" - der Mittelwert der Kind-Elemente wird verwendet

#### Rückgabe

Die Funktion liefert einen Bereich zurück mit

* der Hierarchieebene in der ersten Spalte
* der Anzeigename in der nächsten Spalte (extrahiert aus den ersten numLevels-Spalten des Bereichs)
* alle übrigen Spalten von *range*
* alle Ebenen bis zu *numExpandedLevel* sind aufgeklappt, alle anderen Ebenen sind zugeklappt

#### Beispiele

In den folgenden Beispielen ist das Widget auf der linken Seite ein Tabellen-Widget vom Typ "Hierarchy".

*Beispiel 1* - Die gesamte Tabelle wird als Hierarchie verwendet.

<figure><img src="https://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-b840fb8323fb34af77e8cad69cb9ff571ae9eb4b%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>

*Beispiel 2* - wie Beispiel 1, aber mit einer zusätzlichen Spalte, die Werte für die Hierarchie enthält.

<figure><img src="https://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-33ed4ab42e4476dad10c6573eaaba0031618c435%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>

*Beispiel 3* - Die Hierarchie wird nur durch die ersten 3 Spalten definiert. Die restlichen 2 Spalten werden zu jeder Zeile der Hierarchie hinzugefügt.

<figure><img src="https://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-84c4a509e37887acc5c2526ae035a05de7cf0596%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>

*Beispiel 4* - Parameter 3 legt fest, dass nur die ersten beiden Ebenen der Hierarchie standardmäßig aufgeklappt sind.

<figure><img src="https://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-f323855ff984bbc840cb0207e23d1cd57cf035d7%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>