JSON to CSV: JSON átalakítása CSV-be és vissza

A JSON a webes alkalmazások és API-k közös nyelve: rendelések, termékek, felhasználók, mérési adatok jönnek így egy rendszerből. Embernek azonban nehéz átlátni, és a táblázatkezelők sem nyitják meg közvetlenül. A CSV ezzel szemben egy egyszerű, soronkénti táblázat, amelyet az Excel, a Google Táblázatok és a legtöbb adatelemző program gond nélkül beolvas.

A JSON to CSV átalakító ezt a lépést végzi el: egy objektumokból álló tömbből minden objektum egy sor, minden mező egy oszlop lesz. Az első sor a fejléc, a mezők nevével. Ha az objektumok mezői eltérnek, az átalakító az összes előforduló mezőből közös oszlopsort készít, a hiányzó értékek helyén üres cellával.

Az átalakítás gépelés közben történik, és az eredmény alatt látod, hány sor és hány oszlop keletkezett. JSON- vagy CSV-fájlt közvetlenül is megnyithatsz, az eredményt pedig letöltheted.

A JSON-ban az értékek maguk is objektumok vagy tömbök lehetnek, a táblázatban viszont minden cella egyetlen érték. Az átalakító ezért:

• a beágyazott objektumokat pontozott oszlopnevekre bontja: a {"cim": {"irsz": "1011", "varos": "Budapest"}} mezőből cim.irsz és cim.varos oszlop lesz;
• az egyszerű értékekből álló tömböket vesszővel elválasztva egy cellába írja: ["pdf", "kép"] → „pdf, kép”;
• az objektumokat tartalmazó tömböket JSON-szövegként egy cellába teszi, hogy ne vesszen el adat.

Ha a JSON nem tömb, hanem egy objektum, amelynek egyetlen tömb mezője van (sok API így válaszol, például {"data": [...]}), az átalakító automatikusan azt a tömböt használja.

A CSV neve „comma-separated values”, vagyis vesszővel elválasztott értékek, a magyar nyelvű Excel azonban a pontosvesszőt várja elválasztónak, mert a vessző nálunk a tizedesjel. Ha vesszővel elválasztott CSV-t nyitsz meg magyar Excelben, minden adat egy oszlopba kerül. Ezért az átalakító alapértelmezett elválasztója a pontosvessző.

Cél	Elválasztó
Magyar Excel	pontosvessző
Angol nyelvű Excel, programok, adatbázisok	vessző
Ha az adatokban sok vessző és pontosvessző is van	tabulátor

Az értékeket, amelyek elválasztót, idézőjelet vagy sortörést tartalmaznak, az átalakító idézőjelbe teszi, ahogy a CSV-szabvány előírja, így ezek sem esnek szét.

Visszafelé az első sort fejlécnek tekinti, és minden további sorból egy objektumot készít a fejléc mezőneveivel. Az elválasztót felismeri, de kézzel is megadhatod. A számok és a true/false felismerése bekapcsolva a csak számjegyekből álló értékeket számként, a tizedesvesszős magyar számokat (12,5) is helyes számértékként, a true és false értékeket logikai értékként írja a JSON-ba. Kikapcsolva minden érték szöveg marad, ami akkor jobb, ha például irányítószámokat vagy vezető nullás kódokat tartalmaz az adat.

Az eredmény szépen formázott, kétszóközös behúzású JSON, amelyet programba, API-kérésbe vagy konfigurációs fájlba illeszthetsz.

Bemenet:

[{"nev": "Kiss Anna", "varos": "Budapest", "kor": 34, "cim": {"irsz": "1011"}},
 {"nev": "Nagy Béla", "varos": "Győr", "kor": 41, "cim": {"irsz": "9021"}}]

Eredmény pontosvesszővel:

nev;varos;kor;cim.irsz
Kiss Anna;Budapest;34;1011
Nagy Béla;Győr;41;9021

A letöltött CSV UTF-8 kódolású, így az ékezetes betűk megmaradnak. Ha egy régebbi Excel mégis furcsa jeleket mutat, a CSV-megnyitó eszközzel Excel-barát (BOM-os) változatot menthetsz.

Ha a JSON hibás, az átalakító kiírja a hiba okát; a JSON formázó eszköz pontos sor- és oszlopszámot is ad, és tippet a javításhoz. Nagyon nagy, több tíz megabájtos fájloknál a böngésző memóriája szabhat határt. Az átalakítás nem módosítja az adatokat: a dátumokat, pénzösszegeket szövegként vagy számként viszi át, ahogy a JSON-ban szerepelnek.

Tipp: ha az adatot rendszeresen kell átalakítanod, például minden héten ugyanabból az API-ból, érdemes a lépést automatizálni; egy-egy alkalmi exporthoz viszont ez a leggyorsabb út. A JSON-t a böngésződ alakítja CSV-vé, ezért éles adatbázis-exportot vagy ügyféladatokat is átalakíthatsz anélkül, hogy kiadnád őket.