# 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="/files/KcbWg0KTXp31L7qGKid8" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/lvjfE51jx4pWHBZGK1LE" 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="/files/ODPmuNAb8nynh9QuvPIp" 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="/files/WJNFctqEnJlwtBNXQZdO" 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="/files/unpL73OQiJinqYgZP3km" 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="/files/CLxJt9Av8yRv01puZ2Os" 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="/files/zdGSC8DMpVoy9DnsFcvy" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nedyx.com/version-1.83-de/nedyx/clearlines-funktionen/bereichs-funktionen/jsontorange.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.