JSON إلى CSV

JSON شجرة وCSV شبكة، فعلى التحويل أن يجيب عن سؤالين لا تجيب عنهما الصيغة: ماذا يفعل بالتداخل، وماذا يفعل حين تختلف أشكال السجلّات.

التداخل يصير أسماء أعمدة منقوطة. { address: { city: "Amman" } } تصير عمودًا اسمه address.city. ومصفوفات القيم البسيطة تُوصل بفاصلة منقوطة؛ ومصفوفات الكائنات تأخذ أعمدة مرقّمة مثل items.0.sku. فكل ورقة تنتهي في مكان ما، بدل أن يُكتب كائن متداخل هكذا [object Object].

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

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

واجهة برمجية تعيد طلبات وتحتاجها في جدول. اضغط حمّل عيّنة JSON لترى الحالتين الصعبتين معًا.

السجلّ الأول فيه address.city وaddress.zone؛ والثاني فيه address.city وحدها. والأول فيه وسمان؛ والثاني بلا وسوم. والثاني فيه حقل note ليس في الأول.

والنتيجة جدول واحد أعمدته id, name, address.city, address.zone, tags, note. والصفّ الثاني فيه فراغ حيث كانت ستكون address.zone وقيمة تحت note حيث الصفّ الأول فارغ. لم يُسقَط شيء، ولا صفّ منحرف.

وإعداد واحد ينبغي ضبطه قبل الفتح في إكسل. فإن كان إكسل عندك مضبوطًا على لغة أوروبية فهو يتوقّع فواصل منقوطة لا فواصل — افتح فيه ملفًّا مفصولًا بالفواصل فيحطّ كل صفّ في عمود واحد. بدّل الفاصل إلى الفاصلة المنقوطة فيفتح فتحًا صحيحًا.

والنصف الآخر من تلك المشكلة هو الترميز: فإكسل يحتاج علامة ترتيب بايتات ليقرأ UTF-8، وبدونها يُفتح النص العربي والمحرَّك حروفًا مشوّهة. والذهاب مباشرةً إلى ملف ‎.xlsx يتفادى المسألتين كليًا، لأن الصيغة تحمل ترميزها معها.