Convertor Excel în JSON

Ce face această pagină și de ce este diferită

Pagina de conversie Excel în JSON primește un fișier XLSX și produce un fișier JSON care conține datele din prima foaie de lucru sub formă de tabel structurat. Conversia se execută integral în browser – niciun octet din fișier nu este trimis către vreun server. Aceasta este diferența fundamentală față de majoritatea instrumentelor online, care stochează temporar datele utilizatorului pe un server terță.

Ceea ce face această pagină cu adevărat distinctă este modul în care tratează tipurile de celule. Un fișier XLSX este o arhivă ZIP care conține fișiere XML: o foaie de lucru poate conține celule cu tipuri numerice, booleene, dată, text sau formule. La rândul său, JSON este un format structurat care suportă nu doar șiruri de caractere, ci și numere, valori booleene (true/false) și null. Astfel, atunci când convertim din XLSX în JSON, valorile numerice reale (de exemplu 42, 3.14) rămân numere în JSON, nu sunt forțate să devină șiruri între ghilimele. Aceasta este o îmbunătățire semnificativă față de CSV, care serializează totul ca text.

Cum funcționează conversia în browser

Procesul începe atunci când utilizatorul încarcă un fișier XLSX fie prin drag‑and‑drop, fie prin selectorul de fișiere. Fișierul este citit de browser, care apoi parsează conținutul și extrage valorile celulelor.

Instrumentul citește doar prima foaie de lucru din workbook. Dacă fișierul are mai multe foi, celelalte sunt ignorate. Aceasta este o limitare intenționată: majoritatea utilizatorilor care doresc o conversie rapidă au datele în prima foaie. Pentru a accesa date din alte foi, este nevoie de o conversie separată sau de unelte specializate.

Valorile vizibile sunt cele care ajung în JSON. Dacă o celulă conține o formulă (de exemplu =A1+B1), instrumentul nu calculează din nou rezultatul – folosește valoarea salvată la momentul ultimei salvări a fișierului XLSX. Acest lucru este important de reținut: formulele nu sunt evaluate; orice celulă care depinde de date care nu au fost salvate va apărea ca null sau cu valoarea goală.

Stilizarea celulelor (fonturi, culori, borduri), celulele îmbinate și formatarea condiționată sunt toate aruncate. JSON nu are concepte de prezentare vizuală, așa că aceste detalii nu pot fi păstrate. Dacă aveți un tabel cu celule îmbinate pe mai multe rânduri sau coloane, rezultatul JSON va reflecta doar conținutul celulei din colțul din stânga sus al intervalului îmbinat – restul celulelor vor fi goale.

Maparea tipurilor de celule în JSON

Hai să vedem cum se face corespondența între tipurile de celule XLSX și tipurile JSON.

Observați că datele sunt convertite în șiruri de caractere standardizate ISO 8601. JSON nu are un tip nativ pentru date, așa că singura modalitate de a păstra o dată este ca șir. Dacă aveți nevoie de o reprezentare numerică (timestamp Unix) sau un alt format, va trebui să faceți o prelucrare ulterioară.

Celulele cu text lung, conținând caractere Unicode sau diacritice (de exemplu „ș”, „ț”, „ă”), sunt păstrate corect, deoarece JSON suportă Unicode. Fiți atenți la codificarea fișierului XLSX sursă – majoritatea aplicațiilor moderne salvează în UTF‑8, dar unele aplicații mai vechi pot folosi codificări diferite, ceea ce poate duce la caractere corupte.

Reguli și cazuri limită importante

Există mai multe situații în care conversia poate eșua sau produce rezultate neașteptate. Iată cele mai frecvente:

• Fișierul nu poate fi deschis: Dacă XLSX-ul este corupt sau are o structură invalidă, apare mesajul „This Excel file could not be opened.”.
• Nicio linie de date: Dacă prima foaie de lucru nu conține niciun rând cu date (de exemplu doar anteturi sau celule goale), se afișează „This file has no table rows.”.
• Limite de mărime și număr de rânduri/coloane: Dacă fișierul depășește 8 MB, apare „This file is too large. Use a file under ‹max›.”.
• Prea multe rânduri sau coloane: Dacă tabelul are mai mult de 10.000 de rânduri sau 200 de coloane, conversia este oprită.
• Format greșit: Dacă se încearcă încărcarea unui fișier care nu este CSV, JSON sau XLSX, apare „Choose a CSV, JSON or XLSX file.”.
• Eșec general de conversie: Mesajul „Could not convert this file.” este folosit pentru cazurile care nu se încadrează în celelalte categorii.
• Anulare de către utilizator: Dacă utilizatorul întrerupe conversia, se afișează „Conversion cancelled.”.
• Timeout: „This conversion is taking too long. Try a smaller file.” apare atunci când procesarea durează mai mult de aproximativ 12 secunde.

Un alt aspect subtil: dacă tabelul XLSX nu este strict dreptunghiular (de exemplu, anteturi care se întind pe mai multe rânduri sau coloane lipsă), instrumentul va crea automat coloane suplimentare pentru a umple golurile. Rândurile cu date incomplete vor conține null pentru celulele lipsă. De regulă, prima linie a foii de lucru este tratată ca antet și devine cheia obiectelor JSON. Dacă antetul conține celule goale, acestea vor fi transformate în chei precum "Column1", "Column2" etc.

Cine are nevoie de acest instrument

• Dezvoltatorii web care primesc date de produs într-un tabel Excel și trebuie să le transforme în JSON pentru o API REST sau o aplicație front-end. În loc să scrie manual un script de parsare, pot folosi această conversie rapidă, în special atunci când datele sunt confidențiale (nu ajung pe niciun server).
• Analiștii de date care trebuie să prelucreze un raport trimestrial (XLSX) într-un format pe care unelte de procesare a datelor (de exemplu, Pandas, d3.js) îl înțeleg nativ. Conversia directă în JSON le permite să păstreze tipurile numerice booleene fără a fi nevoiți să le convertească manual din șiruri.
• Echipele care colaborează cu parteneri externi care preferă JSON în loc de Excel, fie pentru integrare în sisteme de tip ETL, fie pentru documentare. O singură conversie poate fi suficientă, fără a instala software dedicat.
• Utilizatorii preocupați de confidențialitate care nu doresc ca un fișier cu date sensibile (de exemplu, salarii, clienți, date personale) să fie încărcat pe servere terțe. Deoarece totul rulează local, riscul de scurgere este zero.

Întrebări frecvente (FAQ)

1. Pot converti un fișier XLSX cu mai multe foi de lucru? Nu, instrumentul citește doar prima foaie de lucru. Pentru a converti o altă foaie, va trebui să o salvați separat ca fișier XLSX nou și apoi să o încărcați.

2. Ce se întâmplă cu datele din celulele îmbinate? Doar conținutul celulei din colțul din stânga sus al intervalului îmbinat este păstrat. Celelalte celule din interval apar ca șiruri goale în JSON.

3. Pot păstra formatarea (culori, fonturi) în JSON? Nu. JSON este un format de date, nu de prezentare. Toate informațiile de stil sunt eliminate.

4. Cum sunt tratate formulele? Formulele nu sunt calculate. Se folosește valoarea salvată la momentul ultimei salvări a fișierului. Dacă formula depinde de date care nu au fost salvate, celula va fi goală sau va conține null.

5. Există o limită de mărime a fișierului? Da, fișierul nu trebuie să depășească 8 MB. De asemenea, există limite pentru numărul de rânduri (10.000) și coloane (200). Dacă sunt depășite, veți primi un mesaj de eroare.

6. Cum pot verifica dacă datele convertite sunt corecte? Instrumentul oferă o previzualizare a rezultatului (primele 8 rânduri și 8 coloane), alături de numărul de rânduri și coloane și dimensiunea fișierului JSON. Puteți verifica manual câteva înregistrări. Fiți atenți în special la date, care sunt convertite în șiruri ISO 8601, și la valorile booleene, care trebuie să fie true sau false, nu "true" sau "false".