# 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2FOFi0RB8yIN1aMlEpUCGr%2Fgrafik.png?alt=media&#x26;token=d00bfb67-2b85-4c98-be9e-88ce6d345ecc" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2FADC4rWAqrhF7gtWQQ6SA%2Fgrafik.png?alt=media&#x26;token=6d462a5f-4b01-4059-8e0d-8ce5e6785e67" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2FxLjkOWht8nDlY2SOKyKs%2Fgrafik.png?alt=media&#x26;token=5557e0f5-aed5-4c3b-a209-85e67a0c9353" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2FzEYtAgDi6r4elDeToNv2%2Fgrafik.png?alt=media&#x26;token=3a2cbb23-dfef-41fb-98f2-58dd40f04b02" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2FjItj5OUXPzrPlLOe0uZf%2Fgrafik.png?alt=media&#x26;token=7afeb963-6703-4ec6-a987-ae1061f33af9" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2FzGfIJK3TDEo3LTngc4qZ%2Fgrafik.png?alt=media&#x26;token=51898572-1f1c-46f9-bb36-deeb5428b1e7" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2F84cLAN1LjRsJrCJNPF4A%2Fgrafik.png?alt=media&#x26;token=6e1f0362-19d1-4618-a1b7-6b3071194c59" alt=""><figcaption></figcaption></figure>
