როგორ დავაკონვერტირო JSON ფორმატი Excel ფორმატში?

ჩააგდეთ თქვენი JSON ფაილი და დააჭირეთ კონვერტაციას — Excel ფაილი მზად იქნება ჩამოსატვირთად წამებში, შედეგის წინასწარი გადახედვის ფუნქციით. ყველაფერი მუშაობს ლოკალურად, თქვენს მოწყობილობაზე.

რა მაქსიმალური ზომის ფაილის კონვერტაცია შემიძლია?

8 მბ-მდე, 10 000 სტრიქონამდე და 200 სვეტამდე თითო ფაილზე. უფრო დიდი მონაცემთა ბაზები უმჯობესია წინასწარ დაიყოს მცირე ზომის ფაილებად.

JSON-ის Excel-ში კონვერტერი

JSON-Excel გადამყვანი: იერარქიული მონაცემების ბრტყელ ცხრილად გარდაქმნა

JSON-ის ბრტყელ ცხრილად გარდაქმნის მექანიზმი

ამ გვერდის მთავარი განსხვავება სხვა მსგავსი ხელსაწყოებისგან არის JSON-ის იერარქიული სტრუქტურის ბრტყელ ცხრილად გარდაქმნის კონკრეტული მეთოდი. JSON ფორმატი საშუალებას იძლევა ჩაბუდებული ობიექტებისა და მასივების გამოყენებას, რაც ბრტყელ ცხრილში პირდაპირ წარმოდგენა შეუძლებელია. ინსტრუმენტი იყენებს dot‑path (წერტილოვანი ბილიკის) მეთოდს: ყოველი ჩაბუდებული გასაღები იშლება ცალკე სვეტად, სადაც ბილიკი მითითებულია წერტილებით.

მაგალითად, განვიხილოთ JSON ობიექტი:

{
  "name": "ნინო",
  "address": {
    "city": "თბილისი",
    "street": "რუსთაველი"
  }
}

ეს ობიექტი გარდაიქმნება ცხრილის სამ სვეტად: name, address.city და address.street. ყოველი ობიექტი ხდება ერთი სტრიქონი, ხოლო მისი გასაღებები – სვეტების სათაურები. თუ JSON შეიცავს ობიექტების მასივს, მაგალითად:

[
  {"name": "გიორგი", "age": 30},
  {"name": "მარიამი", "age": 25}
]

თითოეული ობიექტი ხდება ცალკე სტრიქონი, ხოლო name და age – სვეტები.

როდესაც JSON-ში გვხვდება მასივების მასივი, მაგალითად:

[
  ["თბილისი", 1.2],
  ["ბათუმი", 0.8]
]

მთელი მასივი განიხილება როგორც ცხრილის სტრიქონი, ხოლო მისი ელემენტები – როგორც სვეტები. ამ შემთხვევაში, სვეტების სათაურები ავტომატურად ენიჭებათ ინდექსების მიხედვით (0, 1, 2...).

მონაცემთა ტიპების შენარჩუნება XLSX-ში

XLSX ფორმატი, რომელიც სინამდვილეში ZIP-ში შეკრული XML ფაილების კრებულია, ბუნებრივად ინახავს მონაცემთა ტიპებს – რიცხვებს, ტექსტს, ლოგიკურ მნიშვნელობებს (true/false) და თარიღებს. CSV ფორმატისგან განსხვავებით, რომელიც ყველაფერს ტექსტად გარდაქმნის, XLSX ინახავს თავდაპირველ ტიპს.

ინსტრუმენტი JSON-დან XLSX-ში გადაყვანისას ინარჩუნებს შემდეგ ტიპებს:

რიცხვები (integers and floats) – ინახება როგორც ციფრული მნიშვნელობა Excel-ის უჯრედში.
ლოგიკური მნიშვნელობები (true/false) – ინახება როგორც TRUE/FALSE.
null – იქცევა ცარიელ უჯრედად (Excel-ში ცარიელი უჯრედი).
ტექსტი (strings) – ინახება როგორც ტექსტი.

თუმცა, ინსტრუმენტი არ ინახავს Excel-ის ფორმულებს ან უჯრედების ფორმატირებას (ფერები, შრიფტები, საზღვრები). ის წერს მხოლოდ ხილულ სტატიკურ მონაცემებს JSON-დან. ასევე, ინსტრუმენტი გამოიმუშავებს მხოლოდ ერთ ფურცელს – არანაირი მრავალფურცლიანი სპრედშიტი, მიუხედავად იმისა, რომ XLSX ფორმატი მხარს უჭერს მრავალ ფურცელს.

"მაგიდის ფორმის" JSON-ის მოთხოვნა

ყველა JSON ფაილი არ არის ვარგისი გადაყვანისთვის. ინსტრუმენტი მოითხოვს JSON-ს იყოს "table‑shaped" – ანუ მაგიდის ფორმის. ეს ნიშნავს, რომ JSON უნდა იყოს:

ობიექტების მასივი – ყოველი ობიექტი ხდება სტრიქონი, ხოლო მისი გასაღებები – სვეტები.
მასივების მასივი – ყოველი შიდა მასივი ხდება სტრიქონი, ხოლო მისი ელემენტები – სვეტები.

თუ JSON ფაილი შეიცავს მხოლოდ ერთ ობიექტს (მაგ. {"name": "ნინო"}) ან მხოლოდ ერთ მასივს (მაგ. ``), ის ვერ გარდაიქმნება, რადგან არ აკმაყოფილებს "მაგიდის ფორმის" პირობას. ინსტრუმენტი გამოიტანს შეცდომის შეტყობინებას: "This JSON is invalid or not table‑shaped."

მაგალითი არასწორი JSON-ის:

{
  "name": "გიორგი",
  "age": 30
}

ეს ერთი ობიექტია – მას "მაგიდის ფორმა" არ აქვს. მასივში უნდა იყოს მოთავსებული:

[{
  "name": "გიორგი",
  "age": 30
}]

შეცდომის შეტყობინებები და მათი მიზეზები

ინსტრუმენტი იყენებს კონკრეტულ შეცდომის შეტყობინებებს, რომლებიც ზუსტად მიუთითებს პრობლემის ტიპს:

შეცდომის ტექსტი	მიზეზი
`"Choose one file first."`	მომხმარებელი ცდილობს გადაყვანის დაწყებას ფაილის არჩევის გარეშე.
`"Choose a CSV, JSON or XLSX file."`	ატვირთული ფაილის ფორმატი არ არის CSV, JSON ან XLSX.
`"This file is too large. Use a file under ‹max›."`	ფაილის ზომა აღემატება მაქსიმალურ დასაშვებ ზღვარს.
`"This JSON is invalid or not table‑shaped."`	JSON ფაილი ან არ არის ვალიდური (პარსინგის შეცდომა), ან არ აკმაყოფილებს "მაგიდის ფორმის" პირობას.
`"This file has no table rows."`	JSON ფაილი ცარიელია ან მასივი ცარიელი.
`"This table has more than ‹max› rows."`	გარდაქმნილ ცხრილში სტრიქონების რაოდენობა აღემატება მაქსიმუმს.
`"This table has more than ‹max› columns."`	გარდაქმნილ ცხრილში სვეტების რაოდენობა აღემატება მაქსიმუმს.
`"Conversion cancelled."`	მომხმარებელმა გააუქმა გადაყვანა.
`"This conversion is taking too long. Try a smaller file."`	დამუშავება აღემატება ლიმიტს (ჩვეულებრივ, განპირობებულია ძალიან დიდი ან რთული JSON-ით).

ყველა ეს შეტყობინება ჩნდება მხოლოდ მაშინ, როდესაც ინსტრუმენტი ცდილობს JSON-ის პარსინგს ან გადაყვანას. მაგალითად, თუ JSON ფაილს აქვს ზედმეტი მძიმე ან გაუხსნელი ფრჩხილი, გამოჩნდება "This JSON is invalid or not table‑shaped."

კლიენტის მხარეს დამუშავება: მონაცემთა კონფიდენციალურობა

JSON-Excel გადამყვანი მუშაობს მთლიანად ბრაუზერის მხარეს. ფაილი არ იტვირთება არც ერთ სერვერზე. ეს ნიშნავს, რომ:

არ საჭიროებს ინტერნეტ კავშირს (პირველი ჩატვირთვის შემდეგ).
მონაცემები არ ტოვებს თქვენს კომპიუტერს.
არ არსებობს მესამე მხარის მიერ მონაცემთა წვდომის რისკი.
JSON ფაილი იკითხება ბრაუზერის FileReader API-ს გამოყენებით, რომელიც საშუალებას იძლევა ფაილის შიგთავსის წაკითხვა მეხსიერებაში.

ეს მიდგომა განსაკუთრებით მნიშვნელოვანია, როდესაც JSON ფაილი შეიცავს მგრძნობიარე ინფორმაციას, როგორიცაა პირადი მონაცემები, API გასაღებები ან ბიზნეს მონაცემები.

NULL და ცარიელი მნიშვნელობების მართვა

JSON-ში null მნიშვნელობა (არა "null" ტექსტი, არამედ JavaScript-ის null) იქცევა XLSX-ში ცარიელ უჯრედად. ანალოგიურად, თუ JSON ობიექტს აკლია გარკვეული გასაღები, ეს უჯრედი ცარიელი რჩება.

მაგალითი:

[
  {"name": "ნინო", "age": 30, "active": true},
  {"name": "გიორგი", "age": null},
  {"name": "მარიამი"}
]

პირველი ობიექტი იქცევა: ნინო, 30, TRUE.
მეორე: გიორგი, (ცარიელი), (ცარიელი).
მესამე: მარიამი, (ცარიელი), (ცარიელი).

რადგან ინსტრუმენტი იყენებს dot‑path-ებს, ყველა ობიექტის ყველა გასაღები გროვდება. თუ ერთ ობიექტს აქვს address.city, მეორეს კი არა, მესამე ობიექტისთვის ეს უჯრედი ცარიელი იქნება.

FAQ – ხშირად დასმული კითხვები

Q: რატომ ვერ ვტვირთავ ორ JSON ფაილს ერთდროულად?
A: ინსტრუმენტი იღებს მხოლოდ ერთ ფაილს თითო გადაყვანაზე. ეს გამოწვეულია იმით, რომ JSON-ის "მაგიდის ფორმის" მდგომარეობა მოითხოვს ინდივიდუალურ შემოწმებას. მრავალი JSON-ის ერთდროულად გადაყვანა მოითხოვს მრავალფურცლიან XLSX ფაილს, რასაც ინსტრუმენტი მხარს არ უჭერს.

Q: შემიძლია თუ არა JSON-ის გადაყვანა, რომელიც შეიცავს ფორმულებს?
A: XLSX ფორმატი ინახავს ფორმულებს, მაგრამ JSON-ში ფორმულები არ არსებობს. JSON-Excel გადამყვანი იღებს მხოლოდ სტატიკურ მონაცემებს JSON-დან. თუ JSON-ის ტექსტში ჩაწერეთ =SUM(A1:A10), ის გადავა XLSX-ში როგორც ჩვეულებრივი ტექსტი, არა ფორმულა.

Q: რატომ იკარგება ჩემი JSON-ის ჩაბუდებული მასივები?
A: ინსტრუმენტი შლის (flatten) იერარქიულ JSON-ს, მაგრამ მასივები, რომლებიც ობიექტებშია ჩაბუდებული (მაგ. {"items":}), იქცევა dot‑path-ის მეშვეობით: items.0, items.1, items.2. თუ მასივი შეიცავს ობიექტებს, მაგ. {"users": [{"name": "a"}, {"name": "b"}]}, ის იქცევა users.0.name და users.1.name – ყოველი ობიექტი ცალკე სტრიქონად იქცევა, მაგრამ ეს იწვევს მონაცემების გასამრავლებას (transpose). ინსტრუმენტი ცდილობს მაქსიმალურად ბრტყელი ცხრილის შექმნას, მაგრამ ზოგიერთ შემთხვევაში მონაცემები იკარგება ან გაორმაგდება.

Q: როგორ მივიღო ის, რომ ჩემმა JSON-მა შეინარჩუნოს Excel-ის ფორმატი (თარიღები, ვალუტა)?
A: ინსტრუმენტი არ იყენებს Excel-ის ფორმატირებას. XLSX ფაილი ინახავს მხოლოდ მონაცემთა ტიპებს. თუ JSON-ში თარიღი წერია როგორც "2025-03-20" (ტექსტი), ის გადავა XLSX-ში როგორც ტექსტი. თუ თარიღი წერია როგორც რიცხვი (timestamp), ის გადავა როგორც რიცხვი. Excel-ის ფორმატირების (მაგ. "დღე/თვე/წელი") დასაყენებელი გზა არ არსებობს JSON-დან.

Q: რატომ ვერ ვხედავ ჩემი JSON-ის ყველა ველს?
A: ინსტრუმენტი იყენებს dot‑path-ებს. თუ JSON-ში ობიექტები განსხვავდებიან (მაგ. ერთს აქვს name, მეორეს name და age), ინსტრუმენტი ქმნის ყველა შესაძლო სვეტს. თუ ორ ობიექტს სრულიად განსხვავებული გასაღებები აქვთ, ინსტრუმენტი მაინც გამოიტანს ყველა უნიკალურ გასაღებს. ცარიელი უჯრედები გამოჩნდება იქ, სადაც გასაღები აკლია.

Q: 100,000 სტრიქონიანი JSON ფაილის გადაყვანა შეგიძლიათ?
A: ინსტრუმენტს აქვს მაქსიმალური ლიმიტი როგორც სტრიქონების, ისე სვეტების რაოდენობისთვის. თუ JSON-ში 100,000 სტრიქონია, ლიმიტი შეიძლება გადააჭარბოს. ინსტრუმენტი გამოიტანს შეცდომის შეტყობინებას "This table has more than ‹max› rows." რეკომენდებულია JSON-ის გაყოფა მცირე ნაწილებად.