تحويل CSV إلى JSON
صفوف الجداول إلى سجلات مرتبة

ما الذي تقدمه هذه الأداة عند تحويل CSV إلى JSON

يقرأ محول CSV إلى JSON هذا صفوف ملف الجدول ويكتب كل صف ككائن JSON. الصف الأول يعطي الأسماء، وكل صف بعده يصبح سجلًا واحدًا. متصفحك يقوم بالقراءة، لذلك لا يغادر الملف جهازك أبدًا.

يبدو CSV بسيطًا، لكنه يخفي فخاخًا. اسم مثل "Ahmed, Bilal" يحتوي على الفاصلة نفسها التي تفصل الأعمدة. ورمز بريدي مثل 05400 يفقد صفره إذا عامله شيء كرقم. وفي الوقت نفسه، ملاحظة مكتوبة على سطرين تقسم الملف إلى صفوف زائدة. المحول المهمل يخطئ في الثلاثة.

أما هذا فيتبع القواعد التي تستخدمها برامج الجداول عند كتابة CSV. ثم يعرض جدول فحوصات: الفاصل الذي اكتشفه، والصفوف التي قرأها، وكل ما اضطر إلى إصلاحه في الطريق.

قراءة CSV كما تكتبه برامج الجداول

الصيغة موصوفة في المعيار RFC 4180، وExcel وGoogle Sheets وLibreOffice تتبعه عن قرب. الحقل الموضوع بين علامتي اقتباس مزدوجتين قد يحتوي على فواصل وعلامات اقتباس وحتى أسطر جديدة. وداخل هذا الحقل تعني علامتا اقتباس متتاليتان علامة اقتباس حقيقية واحدة.

يتعامل القارئ مع كل هذه الحالات. كما يزيل علامة ترتيب البايت الخفية التي يضيفها Excel في بداية ملفات UTF-8. ولولا ذلك لتسللت هذه العلامة إلى اسم العمود الأول وأفسدت كل بحث عنه.

تحويل CSV إلى JSON بالأنواع الصحيحة

في ملف CSV كل شيء نص. أما JSON فيعرف الأرقام وقيم true وfalse وnull. لذلك يفحص المحول كل قيمة. الرقم البسيط يصبح رقم JSON، وtrue أو false تصبحان قيمتين منطقيتين حقيقيتين.

لكن بعض الأرقام يجب أن تبقى نصًا. الرمز البريدي أو رقم الهاتف الذي يبدأ بصفر يحتفظ بعلامتي الاقتباس، لأن 05400 و5400 شيئان مختلفان. في الواقع يبقى العمود كله نصًا، فلا ينتهي 05400 و74000 بنوعين مختلفين. كذلك يبقى المعرّف الأطول من خمسة عشر رقمًا نصًا، لأن JavaScript ستقرّبه. تفضّل كل شيء كنصوص؟ عندها أوقف اكتشاف الأنواع.

كائنات متداخلة من عناوين فيها نقطة

الجداول المسطحة كثيرًا ما تمثل بيانات متداخلة. عمود اسمه address.city يعني في الحقيقة "المدينة داخل العنوان". فعّل الأسماء التي فيها نقطة، وسيعيد المحول بناء هذه البنية، فينتهي address.city وaddress.zip داخل كائن address واحد.

هذا هو عكس ما يفعله محول JSON إلى CSV لدينا تمامًا. لذلك يمكنك تصدير JSON إلى جدول، وتعديله مع زملائك، ثم إعادته دون أن يفقد شكله.

كائنات أم قوائم: اختيار شكل النتيجة

معظم البرامج تريد قائمة من الكائنات، حيث تقف كل قيمة بجانب اسمها. هذا ما تحصل عليه عندما يحمل الصف الأول الأسماء. لكن بعض مكتبات الرسوم البيانية وأدوات البيانات تفضّل صفوفًا بسيطة. لها أوقف خيار صف العناوين، فيصبح كل سطر قائمة بسيطة بترتيب الملف نفسه.

تنسيق النص اختيارك أيضًا. مسافتان تناسبان ملفًا سيقرؤه الناس ويعدّلونه. وأربع مسافات أو علامات الجدولة تطابق كثيرًا من أساليب كتابة الشيفرة. أما السطر الواحد بلا مسافات فهو الخيار الأصغر، لذلك يناسب طلبات الواجهات البرمجية وقيم الإعدادات.

من Excel إلى JSON في خطوتين

لا حاجة إلى إضافة أو ماكرو. في Excel اختر ملف، ثم حفظ باسم، واختر CSV UTF-8. بعد ذلك افتح الملف هنا أو الصق محتواه. يظهر JSON فورًا.

في كثير من أوروبا يحفظ Excel بالفاصلة المنقوطة بدل الفاصلة، لأن الفاصلة هناك علامة الكسور العشرية. يلاحظ المحول ذلك بنفسه ويذكر الفاصل الذي استخدمه. ومع ذلك يمكنك اختيار فاصل يدويًا إذا كان الملف غير معتاد.

ماذا يحدث للصفوف المكسورة

الملفات المعدّلة يدويًا نادرًا ما تكون مثالية. عندما يحتوي صف على حقول أقل من صف العناوين، تبقى المفاتيح الناقصة فارغة وتُعدّ في الفحوصات. وعندما تبدأ علامة اقتباس ولا تُغلق أبدًا، يتوقف المحول ويذكر السطر بدقة، لأن التخمين هناك سيخلط كل الصفوف التالية.

من يحوّل الجداول إلى JSON

المطورون يفعلون ذلك باستمرار. قائمة منتجات محفوظة في جدول تصبح بيانات أولية لقاعدة بيانات. وجدول ترجمات يصبح ملف لغة. مثلًا، يمكن لمصممة أن تسلّم جدولًا بمستخدمين تجريبيين، ويحمّله مطور في واجهة برمجية وهمية بعد دقيقة.

وهو يساعد أيضًا من لا يكتبون برمجة أبدًا. كثير من منشئي المواقع وأدوات النماذج وخدمات الأتمتة تقبل استيراد JSON. وبذلك تنتقل قائمة مبيعات أو جدول فعاليات من الجدول إلى تلك الأدوات دون إعادة كتابة صف واحد. دليل JSON من MDN مكان لطيف لفهم معنى النتيجة.