TOML in JSON umwandeln: Anleitung für die Konvertierung

Wofür sich die Umwandlung eignet

Mit diesem Konverter übertragen Sie TOML-Konfigurationstext in eine JSON-Darstellung. Das ist hilfreich, wenn eine vorhandene Konfiguration in einem JSON-basierten Arbeitsschritt benötigt wird oder wenn Sie verschachtelte Einstellungen in dieser Form prüfen möchten. Unterstützt werden TOML-Grundwerte wie Zeichenfolgen, Zahlen und Wahrheitswerte sowie verschachtelte Tabellen. Vor der Umwandlung können Sie festlegen, wie stark die JSON-Ausgabe eingerückt wird. Zusätzlich lässt sich die Sortierung der Schlüssel zuschalten. So passen Sie vor allem die Lesbarkeit und die Darstellung an den vorgesehenen Zweck an, ohne den TOML-Text manuell neu aufzubauen. Eine leere Eingabe hat dabei eine eigene, erfolgreiche Bedeutung, die Sie bei der Prüfung des Ergebnisses berücksichtigen sollten.

Die Konvertierung durchführen

1. Fügen Sie den vollständigen TOML-Text in das Eingabefeld ein. Verwenden Sie dabei beispielsweise Zeichenfolgen, Zahlen, Wahrheitswerte und verschachtelte Tabellen, sofern diese zu Ihrer Konfiguration gehören.
2. Prüfen Sie die numerische Einstellung für die Einrückung. Wenn Sie nichts ändern, wird die JSON-Darstellung mit einer Einrückung von 2 erzeugt. Wählen Sie einen anderen Wert, wenn die Ausgabe für Ihre Weiterverarbeitung oder Kontrolle anders formatiert sein soll.
3. Schalten Sie die Option zum Sortieren der Schlüssel nur dann ein, wenn eine geordnete Darstellung für Ihren Zweck nützlich ist. Ohne diese Auswahl bleibt die Sortierung standardmäßig deaktiviert.
4. Starten Sie die Konvertierung und lesen Sie die erzeugte JSON-Darstellung. TOML-Werte für Datum, Uhrzeit oder Datum und Uhrzeit erscheinen darin als Zeichenfolgen im ISO-Format.
5. Lassen Sie das Feld leer, wenn Sie den Sonderfall einer leeren Konfiguration prüfen möchten. Auch eine Eingabe, die nur aus Leerzeichen besteht, kann erfolgreich verarbeitet werden.

Die Ausgabe sachgerecht prüfen

Bei einer erfolgreichen Umwandlung werden TOML-Grundwerte in entsprechende JSON-Daten übertragen. Eine verschachtelte Tabelle erscheint als verschachtelte JSON-Struktur, sodass die Beziehung zwischen übergeordneten und untergeordneten Einstellungen erhalten bleibt. Die Einrückung betrifft die Formatierung der Darstellung und hilft beim Lesen; sie beschreibt nicht eine zusätzliche inhaltliche Ebene. Die Sortieroption verändert die Anordnung der Schlüssel in der Ausgabe, wenn Sie sie aktivieren.

Beachten Sie außerdem den Unterschied zwischen leerem und fehlerhaftem Inhalt. Eine leere oder nur aus Leerzeichen bestehende Eingabe führt zu einer leeren JSON-Objektdarstellung. Enthält der Text dagegen einen TOML-Fehler, endet die Konvertierung erfolglos, anstatt eine konvertierte JSON-Darstellung zu liefern. Dasselbe gilt, wenn die JSON-Serialisierung scheitert. Ein Fehlschlag ist daher ein Anlass, zunächst Syntax und anschließend die Serialisierbarkeit der verwendeten Werte zu prüfen.

Praktisches Beispiel

Sie bereiten eine TOML-Projektkonfiguration für einen Verarbeitungsschritt vor, der eine JSON-Darstellung erwartet.

Fügen Sie eine Projektkonfiguration mit einer Server-Tabelle, einer Portnummer und einem Datum ein, übernehmen Sie die voreingestellte Einrückung und starten Sie die Konvertierung.

Die Ausgabe hat die Form eines JSON-Objekts mit einem verschachtelten Objekt für die Server-Tabelle. Ein enthaltenes TOML-Datum oder eine Zeitangabe erscheint darin als ISO-formatierte Zeichenfolge.

Einschränkungen

• Fehlerhaftes TOML führt zu einer erfolglosen Konvertierung. Auch ein Fehler bei der JSON-Serialisierung kann den Vorgang erfolglos beenden.

Häufige Fehler

• Ursache: Der eingefügte Text enthält einen TOML-Syntaxfehler, etwa in einer Tabelle oder bei einem Wert. Korrigieren Sie den Eingabetext und führen Sie die Umwandlung anschließend erneut aus.

Häufige Fragen

Was geschieht bei leerer TOML-Eingabe?

Eine leere oder ausschließlich aus Leerzeichen bestehende Eingabe wird erfolgreich verarbeitet. Das Ergebnis ist eine leere JSON-Objektdarstellung, nicht eine Fehlermeldung wegen fehlender Konfiguration.

Wie erscheinen TOML-Datums- und Zeitwerte in JSON?

TOML-Werte für Datum, Uhrzeit sowie Datum und Uhrzeit werden in der JSON-Darstellung als Zeichenfolgen im ISO-Format ausgegeben. Sie erscheinen daher nicht als eigenständige JSON-Datentypen.

Wird fehlerhaftes TOML automatisch repariert?

Bei fehlerhaftem TOML gibt es keine erfolgreiche konvertierte JSON-Darstellung. Prüfen Sie die Syntax und korrigieren Sie den Eingabetext, bevor Sie den Vorgang erneut starten.