# RANGETOJSON

#### Syntax

**RANGETOJSON**(*values; keys*)

1. *values* - die Werte, die dem json-String hinzugefügt werden sollen - Wertetyp: beliebig 
2. keys - die Schlüssel-Werte, die dem json-String hinzugefügt werden - Wertetyp: Text (optional)

#### Bemerkungen

* Der json-String wird auf folgende Weise erstellt: 
  * Wenn *keys* angegeben ist, werden diese zusammen mit den *values* als Schlüssel-Wert-Paare auf folgende Weise in den json-String verpackt: 
    * Wenn *values* nur eine Zeile enthält, besteht der json-String aus einem Objekt, einschließlich der Schlüssel-Wert-Paare von *keys* und dem entsprechenden *values-*Wert. 
    * Wenn *values* mehrere Zeilen enthält, besteht der json-String aus einem Array mit einem Objekt pro Zeile, einschließlich der Schlüssel-Wert-Paare von *keys* und dem entsprechenden *value* (auf die gleiche Weise wie oben). 
  * Wenn *keys* nicht angegeben ist, werden *values* als Array-Elemente in den json-String gepackt, und zwar auf folgende Weise: 
    * jede Zeile von *values* wird als Element des Arrays hinzugefügt, 
    * wenn eine Zeile mehr als eine Zelle enthält, wird jeder Zellinhalt der Zeile als Element eines Unter-Arrays zum äußeren Array hinzugefügt.

#### Beispiele

**Beispiel 1** - Der Inhalt der Widgets *keys* und *values* wird verwendet, um den json-Text zu erstellen.

<figure><img src="/files/CTBb31Oe9kP8oDFjODbj" alt=""><figcaption></figcaption></figure>

**Beispiel 2 -** Dasselbe wie in Beispiel 1, aber das Widget #values enthält jetzt mehrere Zeilen. Jede Zeile wird dann als separates Objekt in den json-String eingefügt.

<figure><img src="/files/9WDaE0YhRrCa4DldgFgH" alt=""><figcaption></figcaption></figure>

**Beispiel 3**: Wenn keine *keys* angegeben werden, werden nur die *values* in den json-String eingefügt.

<figure><img src="/files/LUC6qEOBzOd3WHKqty5z" alt=""><figcaption></figcaption></figure>

**Beispiel 4** - Diese Struktur kann verwendet werden, um einen json-String mit nur einem Array zu erstellen, das Werte enthält.

<figure><img src="/files/Tb9u8lbMP0OyYn8OOe1T" alt=""><figcaption></figcaption></figure>

**Beispiel 5**: Wie in Beispiel 3, aber mit mehreren Zeilen in #values. Dies gibt dann einen json-String zurück, der ein verschachteltes Array von Werten enthält.

<figure><img src="/files/9R0rhamyV32LT4VRDuWU" 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.52-de-preview/clearlines-funktionen/bereichs-funktionen/rangetojson.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.