كيفية تحويل JSON المتداخل إلى CSV بشكل صحيح

حوّل JSON المتداخل إلى CSV بتحويل حقول الكائنات المتداخلة إلى أعمدة وتحديد ما يجب أن تصبح عليه كل قائمة. أبقِ القائمة مجتمعة في خلية واحدة عندما تكون جزءاً من سجل واحد، أو أنشئ صفوفاً إضافية عندما يحتاج كل عنصر في القائمة إلى الظهور بمفرده.

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

متى يفيد هذا الدليل

يفيد هذا الدليل عندما يعطي تصدير JSON العادي معاينة CSV مربكة، خصوصاً إذا كان الملف يحتوي بيانات عملاء أو عناوين أو بنود طلب أو وسوماً أو قوائم أخرى.

الاختيار الأساسي بسيط: يمكن أن تتحول بعض المعلومات المتداخلة إلى أعمدة، بينما يمكن أن تبقى القوائم معاً في خلية واحدة أو تنشئ صفوفاً إضافية.

ماذا يفعل المحوّل بالبيانات المتداخلة

يمكن أن تصبح المعلومات الموجودة داخل قسم آخر أعمدة مستقلة. فمثلاً قد تظهر مدينة محفوظة داخل بيانات العميل في عمود مثل customer.city.

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

لا يوجد اختيار أفضل دائماً. الاختيار الصحيح يعتمد على ما تريد فعله بملف CSV.

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

1. 01

   أضف ملف JSON

   اختر ملف .json أو الصق نص JSON في الأداة.

2. 02

   انظر إلى المعاينة الأولى

   ابحث عن المعلومات المتداخلة والقوائم المهمة لعملك.

3. 03

   أبقِ الأعمدة المفيدة

   احتفظ بحقول العميل أو الطلب أو المنتج أو غيرها من الحقول التي تحتاجها فعلاً.

4. 04

   حدِّد ما تفعله بالقوائم

   أبقِ قيم القائمة معاً للحصول على CSV مختصر، أو أنشئ صفوفاً إضافية عندما يحتاج كل عنصر إلى الظهور منفصلاً.

5. 05

   راجع عدد الصفوف

   إذا أنشأت صفوفاً إضافية من القوائم، فتأكد من أن العدد الأكبر للصفوف منطقي مقارنة ببيانات المصدر.

6. 06

   نزِّل CSV وراجعه

   افتح النتيجة وراجع بعض السجلات قبل الاستيراد أو المشاركة.

• كيف أحمي المعرّفات التي تبدأ بأصفار؟ استخدم قبل تنزيل CSV الخيار الذي يحافظ على النص الذي يبدو كرقم. يساعد ذلك قيمة مثل 00123 على البقاء واضحة كنص.

مثال بسيط

يحتوي JSON التالي مدينة للعميل وقائمة قصيرة من العناصر:

{
  "order": "10417",
  "customer": { "city": "Porto" },
  "items": ["Mug", "T-shirt"]
}

يمكن أن تصبح المدينة عموداً مستقلاً مثل customer.city. ويمكن أن يبقى العنصران معاً في خلية واحدة، أو يتحولا إلى صفوف إضافية إذا كنت تحتاج إلى التعامل مع كل عنصر منفصلاً.

وهذا هو القرار الأساسي عند التعامل مع JSON المتداخل.

الخصوصية

يحدث التحويل على جهازك داخل المتصفح. لا يُرفع ملف JSON إلى خادم لمعالجته.

وهذا مفيد عندما يحتوي التصدير بيانات عملاء أو طلبات أو معلومات مالية أو غيرها من المعلومات الخاصة.

الحدود العملية

تعرض صفحة الأداة حد حجم الملف الحالي المأخوذ من الإعدادات المنشورة.

قد تستغرق الملفات المتداخلة الكبيرة وقتاً أطول وتحتاج إلى ذاكرة أكبر. كما قد يؤدي إنشاء صفوف إضافية من قوائم كبيرة إلى جعل CSV أكبر بكثير من الجدول الذي توقعته في البداية.

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

النتيجة

يجب أن يكون ملف CSV النهائي سهل القراءة ومناسباً للطريقة التي تخطط لاستخدام البيانات بها. تتحول المعلومات المتداخلة إلى أعمدة مفيدة، بينما تبقى القوائم معاً أو تنشئ صفوفاً إضافية حسب اختيارك.

{
  "id": 1042,
  "name": "Alex",
  "address": { "city": "Berlin" }
}