تحويل JSON وCSV وYAML وXML

أربع صيغ، وشكلان

JSON وYAML وXML أشجار: يمكن للقيم أن تحمل قوائم وكائنات أخرى، متداخلة بالعمق اللازم. أما CSV فجدول مسطح: صفوف وأعمدة، لا شيء داخل الخلية سوى النص. التحويل بين صيغ الأشجار يحتفظ بكل شيء. وتحويل شجرة إلى CSV يجب أن يسطّحها، وهنا تكمن الخيارات.

من JSON إلى CSV

يتوقع المحوّل قائمة من الكائنات، كائنًا لكل صف، كاستجابة واجهة برمجية فيها مصفوفة من المستخدمين. ومفتاح واحد في المستوى الأعلى يحمل تلك القائمة، كما في {"users": [...]}، يُفك تلقائيًا. يصبح كل مفتاح عمودًا؛ ومع تفعيل تسطيح البيانات المتداخلة إلى أعمدة يصبح الكائن المتداخل عدة أعمدة مسماة بمسارها:

{"name": "Ada", "address": {"city": "London"}, "tags": ["math", "code"]}

name,address.city,tags[0],tags[1]
Ada,London,math,code

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

من CSV إلى JSON

• الصف الأول ترويسة يستخدم الصف الأول لأسماء المفاتيح؛ وعند إيقافه تصير الصفوف قوائم عادية.
• اكتشاف الأرقام والقيم المنطقية يحوّل 42 إلى رقم وtrue إلى قيمة منطقية بدل النص. أوقفه للرموز التي يجب أن تحتفظ بأصفارها البادئة، كالرموز البريدية وأرقام الهواتف.
• إعادة بناء كائنات متداخلة من ترويسات منقَّطة تحوّل أعمدة address.city إلى كائنات متداخلة من جديد، عاكسة التسطيح أعلاه.
• الفاصل يُكتشف تلقائيًا: فواصل، أو فواصل منقوطة كما يكتبها Excel في معظم أوروبا، أو جدولة، أو خطوط عمودية.

خصوصيات XML

في XML سمات إلى جانب العناصر. مع تفعيل معاملة مفاتيح @_ كسمات تصبح المفاتيح التي تبدأ بـ@_ سمات، فيصير {"item": {"@_id": "7", "name": "Pen"}} إلى <item id="7"><name>Pen</name></item>، وقراءة XML تعيد الشكل نفسه. واضبط اسم العنصر الجذر الذي يغلّف المستند عند التحويل إلى XML.

ملفات كثيرة في آن واحد

انتقل إلى الملفات لتحويل دفعة، كمجلد من تصديرات JSON إلى CSV، بالإعدادات نفسها للجميع. ولجداول البيانات يقرأ Excel إلى CSV ملفات XLSX ويكتبها، ويفتح عارض CSV ملفات CSV الكبيرة للفرز والتصفية. ومقارنتنا بين CSV وExcel وJSON تقيس كيف تختلف الصيغ في الحجم والسرعة.

إذا حدث خطأ

• تختفي الأصفار البادئة. اكتشاف الأرقام مفعّل. أوقفه لذلك الملف.
• الحروف العربية أو المشكّلة تبدو خاطئة حين يُفتح CSV في Excel. يخمّن Excel الترميز. استخدم البيانات، من نص/CSV واختر UTF-8، أو افتح الملف عبر عارض CSV.
• تظهر مئات الأعمدة. في JSON مصفوفات طويلة داخل كل صف، وكل عنصر يصبح عمودًا. أوقف التسطيح ليبقى كل مصفوفة في خلية واحدة.