# JSONTORANGE

#### Syntax

**JSONTORANGE**(*values*, *keys*)&#x20;

1. *json* - ein Text im json-Format, aus dem der Inhalt als Bereich extrahiert wird - *Wertetyp: **Text***

#### Remarks

* In dem Ergebnisbereich werden nur die obersten 1-2 Ebenen der json-Zeichenfolge in Zellinhalte umgewandelt
* Der Inhalt der unteren Ebene (Ebene 3-n) bleibt als Sub-Json-Text in den Zellen des Ergebnisbereichs erhalten. Diese Sub-Jsons können dann durch nachfolgende Aufrufe der Funktion JSONTORANGE extrahiert werden

#### Beispiele

**Beispiel 1**: Der json-Text enthält ein einzelnes json-Objekt. Es werden nur die Werte (values) im Ergebnisbereich zurückgegeben.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/ViMad45oblvM6Penb0TP/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 2** - Die json-Datei enthält mehrere Objekte. Sie werden als Zeilen des Ergebnisbereichs zurückgegeben.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/u6VhZrjJS1snipoR9VnH/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 3** - Die json-Datei enthält ein Array mit Werten. Jedes Element des Arrays wird als neue Zeile in den Ergebnisbereich eingefügt.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/3wdUBeRDdG07ccf8xjBt/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 4** - Die json-Datei enthält ein in ein Array verschachteltes Array. In diesem Fall werden die Elemente des inneren Arrays in einer Zeile im Rückgabe-Bereich zurückgegeben.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/I1S0DZOoUcwKFmg0m5zF/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 5** - Die json-Datei enthält mehrere in einem Array verschachtelte Arrays. Die Elemente der einzelnen inneren Arrays werden als separate Zeilen im Ergebnisbereich zurückgegeben.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/W0ZlbghHS9FbNrOEfBI6/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 6** - Die json-Datei enthält zwei Arrays und ein Objekt, das in ein Array eingebettet ist. Die Elemente der beiden Arrays und des Objekts werden als separate Zeilen im Ergebnisbereich zurückgegeben.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/oo8rj5nIvKAxN8smGbN1/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 7** - Wenn die json-Datei eine Struktur mit mehr als 2 Ebenen enthält, ist es möglich, den Inhalt der untergeordneten Werte durch nachfolgende Aufrufe der Funktion JSONTORANGE zu extrahieren.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/i1p3KLwM5etlf2geOUtk/grafik.png" alt=""><figcaption></figcaption></figure>
