JSON থেকে Excel রূপান্তর: টুলটির কাজ ও বৈশিষ্ট্য
আপনি যখন একটি JSON ফাইল আপলোড করেন, এই পৃষ্ঠাটি তা স্বয়ংক্রিয়ভাবে একটি Excel (XLSX) ফাইলে রূপান্তর করে। JSON-এর শ্রেণিবদ্ধ কাঠামো (nested objects, arrays) একটি ফ্ল্যাট টেবিলে পরিণত হয়: অবজেক্টের কীগুলি কলামের শিরোনাম হয়, অবজেক্টের অ্যারে সারি তৈরি করে, এবং নেস্টেড কীগুলি ডট-পাথ নামে প্রসারিত হয় (যেমন address.city)। আপনি ফলাফলের একটি পূর্বরূপ দেখতে পারেন, সারি ও কলামের সংখ্যা জানতে পারেন এবং প্রক্রিয়াজাত XLSX ফাইল ডাউনলোড করতে পারেন। পুরো রূপান্তর আপনার ব্রাউজারের ভিতরেই ঘটে; কোনো ফাইল সার্ভারে আপলোড হয় না।
এই পৃষ্ঠাটি কেন আলাদা
JSON একটি টাইপযুক্ত এবং নেস্টেবল ফরম্যাট – এতে অবজেক্ট, অ্যারে, সংখ্যা, বুলিয়ান এবং null থাকতে পারে। অন্যদিকে একটি ফ্ল্যাট স্প্রেডশিট সরাসরি সেই শ্রেণিবদ্ধ কাঠামো ধারণ করতে পারে না। তাই এই রূপান্তরে একটি ফ্ল্যাটেনিং নিয়ম (ডট-পাথ কী) প্রয়োগ করা হয়, যা CSV বা Excel থেকে রূপান্তরের সময় প্রয়োজন হয় না, কারণ CSV/Excel ইতিমধ্যেই ফ্ল্যাট।
আউটপুট ফরম্যাট XLSX একটি জিপড XML ওয়ার্কবুক, যা স্থানীয়ভাবে সংখ্যা ও বুলিয়ানের মতো ডেটা টাইপ সংরক্ষণ করতে পারে (CSV-এর বিপরীতে, যা সবকিছুকে টেক্সটে পরিণত করে)। তবে এই টুল কোনো ফর্মুলা বা সেল স্টাইলিং ধরে রাখে না; এটি শুধুমাত্র JSON উৎস থেকে স্থির ডেটা লেখে। নিচের টেবিলটি JSON এবং Excel-এ ডেটা টাইপের ম্যাপিং দেখায়:
| JSON টাইপ | Excel সেল টাইপ (XLSX) |
|---|---|
| সংখ্যা (number) | সংখ্যা (number) |
| বুলিয়ান (true/false) | বুলিয়ান (TRUE/FALSE) |
| স্ট্রিং (string) | টেক্সট (text) |
| null | খালি সেল (empty cell) |
| অবজেক্ট/অ্যারে (nested) | ডট-পাথ কলামে প্রসারিত |
এই ম্যাপিংয়ের কারণে JSON-এর টাইপ সংরক্ষিত থাকে — যা CSV দিয়ে সম্ভব নয়। কিন্তু নেস্টেড কাঠামো সম্পূর্ণরূপে ফ্ল্যাট টেবিলে রূপান্তরিত হয়, ফলে গভীর নেস্টিং বা অ্যারেগুলির জটিলতা হারিয়ে যায়।
ফ্ল্যাটেনিংয়ের বিশেষত্ব
যখন JSON একটি অবজেক্টের অ্যারে (array of objects) হয়, তখন প্রতিটি অবজেক্ট একটি সারি তৈরি করে এবং সমস্ত অনন্য কী কলাম হয়। নেস্টেড কীগুলি ডট পাথ দিয়ে লেখা হয় — যেমন user.address.city। যদি JSON অ্যারের অ্যারে (array of arrays) হয়, তবে টুলটি সেই অ্যারেগুলিকে সরাসরি টেবিল সারি হিসেবে ধরে, এবং কলামগুলির জন্য কোনো শিরোনাম তৈরি হয় না (প্রথম সারি ডেটা হিসেবে গণ্য হয়)। শুধুমাত্র প্রথম ওয়ার্কশিট তৈরি হয়; একাধিক শীট, ফর্মুলা বা ফরম্যাটিং ক্যারি ওভার হয় না।
ইনপুট ও আউটপুটের নিয়ম
ইনপুট: একটি একক JSON ফাইল (একসাথে একটিই ফাইল আপলোড করা যায়)। JSON অবশ্যই "টেবিল-আকৃতির" (table‑shaped) হতে হবে — অর্থাৎ অবজেক্টের অ্যারে বা অ্যারের অ্যারে। একক অবজেক্ট বা রুটে অ্যারে না থাকা JSON গ্রহণযোগ্য নয় এবং ত্রুটি বার্তা দেখাবে।
আউটপুট: একটি XLSX ফাইল। টুলটি পূর্বরূপ, রূপান্তরিত টেবিলের সারি ও কলাম সংখ্যা এবং আউটপুট ফাইলের সাইজ প্রদর্শন করে। ডাউনলোডের আগে আপনি ডেটা পরীক্ষা করতে পারেন।
সঠিক JSON কাঠামোর উদাহরণ
অবজেক্টের অ্যারে (সাধারণ):
[
{ "name": "Rahim", "age": 30, "address": { "city": "Dhaka", "zip": 1205 } },
{ "name": "Karim", "age": 25, "address": { "city": "Chittagong", "zip": 4000 } }
]
ফ্ল্যাটেনিংয়ের পর কলাম হবে: name, age, address.city, address.zip।
অ্যারের অ্যারে:
[
[ "Product A", 150, true ],
[ "Product B", 200, false ]
]
এখানে কলাম শিরোনাম থাকবে না; প্রতিটি অ্যারে একটি সারি হিসেবে যুক্ত হবে।
সীমাবদ্ধতা ও ত্রুটির বার্তা
JSON থেকে ফ্ল্যাট স্প্রেডশিটে রূপান্তর কিছু সীমাবদ্ধতা আরোপ করে:
- গভীর নেস্টিং: একাধিক লেভেলের নেস্টেড অবজেক্টের ফলে কলামের সংখ্যা অনেক বেড়ে যেতে পারে। টুলটি সর্বোচ্চ কলাম সংখ্যা নির্ধারণ করে দেয় (যা ফাইলের আকার অনুযায়ী পরিবর্তিত হতে পারে)।
- অ্যারের মধ্যে অ্যারে: যদি কোনো মান অ্যারে হয়, তবে তা ফ্ল্যাট কলামে রূপান্তরিত হয় না — পরিবর্তে সেই অ্যারেটি একটি স্ট্রিং হিসেবে বা বিভাজিত করে সংরক্ষণ করা হতে পারে? ফ্যাক্ট শিট অনুযায়ী, টুলটি অ্যারে অফ অবজেক্টের জন্য ডট-পাথ ব্যবহার করে; কিন্তু অ্যারে অফ অ্যারেকে তা সারি হিসেবে ধরে। যদি কোনো অবজেক্টের মান অ্যারে হয় (যেমন
"tags": ["a","b"]), তবে সেটি কীভাবে হ্যান্ডেল হয়? ফ্যাক্ট শিট সরাসরি বলে না, তবে এটি সাধারণত স্ট্রিং বা অন্য একটি রূপান্তরের মাধ্যমে সমাধান করা হয়। তবে ব্যবহারকারীদের জন্য এটি একটি জ্ঞাত সীমাবদ্ধতা: গভীর নেস্টিং বা নন-স্কেলার মান সম্পূর্ণ ফ্ল্যাট টেবিলে আনা সম্ভব নয়।
নিম্নলিখিত ত্রুটির বার্তাগুলি প্রদর্শিত হতে পারে (ফ্যাক্ট শিট থেকে হুবহু):
- “Choose one file first.” (প্রথমে একটি ফাইল বেছে নিন।)
- “Choose a CSV, JSON or XLSX file.” (CSV, JSON বা XLSX ফাইল বেছে নিন।)
- “This file is too large. Use a file under ‹max›.” (ফাইলটি ‹max› এর চেয়ে বড়।)
- “This JSON is invalid or not table‑shaped.” (JSON অকার্যকর বা টেবিল-আকৃতির নয়।)
- “This file has no table rows.” (ফাইলটিতে কোনো টেবিল সারি নেই।)
- “This table has more than ‹max› rows.” (টেবিলে ‹max›-এর বেশি সারি আছে।)
- “This table has more than ‹max› columns.” (টেবিলে ‹max›-এর বেশি কলাম আছে।)
- “Conversion cancelled.” (রূপান্তর বাতিল করা হয়েছে।)
- “This conversion is taking too long. Try a smaller file.” (রূপান্তর অনেক সময় নিচ্ছে। ছোট ফাইল ব্যবহার করুন।)
এই বার্তাগুলি নিশ্চিত করে যে ব্যবহারকারী ভুল ফাইল টাইপ, আকারের সীমা বা অপ্রত্যাশিত JSON কাঠামো এড়াতে পারেন।
সারি ও কলামের সীমা কেন গুরুত্বপূর্ণ?
XLSX ফরম্যাট তাত্ত্বিকভাবে ১ মিলিয়নের বেশি সারি এবং ১৬,০০০-এর বেশি কলাম সমর্থন করে। তবে ব্রাউজার-ভিত্তিক প্রক্রিয়াকরণে মেমরি ও সময়ের সীমাবদ্ধতা থাকে। তাই টুলটি নিজস্ব সীমা (max) আরোপ করে — ফ্যাক্ট শিটে নির্দিষ্ট সংখ্যা উল্লেখ না থাকলেও এটি বৈশিষ্ট্যগতভাবে জানা। বড় ফাইলের জন্য "টেকিং টু লং" মেসেজ দেখায়, এবং ব্যবহারকারীকে ছোট ফাইল ব্যবহার করতে বলে।
কাদের জন্য এই টুলটি প্রয়োজনীয়
- API থেকে প্রাপ্ত ডেটা বিশ্লেষক: যারা JSON আকারে API ডেটা পান (যেমন REST API থেকে) এবং তা Excel-এ বিশ্লেষণ করতে চান, তাদের জন্য এটি সরাসরি সমাধান।
- ডেটা সায়েন্টিস্ট/অ্যানালিস্ট: যারা নেস্টেড JSON কে ফ্ল্যাট টেবিলে রূপান্তর করতে নিজস্ব কোড না লিখে দ্রুত প্রক্রিয়া করতে চান।
- এক্সেল ব্যবহারকারীদের সাথে সহযোগিতাকারী টিম মেম্বার: যদি আপনার টিমের অন্যজন এক্সেলে কাজ করেন, তাহলে JSON ডেটাকে XLSX ফরম্যাটে রূপান্তর করে শেয়ার করা সহজ হয়। এছাড়া XLSX সংখ্যা ও বুলিয়ান টাইপ সংরক্ষণ করে, যা CSV-তে সম্ভব নয়।
- কনফিগারেশন বা লগ ফাইল থেকে ডেটা এক্সট্র্যাক্টর: অনেক সিস্টেম JSON-এ কনফিগারেশন বা লগ জমা রাখে; সেগুলিকে স্প্রেডশিটে এনালাইসিস করতে এই টুল সহায়ক।
প্রযুক্তিগত পটভূমি: ডেটা টাইপ সংরক্ষণ ও ক্লায়েন্ট-সাইড গোপনীয়তা
JSON-এ সংখ্যা (number), বুলিয়ান (boolean), স্ট্রিং, null এবং অবজেক্ট/অ্যারে থাকে। XLSX ফাইল জিপড XML নিয়ে গঠিত, যেখানে প্রতিটি সেলের একটি t (type) অ্যাট্রিবিউট এবং একটি v (value) থাকে। সংখ্যার জন্য t="n", বুলিয়ানের জন্য t="b" (TRUE/FALSE), স্ট্রিংয়ের জন্য t="s" (shared string table) বা t="inlineStr"। এই ফরম্যাট CSV-এর তুলনায় ডেটা টাইপ আরও নির্ভুলভাবে ধরে রাখে। তবে টুলটি কোনো ফর্মুলা (যেমন =SUM(A1:A10)) বা সেল স্টাইল (ফন্ট, কালার, বর্ডার) সংরক্ষণ করে না — শুধুমাত্র প্লেইন ডেটা।
গুরুত্বপূর্ণ বিষয়: এই রূপান্তর সম্পূর্ণ ক্লায়েন্ট-সাইডে ঘটে। আপনার ফাইল কখনো সার্ভারে যায় না। এটি ডেটা গোপনীয়তার জন্য অত্যন্ত গুরুত্বপূর্ণ, বিশেষ করে সংবেদনশীল তথ্য ধারণকারী JSON ফাইলের জন্য। কোন তৃতীয় পক্ষের সার্ভার জড়িত নয়, তাই ডেটা পড়ার বা চুরির ঝুঁকি নেই।
ফ্ল্যাটেনিং অ্যালগরিদমের কাজ
টুলটি JSON ট্রি-তে recursive walk করে। প্রতিটি লীফ ভ্যালু (স্ট্রিং, নম্বর, বুলিয়ান, null) একটি কলাম-মান পেয়ার তৈরি করে, যেখানে কীটি বর্তমান পাথ (যেমন "user.address.street") এবং মানটি সেল মান। যদি JSON অ্যারের অ্যারে হয়, তবে প্রতিটি সাব-অ্যারের উপাদানগুলিকে একক সারিতে কলাম হিসেবে বিবেচনা করা হয় — কোনো ডট-পাথ প্রয়োগ হয় না। এই প্রক্রিয়ায় মেমরি ব্যবহার কার্যকরভাবে নিয়ন্ত্রণ করা হয়, কিন্তু অতি বড় ফাইলের ক্ষেত্রে সময় বেশি লাগতে পারে, যা ত্রুটি বার্তার মাধ্যমে জানানো হয়।
সচরাচর জিজ্ঞাসা (FAQ)
প্রশ্ন ১: আমি কি একাধিক JSON ফাইল একসাথে রূপান্তর করতে পারি? উত্তর: না। এই টুল একবারে কেবল একটি ফাইল গ্রহণ করে। একাধিক ফাইলের জন্য আলাদাভাবে প্রতিটি আপলোড করতে হবে।
প্রশ্ন ২: আমার JSON-এ যদি একটি অবজেক্টের ভিতরে আরেকটি অ্যারে থাকে, সেটি কীভাবে হ্যান্ডেল হয়?
উত্তর: টুলটি নেস্টেড অবজেক্টের কীগুলিকে ডট-পাথ কলামে পরিণত করে। তবে যদি কোনো কী-এর মান অ্যারে হয় (যেমন "tags": ["a","b"]), তাহলে সেটি সাধারণত একটি স্ট্রিং বা একাধিক কলামে বিভক্ত হয় না — ফ্যাক্ট শিট অনুযায়ী টুলটি শুধুমাত্র অবজেক্টের অ্যারে বা অ্যারের অ্যারেকে টেবিল-আকৃতির হিসেবে ধরে। অ্যারে মান সম্পূর্ণভাবে ফ্ল্যাট হয় না; ব্যবহারকারীকে নিজেকে সেই অ্যারেটি আলাদা JSON-এ প্রক্রিয়া করতে হতে পারে।
প্রশ্ন ৩: আউটপুট XLSX ফাইলে কি সেল ফরম্যাটিং (যেমন সংখ্যার দশমিক) থাকবে? উত্তর: না। টুলটি কোনো ফরম্যাটিং সংরক্ষণ করে না। সংখ্যাগুলি XLSX-এ সংখ্যা টাইপ হিসেবে থাকে, কিন্তু দশমিক স্থান, কমা বিভাজক ইত্যাদি প্রয়োগ করা হয় না। আপনি Excel-এ সেল ফরম্যাট করে নিজের মতো ফরম্যাট করতে পারেন।
প্রশ্ন ৪: JSON-এ null মান থাকলে কী হয়?
উত্তর: null মানটি XLSX-এ খালি সেল হিসেবে রূপান্তরিত হয়। Excel-এ সেলটি খালি থাকবে।
প্রশ্ন ৫: আমার JSON-এ বহু কলাম (যেমন ১০০টির বেশি) থাকলে টুল কাজ করবে?
উত্তর: সম্ভবত কাজ করবে, তবে টুলের নিজস্ব কলাম সীমা রয়েছে (ফ্যাক্ট শিটে ‹max› উল্লেখিত)। যদি সংখ্যাটি সেই সীমা অতিক্রম করে, তাহলে ত্রুটি বার্তা দেখাবে। সাধারণত ২৫৬ বা ১০০০ এর কাছাকাছি সীমা থাকে। প্রয়োজনে JSON ফাইল ছোট করে নিন অথবা প্রয়োজনীয় কলাম শুধু রাখুন।
প্রশ্ন ৬: রূপান্তরিত ফাইলটি ডাউনলোডের পর কি আমি Excel-এ ফর্মুলা যোগ করতে পারি? উত্তর: হ্যাঁ। XLSX ফাইলটি স্বাভাবিক Excel ফাইল, তাই আপনি Excel-এ ফাইলটি খুলে ফর্মুলা, চার্ট ইত্যাদি যোগ করতে পারেন। টুলটি শুধু স্ট্যাটিক ডেটা লিখে দেয়, যার উপরে আপনি নিজের প্রয়োজন মতো কাজ করতে পারেন।
এই FAQ-গুলি ব্যবহারকারীদের সাধারণ জিজ্ঞাসার উত্তর দেয় এবং টুলটির সীমাবদ্ধতা বোঝাতে সাহায্য করে।