Зошто JSON во Excel бара посебен пристап
Конвертирањето на JSON податоци во Excel табела не е едноставно пресликување на еден формат во друг. JSON е дизајниран да претставува хиерархиски и типизирани структури – може да содржи вгнездени објекти, низи, броеви, булови вредности и null. Excel табелата, од друга страна, е рамна дводимензионална мрежа од ќелии каде секоја колона има едноставно име, а секој ред претставува еден запис. Оваа фундаментална разлика значи дека секој JSON-во-Excel конвертор мора да примени правило за флатирање на хиерархијата. На оваа страница, правилото е проширување на вгнездените клучеви со точки (dot-path), како на пример address.city. Ова е единствениот начин да се претстави повеќенивовска структура во една рамна табела.
Додека конверзијата од CSV или Excel во JSON не бара вакво флатирање бидејќи тие формати се веќе рамни, JSON-во-Excel секогаш го содржи овој чекор. Дополнително, целниот формат XLSX е зипувана XML работна книга која може изворно да складира типови податоци како броеви и булови вредности, за разлика од CSV кој сè сведува на текст. Алатката не пренесува никакви формули или стилизирање на ќелии – запишува само видливи, статички податоци од изворниот JSON.
Структура на JSON и нејзиното влијание врз конверзијата
JSON-от поддржува четири примитивни типа: низи (strings), броеви (numbers), булови вредности (true/false) и null. Низи (arrays) и објекти (objects) се сложени типови кои можат да се вгнездуваат еден во друг. За да може JSON-от да се конвертира во табела, тој мора да биде „table‑shaped“ – односно да претставува низа од објекти или низа од низи.
Кога внесениот JSON е низа од објекти, секој објект се третира како ред во табелата, а клучевите на објектите стануваат имиња на колони. Ако објектите имаат вгнездени објекти, нивните клучеви се прошируваат со точкасти патеки. На пример, JSON објект како {"user": {"name": "Ana", "age": 30}} ќе произведе две колони: user.name и user.age. Низите во рамките на објект, како {"items":} не се прошируваат во повеќе редови – тие се запишуваат како текстуална низа во една ќелија. Оваа страница ги флатира само вгнездените објекти, додека низите на примитивни типови се запишуваат како текстуални вредности во една ќелија.
Ако JSON-от е низа од низи, секоја внатрешна низа станува еден ред, а колоните се именуваат со броеви (0, 1, 2,...) или со заеднички шаблон. Ова е едноставна табела без имиња на колони, но алатката сепак ја третира како валиден влез.
Флатирање: како вгнездените податоци стануваат колони
Флатирањето со точкасти патеки е единствениот начин да се претстави вгнездена хиерархија во рамна табела. Разгледајте го следниов JSON објект:
{
"id": 1,
"name": "Marko",
"address": {
"street": "Partizanska",
"city": "Skopje",
"coordinates": {
"lat": 41.998,
"lng": 21.425
}
}
}
Во излезната табела, колоните ќе бидат: id, name, address.street, address.city, address.coordinates.lat и address.coordinates.lng. Секој ред ќе содржи вредности за секоја од овие колони. Ако некој објект нема вредност за одреден вгнезден клуч (на пример, ако coordinates недостасува), соодветната ќелија останува празна. Null вредностите исто така се запишуваат како празни ќелии.
Оваа постапка значи дека длабочината на вгнездување директно влијае на бројот на колони. Ако различни објекти во низата имаат различни клучеви, збирот на сите можни точкасти патеки станува множество колони. За објекти кои имаат низи од објекти (на пример, contacts: [{"type": "email", "value": "a@b.com"},...]), алатката обично ги претвора во повеќе колони со броеви (како contacts.0.type, contacts.0.value, contacts.1.type итн.) или ги отфрла ако структурата е премногу сложена. Во овој случај, алатката создава точкасти патеки и за индексирани елементи на низи, но само ако тие се објекти.
XLSX форматот и зачувувањето на типовите податоци
XLSX е стандарден формат на Microsoft Excel базиран на Open XML. Датотеката е всушност ZIP архива која содржи XML датотеки кои ги опишуваат листовите, ќелиите, типовите на податоци и форматирањето. За разлика од CSV, кој сè запишува како текстуални низи, XLSX може да складира броеви како IEEE 754 floating-point, булови вредности како true/false и датуми како сериски броеви.
Кога JSON содржи нумеричка вредност (на пр. "age": 30), таа се запишува директно како број во XLSX ќелијата. Истото важи и за булови вредности ("active": true). Ова значи дека Excel може да ги препознае и да врши пресметки без потреба од конверзија. За разлика од CSV, каде 30 би се запишал како текст "30" и би барал рачна конверзија во број, XLSX го зачувува типот.
Алатката не создава формуларни ќелии, не применува стилови, бои, задебелување или граници. Секоја ќелија содржи само вредност и нејзиниот тип. Ако JSON содржи null, ќелијата останува празна – не се запишува ништо. Ова е во согласност со очекувањата на Excel, кој празна ќелија третира како null, а не како нула или празна низа.
Правила, ограничувања и пораки за грешки
Конверзијата се извршува целосно во прелистувачот на клиентот – ниту една датотека не се испраќа до сервер. Ова обезбедува приватност на податоците. Алатката прикажува специфични пораки кога наидува на проблем:
- Неподдржан формат: ако датотеката не е CSV, JSON или XLSX, се прикажува „Choose a CSV, JSON or XLSX file.“
- Големина на датотека: ако датотеката ја надминува поставената граница од 8 MB, се прикажува „This file is too large. Use a file under ‹max›.“
- Невалиден JSON: ако JSON-от не може да се парсира или не е во форма на низа од објекти/низа од низи, се прикажува „This JSON is invalid or not table‑shaped.“
- Без табеларни редови: ако датотеката нема редови со податоци, се прикажува „This file has no table rows.“
- Премногу редови или колони: ако добиената табела има повеќе од 10.000 редови или 200 колони, се прикажува соодветна порака.
- Откажување од корисник: ако корисникот го прекине процесот, се прикажува „Conversion cancelled.“
- Временско ограничување: ако конверзијата трае повеќе од околу 12 секунди, се прикажува „This conversion is taking too long. Try a smaller file.“
Кој има корист од оваа алатка
Оваа страница е наменета за секој што работи со хиерархиски JSON податоци и сака да ги анализира или сподели како Excel табела без да пишува сопствен код на Python или JavaScript. Примерна публика вклучува:
- Аналитичари на податоци кои добиваат JSON од API (на пр. од Shopify, Stripe, или Google Analytics) и треба да го увезат во Excel за да извештат или да направат pivot табели.
- Тимови кои соработуваат – еден член внесува податоци во JSON, а друг во Excel; алатката обезбедува брза транзиција без губење на типовите податоци.
- Програмери кои треба да го проверат содржината на JSON-от од конфигурациски датотеки или API одговори во познат табеларен преглед.
- Секој што сака да го зачува буловиот и нумеричкиот тип – за разлика од CSV, XLSX не ги претвора сите вредности во текст.
Често поставувани прашања
Зошто моите вгнездени објекти се појавуваат како колони со точки?
Ова е последица на флатирањето. Бидејќи Excel табелата не поддржува вгнездени колони, единствениот начин да се зачува хиерархијата е да се комбинираат имињата на клучевите со точка како разделник. На пример, address.city значи дека во оригиналниот JSON постои клуч address кој содржи објект со клуч city.
Дали моите податоци се безбедни при конверзија?
Да. Конверзијата се извршува целосно во вашиот прелистувач. Ниту една датотека не се испраќа до надворешен сервер. Ова значи дека чувствителните податоци (како API клучеви, лични информации) остануваат само на вашиот уред.
Што ако мојот JSON содржи низа од низи, а не објекти?
Алатката го третира секој елемент од надворешната низа како ред, а внатрешните низи стануваат колони без имиња. На пример, [[1, "a"], [2, "b"]] ќе создаде две колони (0 и 1) и два реда.
Зошто добивам грешка „This JSON is invalid or not table‑shaped“?
Најчести причини се: JSON-от не е валиден (има синтаксичка грешка), не е низа од објекти/низи, или содржи само еден објект без да биде во низа (на пр. {"id": 1} наместо [{"id": 1}]). Проверете дали коренскиот елемент е низа.
Која е максималната големина на датотеката?
Алатката прикажува грешка ако датотеката е поголема од 8 MB. Поголемите датотеки се одбиваат со порака: „This file is too large. Use a file under ‹max›.“.
Дали конверзијата ги зачувува нумеричките вредности или ги претвора во текст?
XLSX форматот изворно поддржува нумерички типови. Ако JSON содржи број (без наводници), тој се запишува како број во Excel. Истото важи и за boolean вредностите (true/false). Ова е клучна предност во споредба со CSV, каде сè би станало текст.