كيفية الاستخدام
- ألصق مصفوفة JSON من الكائنات، أو افتح ملف .json، أو اضغط على «جرّب مثالًا».
- اختر الفاصل الذي يتوقعه برنامج جداول البيانات، وكيفية كتابة المصفوفات داخل الكائنات.
- راجع معاينة CSV. يصبح كل كائن صفًا، وتتحول الحقول المتداخلة إلى أعمدة مثل address.city.
- انسخ CSV أو نزّله كملف .csv.
كيف تعمل الأداة
يصبح كل عنصر في المصفوفة العليا صفًا واحدًا. تتكوّن الأعمدة من جميع المفاتيح، بحسب ترتيب ظهورها أول مرة، لذا تصطف الكائنات ذات الحقول المختلفة بشكل صحيح؛ ويؤدي غياب الحقل أو كون قيمته null إلى خلية فارغة. تُسطّح الكائنات المتداخلة باستخدام مسارات مفصولة بنقاط: يتحول {"address": {"city": "Oslo"}} إلى عمود اسمه address.city. إذا كان الجذر كائنًا واحدًا، تكون النتيجة صفًا واحدًا. أما مصفوفات القيم البسيطة (مثل [1, 2, 3]) فتنتج عمودًا واحدًا اسمه value.
يمكن كتابة المصفوفات داخل الكائنات بثلاث طرق: كنص JSON في خلية واحدة (["a","b"]), أو دمجها في خلية واحدة (a; b)، أو توزيعها على أعمدة مرقمة (tags.0, tags.1). استخدم الخيار الأخير عندما تحتوي الصفوف على قوائم متشابهة وقصيرة.
يتبع الإخراج RFC 4180: يُحاط الحقل بعلامتي اقتباس مزدوجتين إذا احتوى على الفاصل أو علامة اقتباس مزدوجة أو فاصل أسطر، وتُضاعف علامات الاقتباس داخله. تنتهي الصفوف بفواصل أسطر CRLF. في إعدادات محلية أوروبية كثيرة، يتوقع Excel فواصل منقوطة بدلًا من الفواصل، لأن الفاصلة تُستخدم للفصل العشري. وقد يعيد Excel أيضًا تنسيق الأرقام الطويلة والأصفار في البداية والنصوص الشبيهة بالتواريخ عند فتح ملف CSV؛ استورد الملف كنص إذا كانت القيم الدقيقة مهمة. تفقد الأرقام الأكبر من 2^53 دقتها عند تحليل JSON.
أمثلة
تصدير المستخدمين من API
تعيد API القيمة [{"id":1,"name":"Ada","address":{"city":"London"}}, …]. يحتوي CSV على الأعمدة id وname وaddress.city، لتكون جاهزة للفرز والتصفية في جدول بيانات.
نصوص تحتوي على فواصل وعلامات اقتباس
يتحول اسم مثل Alan "AT" Turing إلى "Alan ""AT"" Turing"، وتُحاط مدينة مثل Wilmslow, Cheshire بعلامتي اقتباس، كي تُبقي برامج جداول البيانات كل قيمة في خليتها.
الفتح في Excel الألماني أو الفرنسي
اختر الفاصلة المنقوطة كفاصل وفعّل BOM الخاص بـ UTF-8. عندها يقسّم Excel الأعمدة على نحو صحيح ويعرض أحرفًا مثل ä وé دون تشويه.
الأسئلة الشائعة
كيف تُعالج بيانات JSON المتداخلة بعمق؟
تُسطّح الكائنات المتداخلة على جميع المستويات إلى أسماء أعمدة بمسارات مفصولة بنقاط، مثل order.customer.address.zip. وتعتمد معالجة المصفوفات على الخيار الذي تحدده: نص JSON أو قيم مدمجة أو عمود لكل عنصر.
لماذا تكون بعض الخلايا فارغة؟
تكون الخلية فارغة إذا لم يتضمن الكائن المفتاح أو كانت قيمته null. وتُستمد الأعمدة من جميع الكائنات، لذا يُخصّص عمود حتى للمفتاح الموجود في بعض الكائنات فقط.
أي فاصل ينبغي أن أستخدم؟
الفاصلة هي الخيار القياسي. استخدم الفاصلة المنقوطة مع Excel في الإعدادات المحلية التي تستخدم الفاصلة للفصل العشري (في معظم أنحاء أوروبا وأمريكا اللاتينية)، واستخدم علامة الجدولة عندما تحتوي البيانات نفسها على فواصل كثيرة أو إذا أردت لصقها مباشرةً في جدول بيانات.
هل يمكنه تحويل CSV إلى JSON؟
نعم، باستخدام محوّل CSV إلى JSON على هذا الموقع. تجدر الإشارة إلى أن التسطيح لا يمكن عكسه بالكامل: تعود أسماء الأعمدة ذات المسارات المفصولة بنقاط كمفاتيح عادية مثل "address.city"، لا ككائنات متداخلة.
الخصوصية
يُجرى التحويل في متصفحك. لا تُرفع بيانات JSON ولا نتيجة CSV أو تُخزّن أو تُضمّن في التحليلات.