XML in JSON umwandeln: Schritt-für-Schritt-Anleitung

Wer aus einer alten SOAP-Schnittstelle Daten in eine moderne JavaScript-Anwendung holen will, steht früher oder später vor derselben Aufgabe: XML in JSON umwandeln. Diese Anleitung erklärt zuerst kurz, was XML und JSON eigentlich sind, zeigt dann an einem Mini-Beispiel, wie das Mapping funktioniert, und führt Sie in drei Schritten durch die Konvertierung mit dem Browser-Tool von xml-json.de. Vorkenntnisse brauchen Sie keine.

Was ist XML und was ist JSON?

XML (Extensible Markup Language) ist eine Auszeichnungssprache, die das W3C 1998 standardisiert hat. Daten werden in verschachtelten Tags abgelegt, jedes Element hat ein öffnendes und ein schließendes Tag, zusätzlich kann es Attribute und Namespaces tragen. XML war jahrzehntelang das Rückgrat von Web Services (SOAP), Konfigurationsdateien, RSS-Feeds und Dokumentformaten wie DOCX.

JSON (JavaScript Object Notation) ist ein deutlich schlankeres Datenformat, das auf der Objekt-Syntax von JavaScript beruht. Es kennt nur eine Handvoll Bausteine: Objekte (geschweifte Klammern), Arrays (eckige Klammern), Strings, Zahlen, die Wahrheitswerte true und false sowie null. JSON ist in ECMA-404 und RFC 8259 spezifiziert und hat sich als Standardformat für moderne REST- und GraphQL-APIs durchgesetzt, weil es kompakter und direkt in fast jeder Programmiersprache lesbar ist.

Beim Umwandeln geht es also darum, die Tag-Struktur von XML in die Objekt-Struktur von JSON zu überführen. Das ist meist verlustfrei möglich, an ein paar Stellen sind allerdings Konventionen nötig, weil XML Dinge ausdrücken kann, die JSON von Haus aus nicht kennt. Mehr dazu gleich.

Der häufigste Grund für eine Umwandlung ist die Modernisierung: Eine ältere Schnittstelle liefert XML, die neue Anwendung erwartet aber JSON. Statt den XML-Baum mühsam von Hand zu durchsuchen, übersetzt man ihn einmal nach JSON und arbeitet danach mit den vertrauten Mitteln der jeweiligen Programmiersprache weiter. Ein zweiter typischer Fall ist die reine Lesbarkeit: JSON ist für Menschen oft schneller zu erfassen als tief verschachteltes XML mit langen Tag-Namen. Drittens spielt die Größe eine Rolle, denn JSON kommt ohne schließende Tags aus und ist dadurch in der Regel kompakter, was bei der Übertragung über das Netz Bandbreite spart.

So läuft die Umwandlung ab

Technisch passieren beim Konvertieren drei Dinge: Das XML wird zu einem Baum geparst (DOM), dieser Baum wird nach den Mapping-Regeln in JSON-Strukturen übersetzt, und das Ergebnis wird formatiert ausgegeben. Beim Browser-Tool geschieht das vollständig auf Ihrem Gerät:

Ein Mini-Beispiel: vom XML zum JSON

Sehen wir uns ein kleines, vollständiges Beispiel an. Links steht ein XML-Dokument mit einem Buch, das ein Attribut und zwei Unterelemente hat, rechts das Ergebnis nach der Umwandlung:

<?xml version="1.0"?>
<buch jahr="2024">
  <titel>XML lernen</titel>
  <autor>A. Beispiel</autor>
</buch>

{
  "buch": {
    "@jahr": "2024",
    "titel": "XML lernen",
    "autor": "A. Beispiel"
  }
}

Drei Dinge fallen auf: Das Attribut jahr wird zur Eigenschaft @jahr mit @-Präfix, damit es nicht mit echten Unterelementen verwechselt wird. Die Unterelemente titel und autor werden zu normalen JSON-Eigenschaften. Und die Jahreszahl bleibt als String "2024" erhalten, weil XML keine Datentypen kennt. Genau diese drei Konventionen entscheiden über ein sauberes Ergebnis.

Das @-Präfix ist dabei keine offizielle Vorschrift, sondern eine etablierte Konvention. Sie ist nötig, weil JSON keinen Unterschied zwischen einem Attribut und einem Kindelement kennt. Ohne ein solches Kennzeichen ließe sich aus dem JSON nicht mehr rekonstruieren, ob jahr ursprünglich ein Attribut oder ein verschachteltes Element war. Wer das JSON später wieder zurück in XML übersetzen möchte, ist auf diese Markierung angewiesen. Manche Konventionen wie Badgerfish verwenden statt @ auch andere Zeichen, das Prinzip bleibt aber identisch.

Würde man die Jahreszahl automatisch in die echte Zahl 2024 umwandeln, wäre das hier unkritisch. Bei Werten wie einer Postleitzahl "01067" ginge bei einer naiven Typumwandlung jedoch die führende Null verloren, und aus einer Artikelnummer wie "007" würde plötzlich 7. Deshalb verhält sich ein vorsichtiger Konverter standardmäßig konservativ und liefert Strings. Wenn Sie sicher sind, dass Ihre Daten echte Zahlen enthalten, können Sie die Typinferenz gezielt einschalten oder die betroffenen Felder im Nachhinein im Code umwandeln.

In 3 Schritten: XML mit dem Tool umwandeln

Für die Praxis brauchen Sie keine Bibliothek zu installieren. So konvertieren Sie Ihr XML mit dem kostenlosen Online-Tool von xml-json.de:

1. XML einfügen. Kopieren Sie Ihr XML in das linke Eingabefeld des Konverters oder ziehen Sie eine .xml-Datei per Drag-and-drop hinein. Wenn Sie nur ausprobieren wollen, laden Sie über den Beispiel-Button ein fertiges Demo-XML.
2. Konvertieren. Klicken Sie auf Konvertieren. Das Tool parst das XML, wendet die Mapping-Regeln an und zeigt das formatierte JSON sofort rechts an. Ist das XML fehlerhaft, etwa wegen eines nicht geschlossenen Tags, bekommen Sie eine klare Fehlermeldung statt eines kaputten Ergebnisses.
3. Kopieren oder herunterladen. Übernehmen Sie das Ergebnis mit einem Klick in die Zwischenablage oder laden Sie es als .json-Datei herunter. Bei Bedarf schalten Sie zwischen schön formatierter und minifizierter Ausgabe um.

Die wichtigsten Mapping-Regeln auf einen Blick

Damit Sie das Ergebnis richtig deuten, hier die gängigen Übersetzungsregeln. Sie folgen weitgehend der verbreiteten Konvention, wie sie auch Bibliotheken wie xml2js oder fast-xml-parser nutzen: