# 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://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/qeFxB8IvFMzSteImKxP0/grafik.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/JAU0Hu0zSmJxRSuaLiml/grafik.png" 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://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/4jntN5IH40qG0o42HOWq/grafik.png" 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://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/Hjhov6qdST99sQsGFcNn/grafik.png" alt=""><figcaption></figcaption></figure>