Какво представлява преобразуването от JSON в Excel
Страницата json-to-excel приема един JSON файл, преобразува го в Excel файл (XLSX) и показва визуализация на резултата. След като качите файла, инструментът чете JSON структурата, я сплесква в плоска таблица и ви позволява да изтеглите готовия работен лист. На екрана се показват броят на редовете и колоните в получената таблица, както и размерът на изходния файл.
Процесът е напълно клиентски – всички операции се извършват във вашия браузър. Нито един байт от вашия файл не напуска компютъра ви. Това е важно за потребители, които работят с чувствителни данни от API отговори или конфигурации.
Какво отличава този инструмент от други конвертори
Основната разлика е, че JSON е йерархичен и типизиран формат, докато Excel таблицата е плоска и двуизмерна. JSON може да съдържа обекти, масиви, числа, булеви стойности и null, но един работен лист не може директно да представи вложена структура. Инструментът прилага правило за сплескване (flattening), което не е необходимо при конвертиране от CSV или от друг Excel файл – тези формати вече са плоски.
При преобразуване на масив от обекти всеки обект се превръща в ред, а ключовете му – в заглавия на колони. Ако в обекта има вложени обекти (например {"address": {"city": "София"}}), техните ключове се разширяват с път с точки (dot‑path) – например address.city. Така се запазва информацията за оригиналната йерархия, макар и в плоска форма.
Освен това целевият формат XLSX е ZIP архив, съдържащ XML файлове, и може да съхранява типовете данни на JSON директно – числата остават числа, булевите стойности остават true/false, а null полетата се записват като празни клетки. За разлика от CSV, който превръща всичко в текст, XLSX запазва типа на данните. Важно уточнение: инструментът не пренася формули, стилове или форматиране – записва само видимите статични данни от JSON източника.
Входове и изходи
Вход: един JSON файл (само един файл наведнъж). JSON трябва да бъде „табличен“ – масив от обекти или масив от масиви. Ако подадете произволен обект или стойност, която не може да се представи като таблица, инструментът ще изведе грешка.
Изход: XLSX файл с един работен лист. Визуализацията показва първите редове, за да можете да прецените дали сплескването е минало успешно.
Ограничения (според съобщенията за грешки):
- Файлът трябва да е под определена максимална големина (точният лимит зависи от реализацията, но сайтът показва съобщение „Използвайте файл под ‹max›“).
- JSON трябва да е валиден и табличен. Ако не е, получавате: „Този JSON е невалиден или не е табличен“.
- Броят на редовете и колоните също имат горни граници. При превишаване се показват съответните съобщения: „Тази таблица има повече от ‹max› редове“ или „Тази таблица има повече от ‹max› колони“.
- Ако JSON масивът е празен, се появява „Този файл няма таблични редове“.
- При анулиране на операцията или прекалено дълго време за обработка: „Конвертирането бе анулирано“ / „Това конвертиране отнема твърде много време. Опитайте с по‑малък файл.“
- Ако не изберете файл: „Изберете първо един файл.“ Ако изберете неподходящ тип: „Изберете CSV, JSON или XLSX файл.“ (този инструмент очаква JSON, но съобщението обхваща и други формати на сайта).
Правила при конвертиране и гранични случаи
Масив от обекти
Ако JSON е [{"name": "Иван", "age": 30}, {"name": "Мария", "age": 25}], инструментът създава колони name и age и два реда. Вложен обект като {"address": {"city": "Пловдив"}} ще даде колона address.city.
Масив от масиви
Ако JSON е [["A", 1], ["B", 2]], той се третира като таблица: първият ред е ["A", 1], вторият – ["B", 2]. В този случай няма ключове за заглавия – колоните получават имена по подразбиране (например Column1, Column2). Разликата е важна: масивите не са обекти, така че не се прилага сплескване с точки.
Празни или липсващи полета
Ако един обект има липсващ ключ, в съответната клетка се записва празна стойност. Ако стойността е null, тя също се записва като празна клетка (XLSX разпознава null като липсваща стойност). Ако обектът съдържа булеви стойности (true/false), те се записват като булеви в XLSX, а не като текст. Числата запазват числовия си тип.
Само един работен лист
Инструментът създава само един работен лист. Ако JSON съдържа множество вложени масиви, които потенциално биха могли да образуват различни таблици, те няма да бъдат разпределени в отделни листове – цялата информация се сплесква в една плоска структура. Това е ограничение, което произтича от природата на конвертирането от йерархичен към табличен формат.
Формули и форматиране
Тъй като входът е JSON (който не съдържа формули или стилове), изходният XLSX също няма такива. Дори ако някога сте опитвали да конвертирате обратно от Excel в JSON, този инструмент работи само в посока JSON → Excel и не пренася никакви метаданни освен данните.
Кой се нуждае от този инструмент
Инструментът е полезен за всеки, който работи с йерархични данни в JSON (например отговори от REST API, конфигурационни файлове, резултати от NoSQL бази данни) и иска да ги анализира или сподели като електронна таблица.
- Анализатори на данни, които трябва бързо да сплескат вложени JSON обекти без да пишат персонализиран код.
- Хора, които получават JSON файлове от колеги или системи, и трябва да ги предадат на екипи, работещи с Excel.
- Всеки, който иска да запази типовете данни (числа, булеви стойности) в изхода, вместо да ги загуби чрез CSV конвертиране.
- Тестери и разработчици, които валидират API отговори, като ги преглеждат в табличен вид.
Технически детайли: JSON структура и XLSX формат
JSON и неговите типове
JSON (JavaScript Object Notation) поддържа шест типа стойности: обекти, масиви, низове, числа, булеви стойности (true/false) и null. Обектите са неподредени колекции от двойки ключ-стойност, масивите са подредени списъци. При конвертиране в плоска таблица всяка двойка ключ-стойност от обект се превръща в клетка, а вложените обекти се разширяват с път с точки. Този подход е стандартен за инструменти като jq или Pandas json_normalize, но тук е имплементиран директно в браузъра.
XLSX – повече от просто таблица
XLSX (Office Open XML Spreadsheet) е ZIP архив, съдържащ XML файлове, които описват работните листове, стиловете, типовете клетки и формулите. За разлика от CSV, който записва всичко като текст, XLSX може да съхранява числови стойности (стандарт IEEE 754 с плаваща запетая), булеви стойности, дати и низове. Инструментът json-to-excel използва тази възможност, за да запише числата като числа, а булевите стойности като булеви. Това е значително предимство при последващ анализ в Excel, тъй като не се налага ръчно преобразуване на текст към числа.
Защо не всички JSON структури могат да бъдат представени
Плоска таблица не може да представи произволна йерархия. Например обект, който съдържа вложени масиви с различна дължина, ще доведе до много повторения на данни (денаризация) или загуба на информация. Инструментът изисква JSON да бъде „табличен“ – масив от обекти с еднакви (или почти еднакви) ключове. Ако подадете дълбоко вложен обект като {"a": {"b": {"c": 1}}}, той ще бъде сплескан, но ще се получи единичен ред и една колона a.b.c. Ако имате масив от такива обекти с различни структури, някои колони ще останат празни. При много дълбоки вложености е по-добре първо да трансформирате данните в подходяща форма чрез скрипт.
Често задавани въпроси (FAQ)
1. Какво означава „JSON не е табличен“?
Инструментът очаква JSON, който може да бъде представен като таблица – най-често масив от обекти (всеки обект става ред). Ако подадете единичен обект, низ или число, получавате грешка. Пример за невалиден вход: {"name": "Иван"} (не е масив). Пример за валиден: [{"name": "Иван"}].
2. Защо в изходния Excel има колони с имена като address.city?
Това е резултат от сплескване на вложени обекти. Ключът address съдържа обект с ключ city. За да се избегне загуба на информация, инструментът обединява пътя с точка. Така можете да разберете, че стойността идва от address.city в оригиналния JSON.
3. Мога ли да конвертирам обратно от Excel в JSON с този инструмент? Не. Този инструмент работи само от JSON към Excel. На същия сайт може да има отделна страница за обратна конвертация, но тук не се поддържа.
4. Какво става с null стойностите в JSON?
Те се записват като празни клетки в XLSX. Ако имате колона, в която някои редове са null, а други имат стойности, в Excel тези клетки ще изглеждат празни.
5. Има ли ограничение за размера на файла? Да. Инструментът показва съобщение „Този файл е твърде голям. Използвайте файл под ‹max›.“ Точната стойност на лимита зависи от браузъра и паметта, но сайтът го посочва в съобщението. Обикновено файловете до няколко мегабайта се обработват бързо.
6. Защо броят на редовете в прегледа е различен от очаквания? Възможно е JSON масивът да съдържа елементи, които не са обекти (например числа или низове). Те не могат да бъдат представени като редове с колони и вероятно се игнорират или водят до грешка. Уверете се, че всички елементи на масива са обекти или всички са масиви, но не смесени типове.