تحويل Excel إلى JSON: دليل عملي للمطورين وواجهات API
يبدو تحويل Excel إلى JSON بسيطاً، لكنه يصبح مربكاً عندما يحتوي الملف على أكثر من ورقة أو عناوين غير موحّدة أو خلايا فارغة. JSON هو الشكل الذي تتوقعه معظم واجهات API وتطبيقات الويب، لذلك يحتاج المطور إلى تحويل الجدول مع الحفاظ على أسماء الأعمدة وأنواع القيم قدر الإمكان.
متى تحتاج إلى تحويل Excel إلى JSON؟
يظهر هذا الاحتياج عند استيراد قائمة منتجات إلى متجر، نقل بيانات العملاء إلى نظام جديد، تجهيز ملف أولي لواجهة API، أو تحويل جدول داخلي إلى بيانات تستخدمها JavaScript. إذا كان الملف صغيراً أو حساساً، فالأفضل تنفيذ التحويل محلياً داخل المتصفح بدلاً من رفعه إلى خدمة غير معروفة.
استخدم أداة Excel إلى JSON لاختيار ورقة محددة ومعاينة النتيجة قبل تنزيلها. الأداة تدعم وضعين: مصفوفة كائنات مناسبة للـ API، ومصفوفة صفوف تحافظ على شكل الجدول الأصلي.
الفرق بين وضع الكائنات ووضع الصفوف
في وضع الكائنات يُعامل الصف الأول على أنه أسماء الحقول. فمثلاً يتحول الجدول التالي: "name | price" إلى كائنات مثل { "name": "Keyboard", "price": 25 }. هذا الشكل سهل القراءة في JavaScript وPython وقواعد البيانات.
أما وضع الصفوف فينتج مصفوفة ثنائية الأبعاد تبدأ بالعناوين ثم القيم. هذا الخيار أفضل عندما تكون بعض الأعمدة بلا أسماء أو عندما تريد الحفاظ على ترتيب الأعمدة كما ظهر في Excel. لا تختَر وضع الكائنات قبل التأكد من أن الصف الأول يحتوي عناوين فريدة وواضحة.
خطوات تنظيف الملف قبل التحويل
- اجعل لكل عمود اسماً واحداً وفريداً، مثل "product_name" و"price".
- احذف الصفوف التوضيحية أعلى الجدول؛ يجب أن يبدأ الجدول الحقيقي من الصف الأول.
- تجنب دمج الخلايا، لأنه لا يمثل حقلاً واضحاً في JSON.
- راجع التواريخ والأرقام، خصوصاً أرقام الهواتف والرموز البريدية التي قد تفقد أصفارها الافتتاحية.
- افحص كل ورقة على حدة، ولا تفترض أن الورقة النشطة هي الورقة المطلوبة.
بعد التحويل، الصق الناتج في منسق JSON للتحقق من الأقواس والأنواع والقراءة. إذا كنت تنقل البيانات إلى CSV أولاً، يمكنك استخدام Excel إلى CSV ثم CSV إلى JSON للمقارنة.
الخصوصية والتحقق من النتيجة
ملف Excel قد يحتوي على أسماء أو أسعار أو بيانات داخلية. قبل استخدام أي خدمة خارجية، تحقق من سياسة الخصوصية ومكان معالجة الملف. أدوات DouNest تعمل محلياً في المتصفح؛ مع ذلك، مكتبة قراءة Excel تُحمّل من CDN عند أول استخدام، لذلك يحتاج التحويل الأول إلى اتصال بالإنترنت.
تحقق من عدد الصفوف قبل وبعد التحويل، وراجع عينة من أول سجل وآخر سجل، ثم اختبر JSON في التطبيق الذي سيستهلكه. وجود JSON صالح نحوياً لا يعني أن أسماء الحقول أو أنواع القيم مناسبة لنظامك.
خلاصة سريعة
أفضل نتيجة تأتي من جدول نظيف بعناوين فريدة، اختيار وضع الإخراج المناسب، ثم التحقق من JSON قبل دمجه في API. ابدأ بأداة Excel إلى JSON، واستخدم منسق JSON للمراجعة، ولا ترسل ملفاً حساساً إلى خدمة لا تثق بها.