RANGETOJSON

Konvertiert einen Bereich von Zellen in einen json-Text.

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.

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.

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

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

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.