محول JSON إلى CSV

مصفوفة من الكائنات

مصفوفة من الكائنات هي المصدر الأوضح لـ CSV لأن كل كائن يصبح صفًا واحدًا.

[
  {"id": 1, "name": "Ada"},
  {"id": 2, "name": "Lin"}
]

تصبح المفاتيح أعمدة وتصبح الكائنات صفوفًا.

كائن واحد

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

{
  "results": [
    {"id": 1, "status": "active"},
    {"id": 2, "status": "paused"}
  ],
  "count": 2
}

تحديد results ينشئ صفين. القيمة المغلفة count لا تتحول إلى سجل ثالث.

كائنات بمفاتيح مختلفة

مصفوفات JSON الحقيقية لا تحتوي دائمًا على كائنات متطابقة. يقوم المحول ببناء اتحاد للمفاتيح عبر السجلات المحددة.

[
  {"id": 1, "email": "[email protected]"},
  {"id": 2, "phone": "555-0100"}
]

يحتوي CSV على أعمدة id وemail وphone، مع قيمة فارغة حيث لا يحتوي السجل على ذلك المفتاح.

لا يمكن للكائنات المتداخلة أن تتناسب مباشرة مع أعمدة CSV العادية. تقوم هذه الأداة بتسوية مسارات الكائنات الأساسية إلى أسماء أعمدة.

{
  "user": {
    "name": "Ada",
    "address": {
      "city": "London"
    }
  }
}

الأعمدة المقترحة:

user.name
user.address.city

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

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

• دمج القيم الأولية: ["red","blue"] يصبح red, blue.
• الاحتفاظ كـ JSON: الحفاظ على نص المصفوفة الكامل في خلية مقتبسة.
• ترك فارغًا: متاح فقط كخيار صريح من المستخدم، وليس الافتراضي الصامت.

الفاصل

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

صف الترويسة

يتضمن الإخراج الافتراضي أسماء الأعمدة. يزيل مفتاح التبديل الترويسة للأنظمة التي تقبل الصفوف الخام فقط.

الاقتباس

يتم اقتباس قيم CSV التي تحتوي على الفاصل أو علامة اقتباس أو فاصل أسطر بشكل صحيح. يتم تخطي علامات الاقتباس الحرفية داخل حقل مقتبس.

• اقتباس أدنى
• اقتباس جميع الحقول
• نهاية السطر
• تضمين BOM UTF-8 عند الحاجة لتوافق جداول البيانات

القيم الفارغة والقيم null

اختر كيفية تمثيل null والمفاتيح المفقودة والسلاسل الفارغة: خلية فارغة، أو null حرفي، أو عنصر نائب مخصص. تجعل المعاينة الفرق مرئيًا قبل التنزيل.

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

الإخراج يحتوي على صف واحد فقط

القيمة المحددة من JSON هي على الأرجح كائن واحد وليس مصفوفة السجلات. اختر المصفوفة المتداخلة التي تحتوي على السجلات.

الحقول المتداخلة مفقودة

قم بتمكين التسوية أو اختر "الاحتفاظ بالقيمة المتداخلة كـ JSON". تحذر الأداة عندما تتجاوز القيمة عمق التسوية المحدد.

بعض الصفوف تحتوي على خلايا فارغة

كائنات JSON تحتوي على مفاتيح مختلفة أو قيم مفقودة. يتطلب CSV مجموعة مشتركة من الأعمدة، لذا تصبح القيم المفقودة خلايا فارغة أو العنصر النائب المحدد.

المصفوفات غير مقروءة في Excel

غيّر استراتيجية المصفوفة. ادمج القيم الأولية للوسوم البسيطة، أو احتفظ بالمصفوفة الأصلية كـ JSON مضغوط عندما تكون البنية مهمة.

الأحرف المشكلة تبدو غير صحيحة

نزّل بإعدادات متوافقة مع UTF-8 وافتح الملف باستخدام الترميز الصحيح. إذا كان خيار BOM موجودًا، فإنه يغير فقط بادئة البايت؛ ولا يعيد ترميز المحتوى.