محوّل JSON إلى CSV

كيفية استخدام محوّل JSON إلى CSV

1. اختر اتجاه التحويل: JSON → CSV أو CSV → JSON.
2. الصق بياناتك في مربع الإدخال، أو انقر فتح ملف لتحميل ملف .json أو .csv أو .tsv من جهازك (حتى 10 MB).
3. اختر الفاصل. عند قراءة CSV يعثر اكتشاف تلقائي عادةً على الفاصل الصحيح، وعند كتابة CSV يستخدم الفاصلة.
4. اضبط خيارات الاتجاه الحالي، ثم انقر تحويل. تتحدّث النتيجة أيضًا أثناء الكتابة.
5. انسخ النتيجة أو نزّلها. ينقل زر عكس الاتجاه الناتج إلى مربع الإدخال لتحوّله في الاتجاه المعاكس.

من JSON إلى CSV

ملف CSV جدول مسطّح: صف عناوين واحد بأسماء الأعمدة، وسطر لكل سجل. أما JSON فبنية شجرية، لذا يجب أن يقرر المحوّل كيف تصبح السجلات والقيم المتداخلة صفوفًا وأعمدة.

• مصفوفة من الكائنات تصبح صفًا لكل كائن. والأعمدة هي اتحاد كل المفاتيح بترتيب ظهورها الأول، فالكائن الذي ينقصه مفتاح ما يحصل ببساطة على خلية فارغة.
• كائن بخاصية واحدة من نوع مصفوفة، مثل {"items": [ … ]}، وهو شكل شائع في استجابات واجهات API، يُفكّ غلافه ويصبح كل عنصر صفًا. وأي كائن آخر يصبح صفًا واحدًا.
• مصفوفة من المصفوفات هي جدول أصلًا، فتُكتب كما هي دون صف عناوين.
• عند تفعيل تسطيح المفاتيح المتداخلة (address.city)، تصبح الكائنات المتداخلة أسماء أعمدة منقّطة: {"address": {"city": "Lyon"}} ينتج عمودًا باسم address.city. وتحصل المصفوفات على أعمدة بالفهارس: tags.0 وtags.1… وعند إلغاء الخيار، تُكتب القيم المتداخلة في خلية واحدة كنص JSON.

تُحاط القيم التي تحتوي على الفاصل أو علامات الاقتباس أو فواصل الأسطر بعلامات اقتباس وفق المعيار RFC 4180، وهي الصيغة التي تقرؤها Excel وLibreOffice وGoogle Sheets جميعها. وتصبح القيمة null خلية فارغة.

الحماية من صيغ جداول البيانات

الخلية التي تبدأ بـ= أو + أو - أو @ قد تُنفَّذ كصيغة عند فتح ملف CSV في برنامج جداول بيانات، وهو ما يُعرف بحقن CSV. إذا كانت بياناتك واردة من المستخدمين أو من مصادر غير موثوقة، ففعّل الحماية من صيغ جداول البيانات: تُسبق هذه الخلايا النصية بفاصلة علوية (‘) فيعرضها البرنامج كنص عادي.

من CSV إلى JSON

• الصف الأول عناوين أعمدة: يحوّل كل سطر إلى كائن مفاتيحه أسماء الأعمدة. ألغِ الخيار لتحصل على مصفوفة من المصفوفات.
• تحويل الأرقام والقيم المنطقية: يجعل 42 رقمًا وtrue قيمة منطقية، ويحوّل الخلايا الفارغة إلى null. ألغِ الخيار لتبقى كل القيم نصوصًا، فتحافظ على الأصفار البادئة في الرموز البريدية وأرقام الهواتف.
• إعادة بناء الكائنات المتداخلة من العناوين المنقّطة: يعكس التسطيح، فالعناوين address.city وtags.0 تنتج {"address": {"city": …}, "tags": [ … ]}. لذا تعيد رحلة الذهاب والإياب JSON → CSV → JSON البنية الأصلية مع البيانات المعتادة.

إذا احتوت بعض الصفوف على حقول أكثر أو أقل من صف العناوين، يستمر التحويل، لكن تنبيهًا يعرض رقم سطر أول صف غير منتظم لتراجعه.