Konwerter XML na JSON

Konwerter XML na JSON online

Konwerter XML na JSON zamienia wklejony kod XML na JSON na bieżąco, w trakcie wpisywania. Elementy stają się kluczami obiektu, powtórzone elementy tworzą tablice, a atrybuty trafiają pod klucz „@attributes”. Wynik skopiujesz do schowka albo pobierzesz jako plik .json.

Uruchom konwerter XML to JSON

XML to JSON – prosty sposób na konwersję danych

XML (eXtensible Markup Language) od lat jest standardowym formatem wymiany danych w systemach biznesowych, integracjach i usługach sieciowych: w ten sposób zapisuje się kanały RSS, odpowiedzi SOAP, pliki JPK czy eksporty z systemów ERP. Współczesne aplikacje webowe i API dużo chętniej pracują jednak z JSON (JavaScript Object Notation), który jest lżejszy i łatwiejszy do przetwarzania w JavaScript, Pythonie, PHP i wielu innych językach.

Obok wyniku narzędzie pokazuje statystyki dokumentu: liczbę elementów (łącznie z głównym), liczbę atrybutów, głębokość zagnieżdżenia, rozmiar XML i JSON w KB oraz to, o ile procent JSON jest mniejszy lub większy od źródła. Przy błędzie składni zamiast wyniku dostajesz komunikat z numerem linii i kolumny, np. że znacznik otwarty jako <pozycja> zamknięto jako </pozycje> albo że znak & w treści trzeba zapisać jako &amp;.

Opcje konwersji

• Układ JSON. Standardowy to dokładnie wynik funkcji json_encode() z PHP dla dokumentu SimpleXML. Pełny zapisuje tekst stojący obok atrybutów pod kluczem „#text”, pusty element jako null i zachowuje elementy z prefiksem przestrzeni nazw, np. „dc:creator” z kanału RSS.
• Wcięcie: 4 spacje (domyślnie), 2 spacje, tabulator albo minifikacja do jednej linii, przydatna, gdy JSON ma trafić do treści żądania API.
• Typy wartości. Po zaznaczeniu „Zamień liczby i true/false na typy JSON” tekst „30” staje się liczbą 30, „2.5” liczbą 2.5, a „true” i „false” wartościami logicznymi. Kody z zerem na początku (007) i zapisy z końcowym zerem (1.50) zostają tekstem, żeby nie zgubić cyfr.

Jak korzystać z konwertera XML to JSON

1. Wklej dane XML
   Skopiuj zawartość pliku XML lub odpowiedź z API i wklej ją do pola „Kod XML” skrótem Ctrl+V albo przyciskiem „Wklej ze schowka”. Na próbę możesz wczytać jeden z trzech przykładów: osobę, zamówienie z atrybutami lub kanał RSS.
2. Ustaw opcje
   Wybierz układ, wcięcie i typowanie liczb. JSON przelicza się po każdej zmianie, a przycisk „Konwertuj na JSON” zatwierdza konwersję.
3. Skopiuj lub pobierz JSON
   Gotowy wynik skopiujesz do schowka albo zapiszesz jako plik konwersja.json i wkleisz do edytora kodu, systemu integracyjnego lub narzędzia do testowania API.

Limit wklejanego kodu to 2 MB.

Przykład: XML na JSON w praktyce

Fragment XML:

<user><id>123</id><name>Jan Kowalski</name><roles><role>admin</role><role>editor</role></roles></user>

Wynik w układzie standardowym, z minifikacją:

{"id":"123","name":"Jan Kowalski","roles":{"role":["admin","editor"]}}

Przy pierwszej konwersji zaskakują zwykle trzy rzeczy. Nazwa elementu głównego (user) nie trafia do JSON. Wartość „123” jest napisem, dopóki nie włączysz typowania liczb – wtedy dostajesz "id":123. Dwa elementy role tworzą tablicę wewnątrz obiektu roles, a nie płaską listę. Gdyby rola była tylko jedna, wynik miałby postać "roles":{"role":"admin"}, bez tablicy.

Układ standardowy a pełny

Różnice widać dopiero przy atrybutach, pustych elementach i przestrzeniach nazw. Dla prostych danych, jak w przykładzie wyżej, oba układy dają ten sam JSON.

Jeśli konwertujesz zamówienia, faktury lub kanały RSS, w których dane siedzą jednocześnie w atrybutach i w tekście, wybierz układ pełny.

Przykładowe zastosowania konwertera XML na JSON

XML i JSON – krótkie porównanie

XML i JSON rozwiązują ten sam problem – służą do uporządkowanego opisu danych, ale robią to w inny sposób. Z tych różnic wynika większość niespodzianek przy konwersji.

W praktyce często spotkasz się z sytuacją, w której źródło danych jest w XML, a docelowy system, biblioteka lub aplikacja wymaga JSON. Konwerter oszczędza wtedy pisania jednorazowego skryptu transformującego.

Typowe pułapki przy konwersji XML to JSON

• Jeden element czy tablica: element występujący raz jest zwykłą wartością, tablica powstaje dopiero od dwóch powtórzeń. Kod odbierający dane musi obsłużyć oba przypadki, np. opakować pojedynczą wartość w tablicę.
• Liczby jako tekst: bez typowania „30” zostaje napisem. Po włączeniu opcji kod pocztowy 31-147 nadal będzie tekstem, ale numer 123 już liczbą, więc sprawdź pola, które mają pozostać napisami.
• Kolejność elementów: elementy o tej samej nazwie są grupowane, więc sekwencja a, b, a nie zostaje zachowana. Dokumentów, w których kolejność niesie znaczenie, nie odtworzysz z takiego JSON-a.
• Encje HTML: &nbsp; nie istnieje w XML i kończy się błędem. Działają tylko &amp;, &lt;, &gt;, &quot;, &apos; i kody liczbowe, np. &#160;.
• Jeden element główny: dwa sąsiadujące elementy bez wspólnego rodzica to niepoprawny XML. Otocz całość jednym znacznikiem.