CSV إلى JSON

يبدو CSV أبسط صيغة موجودة وهو ليس كذلك. فالحقل قد يحوي الفاصل إن كان بين علامتَي اقتباس، وعلامة اقتباس إن ضُوعفت، وسطرًا جديدًا إن كان داخل الاقتباس. والمحلّل هنا يتّبع معيار RFC 4180 اتّباعًا سليمًا، ولهذا تبقى "Haddad, Sara" حقلًا واحدًا بدل أن تصير حقلين.

والفاصل يُكتشف لا يُفترض، بعدّ المرشّحين خارج المقاطع المقتبَسة. فتصدير أوروبي مفصول بالفاصلة المنقوطة تحوي حقوله النصّية فواصل عادية كان سيُقرأ مفصولًا بالفواصل فيمزّق كل صفّ.

وكشف الأنواع حذر عمدًا. فتحويل "007" إلى 7 يدمّر معرّفًا، و"1.2.3" إصدار لا رقم. ولا يُحوَّل إلا ما ينجو من رحلة ذهاب وعودة — يُحلَّل عددًا، ويُطبع رجوعًا إلى النص نفسه بالضبط. وكل ما عداه يبقى سلسلة.

وتُنزع علامة ترتيب البايتات في أول الملف أولًا. فتركها يجعلها جزءًا غير مرئي من اسم العمود الأول، فيكفّ id في صمت عن مطابقة id.

تصدّر 4000 عميل من نظام إدارة علاقات وتحتاجهم بصيغة JSON لنصّ استيراد. اضغط حمّل ملف CSV للتجربة لترى شكل المشكلة مصغَّرًا.

في العيّنة "Haddad, Sara" — حقل مقتبَس فيه فاصلة. وفي المخرجات هو قيمة name واحدة. أما التقسيم الساذج عند الفواصل فكان سينتج صفًّا فيه حقل زائد ويزيح كل قيمة تالية عمودًا إلى اليسار، وهو الإخفاق الذي يحوّل عنوان بريد إلى مدينة.

انظر إلى قيم id: تبقى "001" سلسلة في JSON. أطفئ كشف الأنواع فيصير كل شيء سلسلة؛ وشغّله فيصير orders عددًا وactive قيمة منطقية، بينما يُترك المعرّف المحشوّ بالأصفار وشأنه. وذلك التمييز هو الفرق بين استيراد يعمل وآخر يعيد ترقيم سجلّاتك في صمت.

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

وإذا كان ملف CSV فوضويًا من البداية — مسافات شاردة وصفوف فارغة وأسطر مكرّرة — فنظّفه أولًا. وفي الاتجاه الآخر، JSON إلى CSV يسطّح الكائنات المتداخلة عائدًا بها إلى جدول.