YAML in JSON umwandeln: Anleitung für Deutschland

YAML in JSON umwandeln: Zweck und Einstellungen

Mit einem YAML-zu-JSON-Konverter übertragen Sie strukturierte YAML-Daten in JSON-Text. Das eignet sich etwa, wenn eine Konfigurationsdatei, ein Datenaustausch oder ein nachgelagerter Verarbeitungsschritt JSON erwartet. Die Eingabe erfolgt als YAML-Text; das Ergebnis wird als JSON ausgegeben.

Sie können dabei die Einrückung des JSON-Ergebnisses festlegen und die Schlüssel von JSON-Objekten optional sortieren. Die Standardeinstellung für die Einrückung beträgt 2, während die Sortierung zunächst ausgeschaltet ist. So lässt sich das Ergebnis je nach Lesbarkeit oder gewünschter Schlüsselreihenfolge anpassen.

YAML in JSON umwandeln: Schritt für Schritt

Öffnen Sie das Werkzeug und fügen Sie den zu verarbeitenden YAML-Text in das Eingabefeld ein. Achten Sie darauf, dass die Einrückung und die Struktur des YAML-Dokuments zusammenpassen.
Prüfen Sie die Ausgabeoption für die JSON-Einrückung. Übernehmen Sie die Voreinstellung, wenn eine Einrückung von 2 genügt, oder wählen Sie eine andere Einstellung, falls die Ausgabe anders formatiert werden soll.
Aktivieren Sie die Option zum Sortieren der Schlüssel nur dann, wenn die Schlüssel von JSON-Objekten in sortierter Reihenfolge erscheinen sollen. Ohne diese Auswahl bleibt die Sortierung deaktiviert.
Starten Sie die Konvertierung. Bei gültigem YAML wird JSON-Text erzeugt. Leeres oder nur aus Leerzeichen bestehendes Eingabefeld kann ebenfalls verarbeitet werden und führt zu einem leeren JSON-Objekt.
Kontrollieren Sie das Ergebnis als JSON-Text. Bei verschachtelten Zuordnungen und Sequenzen prüfen Sie insbesondere, ob die Objekt- und Listenstruktur Ihren Erwartungen entspricht. Mehrere YAML-Dokumente können als mehrere Dokumente eingelesen werden; daraus entsteht nur dann ein JSON-Array, wenn nach dem Entfernen leerer Dokumente mehr als ein gültiges Dokument übrig bleibt.

Ergebnis prüfen und Grenzen verstehen

Das Ergebnis ist JSON-Text, der aus den eingelesenen YAML-Werten erzeugt wird. Einfache Zuordnungen werden als JSON-Objekte dargestellt, verschachtelte Zuordnungen bleiben verschachtelt, und Sequenzen werden als JSON-Arrays ausgegeben. Die Darstellung kann durch die Einrückung beeinflusst werden; eine aktivierte Schlüsselsortierung ändert die Reihenfolge der Schlüssel in JSON-Objekten.

Bei mehreren Dokumenten gelten besondere Grenzen: Leere eingelesene Dokumente werden entfernt. Bleibt danach ein Dokument übrig, wird dieses einzelne Dokument ausgegeben; bleiben mehrere übrig, wird ein JSON-Array erzeugt. Bei einem ungültigen YAML-Dokument entsteht kein erfolgreiches JSON-Ergebnis. Dasselbe gilt, wenn der eingelesene Wert nicht als JSON serialisiert werden kann.

Die Konvertierung überträgt geparste Werte in JSON-Text. Kommentare, ursprüngliche Anführungszeichen und das ursprüngliche Präsentationslayout sollten daher nicht als Bestandteil der Ausgabe erwartet werden.

Praktisches Beispiel

Eine Entwicklerin möchte eine verschachtelte YAML-Konfiguration für einen Dienst an eine Schnittstelle übergeben, die JSON-Text erwartet.

Fügen Sie eine kurze YAML-Konfiguration mit dem Schlüssel „name“ und einer Liste unter „services“ ein, lassen Sie die Standardsortierung unverändert und starten Sie die Konvertierung. Prüfen Sie anschließend, ob die Liste als JSON-Array und die übrigen Daten als Objekt erscheinen.

Ein JSON-Objekt mit einem Textwert für „name“ und einem JSON-Array für „services“; die Darstellung richtet sich nach der gewählten Einrückung.

Einschränkungen

Das Werkzeug verarbeitet YAML-Eingabe und erzeugt JSON-Text. Es ist nicht als allgemeiner JSON-zu-YAML-Konverter beschrieben; Kommentare, ursprüngliche Anführungszeichen und das Präsentationslayout werden nicht als erhaltene Ausgabeeigenschaften zugesichert.

Häufige Fehler

Ursache: Das YAML ist syntaktisch fehlerhaft, häufig durch eine nicht passende Einrückung oder eine unvollständige Struktur. Korrektur: Überprüfen Sie die Einrückung und die YAML-Syntax, korrigieren Sie die Eingabe und starten Sie die Konvertierung erneut.

Häufige Fragen

Was passiert bei einer leeren YAML-Eingabe?

Bei leerem oder nur aus Leerzeichen bestehendem Eingabefeld wird ein leeres JSON-Objekt erzeugt. Bei nicht leerer Eingabe muss das YAML gültig sein, damit eine erfolgreiche JSON-Ausgabe entsteht.

Kann ich mehrere YAML-Dokumente umwandeln?

Ja, wenn mehrere nicht leere YAML-Dokumente übrig bleiben. Beginnt die Eingabe passend mit einer Dokumenttrennung und enthält sie weitere Dokumente, werden leere Dokumente entfernt; bei mehr als einem verbleibenden Dokument wird ein JSON-Array ausgegeben.

Werden JSON-Schlüssel automatisch sortiert?

Die Schlüsselreihenfolge kann sortiert werden, wenn Sie die entsprechende Option aktivieren. Standardmäßig ist diese Sortierung ausgeschaltet.