تحويل ⁦JSON⁩ إلى ⁦CSV⁩:
المحوّل

كيف تحوّل ⁦JSON⁩ إلى ⁦CSV⁩

1. انقر «اختر الملفات» أو أفلت ملفات ‎.⁦json⁩ على الصفحة.
2. يُحوَّل كل ملف فور إضافته، باستخدام الفواصل وتسطيح الحقول المتداخلة.
3. غيّر «الفاصل» أو أوقف «تسطيح الحقول المتداخلة» من لوحة الإعدادات على اليمين، ثم انقر «تطبيق على كل الملفات».
4. احفظ ملف ⁦CSV⁩، أو اختر «تنزيل الكل (.⁦zip)⁩» لعدة ملفات.

أي جزء من ⁦JSON⁩ يصبح صفوفًا

إذا كان الملف مصفوفة، يصبح كل عنصر صفًا. معظم ردود الـ ⁦API⁩ تضع القائمة داخل كائن، مثل كائن فيه مفتاح ⁦data⁩ أو ⁦results⁩ بجانب بعض البيانات الوصفية. في هذه الحالة تبحث الأداة في الكائن مستوى بعد مستوى، وتستخدم أول مصفوفة كائنات تجدها. والكائن المفرد الذي لا قائمة بداخله يصبح صفًا واحدًا.

الأعمدة هي اتحاد كل المفاتيح في كل السجلات، بترتيب ظهورها الأول. السجل الذي ينقصه حقل تكون خليته فارغة في ذلك العمود. قيمة ⁦null⁩ تصبح خلية فارغة، والقيم المنطقية تُكتب ⁦true⁩ و⁦false.⁩

المصفوفة التي عناصرها مصفوفات بدورها تحصل على أعمدة باسم ⁦1⁩ و⁦2⁩ و⁦3⁩ وهكذا. وقائمة القيم البسيطة، مثل الأرقام أو النصوص، تحصل على عمود واحد باسم ⁦value.⁩

ما وظيفة كل إعداد

المصفوفات داخل السجل تبقى دائمًا كنص ⁦JSON⁩ في خلية واحدة، مثل ["⁦red⁩","⁦blue⁩"]. فتقسيمها يتطلب صفًا لكل عنصر، وهذا سيغيّر معنى كل صف.

• الفاصل: فاصلة (الافتراضي)، أو فاصلة منقوطة، أو ⁦Tab.⁩ استخدم الفاصلة المنقوطة إذا كان ⁦Excel⁩ لديك يستخدم الفاصلة كعلامة عشرية، و⁦Tab⁩ لملفات ⁦TSV⁩ أو للّصق في جدول.
• تسطيح الحقول المتداخلة: مفعّل افتراضيًا. الكائن المتداخل مثل ⁦address⁩ وبداخله ⁦city⁩ يصبح عمودًا باسم ⁦address.city⁩، والمستويات الأعمق تضيف مزيدًا من النقاط، كما في ⁦address.geo.lat.⁩ أوقفه لتبقي كل كائن متداخل كنص ⁦JSON⁩ في خلية واحدة.

فتح ملف ⁦CSV⁩ في ⁦Excel⁩

ملف ⁦CSV⁩ بترميز ⁦UTF-8⁩ ويبدأ بعلامة ترتيب البايتات (⁦BOM)⁩، فيعرض ⁦Excel⁩ الحروف المشكّلة والكتابات غير اللاتينية بشكل صحيح عند فتحه بالنقر المزدوج. الحقول التي تحتوي على الفاصل أو علامات الاقتباس أو فواصل الأسطر توضع بين علامتي اقتباس.

قد يعيد ⁦Excel⁩ مع ذلك تنسيق بعض القيم عند الفتح: أرقام المعرّفات الطويلة قد تتحول إلى صيغة علمية، وقيم مثل ⁦0042⁩ تفقد أصفارها. لتجنب ذلك، استورد الملف من «البيانات › من نص/⁦CSV⁩» واضبط تلك الأعمدة على «نص».

مشكلات شائعة وحلولها

• «هذا ليس ⁦JSON⁩ صالحًا قرب السطر ⁦12⁩»: في الملف خطأ في الصياغة، غالبًا فاصلة زائدة في النهاية أو علامة اقتباس ناقصة أو قوس ناقص. رقم السطر والعمود يرشدانك إليه.
• الملف بصيغة ⁦JSON Lines (⁩كائن في كل سطر): هذا ليس مستند ⁦JSON⁩ واحدًا، فلن يُحلَّل. ضع الأسطر بين قوسين مربعين وأضف فاصلة في نهاية كل سطر عدا الأخير.
• أصبحت القائمة الخطأ هي الصفوف: اختارت الأداة أول مصفوفة كائنات وجدتها. عدّل الملف لتأتي القائمة التي تريدها أولًا، أو احفظ تلك القائمة وحدها في ملف مستقل.
• أعمدة كثيرة جدًا: البيانات شديدة التداخل تتسطّح إلى أعمدة كثيرة منقّطة. أوقف «تسطيح الحقول المتداخلة»، أو احذف الأعمدة التي لا تحتاجها بعد الفتح.

الخصوصية

صادرات الـ ⁦API⁩ تحتوي غالبًا على أسماء العملاء وبريدهم الإلكتروني ومعرّفاتهم. هنا يُقرأ الملف ويُحوَّل بالكامل بواسطة ⁦JavaScript⁩ في تبويب متصفحك، ولا يُرسل أي شيء إلى خادم. وللاتجاه المعاكس، استخدم «تحويل ⁦CSV⁩ إلى ⁦JSON⁩».