# JSONTORANGE

#### Syntax

**JSONTORANGE**(*values*, *keys*)

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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-3be2c7212efec26d067073e36d7b5cc7c4e099a4%2Fgrafik.png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-e7c27fbc3e0b638fced9dda3877162ba9692bb3d%2Fgrafik.png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-e0aa87de944b8b3f2d46b03a6244fa26abc13af1%2Fgrafik.png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-6b2e489f0077375705914f564863f929d6373535%2Fgrafik.png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-63b377fac15b44afab24d329b8df94c47dbe9580%2Fgrafik.png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-aa6bc7629ef1bca0af1d34e45bd5766e44db4fe5%2Fgrafik.png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-62bd0662964171d435f18b8a585755a25cc8d55a%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>
