تحويل CSV إلى JSON
حوّل ملفات CSV إلى JSON.
واجهة الأداة نفسها باللغة الإنجليزية حاليًا، وتعمل بالكامل داخل متصفحك.
جارٍ تحميل الأداة…
ما هو CSV، ولماذا هو أصعب مما يبدو؟
CSV تعني القيم المفصولة بفواصل: سجل في كل سطر، والحقول تفصلها فواصل. وهي أقدم صيغ تبادل البيانات وأوسعها دعمًا، ولم توحَّد إلا بشكل فضفاض، ومن هنا تأتي الصعوبة. فالحقول التي تحتوي فاصلة يجب أن تُقتبس. وعلامات الاقتباس داخل حقل مقتبس تُهرَّب بمضاعفتها. والسجلات قد تحتوي فواصل أسطر داخل الاقتباس. وكثير من الصادرات الأوروبية تستخدم الفاصلة المنقوطة بدل الفاصلة لأن الفاصلة عندهم فاصل عشري.
والتحويل إلى JSON يعني تحليل كل ذلك بشكل صحيح، ثم تقرير ما تعنيه البيانات: الصف الأول عادةً صف عناوين يوفر المفاتيح، وكل صف بعده يصبح كائنًا. والأنواع هي القرار الآخر؛ فلا أنواع في CSV، فتصل 42 وtrue كنصوص ما لم يستنتج المحوّل غير ذلك، والأصفار البادئة في أشياء كالرموز البريدية يجب الحفاظ عليها لا تحويلها بصمت إلى أرقام.
لماذا أنشأنا هذه الأداة
المهمة المعتادة إدخال صادرات جدول بيانات إلى شيء يتحدث JSON: تعبئة قاعدة بيانات، أو تشغيل بيانات اختبار، أو إرسال سجلات إلى واجهة API، أو تحميل بيانات إلى واجهة JavaScript أمامية.
وتلك الصادرات هي البيانات الحقيقية عادةً: قوائم عملاء، وسجلات طلبات، وسجلات موظفين. ورفعها إلى موقع تحويل نقل بيانات ستجد صعوبة في تبريره في مراجعة خصوصية. محللنا يعمل داخل متصفحك، فيُقرأ الملف من القرص إلى التبويب، ويُحوَّل بمعالجك، ويُكتب من جديد. لا يُرسل شيء، ولا سقف لعدد الصفوف، والملفات الكبيرة محدودة فقط بذاكرة جهازك.
نصائح وأخطاء شائعة
- تحقق من الفاصل قبل التحويل؛ فالصادرات الأوروبية تستخدم الفاصلة المنقوطة كثيرًا.
- الرموز البريدية وأرقام الهواتف ومراجع الحسابات يجب أن تبقى نصوصًا؛ فالاكتشاف التلقائي للأرقام يحذف أصفارها البادئة.
- صف العناوين ذو الأسماء المكررة أو الفارغة ينتج مفاتيح محيرة، فرتّبه أولًا.
- إذا ظهرت الحروف العربية رموزًا غريبة، فالملف محفوظ بترميز غير UTF-8؛ احفظه من Excel بصيغة «CSV UTF-8».
بداية سريعة: استخدام تحويل CSV إلى JSON
- الصق CSV أو حمّل الملف أعلاه.
- تأكد من الفاصل، فاصلة أو فاصلة منقوطة، وهل الصف الأول صف عناوين.
- شغّل التحويل وافحص أول كائن في الناتج.
- تأكد أن الحقول الرقمية والمنطقية بالأنواع التي تريدها.
- انسخ JSON أو نزّله لاستخدامه في مشروعك.
الاتجاه المعاكس هو تحويل JSON إلى CSV، وأداة منسّق JSON تجمّل النتيجة.
كيف يتحول الملف
يصبح ملف CSV مصفوفة JSON يكون فيها كل صف كائنًا. يوفر صف العناوين المفاتيح، ويوفر كل صف بعده القيم. فملف CSV بأعمدة name,email,age وصف Ada,ada@x.com,36 يصبح كائنًا بحقول name وemail وage. والنتيجة قائمة نظيفة من السجلات جاهزة ليمر عليها برنامج.
التفاصيل التي تكسر التحويل
يبدو CSV بسيطًا لكنه يخفي حوافًا حادة:
- الفواصل داخل القيم. حقل مثل
"Smith, Ada"يجب أن يُقتبس، وإلا قسمته الفاصلة إلى عمودين. وCSV المقتبس بشكل صحيح يتعامل مع هذا؛ أما المعطوب فلا. - العناوين أساسية. دون صف عناوين لا توجد مفاتيح، ولا يستطيع المحوّل تسمية الحقول بشكل ذي معنى.
- كل شيء نص. لا أنواع في CSV، فتصل
36وtrueكنصوص. وقد تحتاج إلى تحويل الحقول الرقمية أو المنطقية بعد ذلك بحسب ما تتوقعه شيفرتك. - الخلايا الفارغة تصبح نصوصًا فارغة أو null؛ قرر أيهما تحتاج بياناتك.
- الصفوف غير المتسقة، كصف بأعمدة أقل من صف العناوين، تنتج حقولًا ناقصة أو غير محاذاة.
تحقق من النتيجة
بعد التحويل، يستحق التحقق من أن JSON سليم البنية، خصوصًا إن كان CSV فوضويًا. أداة مدقق JSON تؤكد الصحة، وأداة منسّق JSON تجعل الناتج مقروءًا لتتفحص هل خرج التحويل صحيحًا.
استخدامات شائعة
- إدخال بيانات جدول إلى تطبيق ويب أو API.
- تحويل صادرات إلى ملف إعدادات أو تعبئة.
- تجهيز بيانات اختبار من CSV.