JSON إلى CSV

مثال

المُدخل:

[
  { "id": 1, "user": { "name": "Alice", "email": "a@a.com" }, "tags": ["admin"] },
  { "id": 2, "user": { "name": "Bob",   "email": "b@b.com" }, "tags": ["user", "beta"] }
]

المخرَج (تسطيح المتداخل، ربط المصفوفات):

id,user.name,user.email,tags
1,Alice,a@a.com,admin
2,Bob,b@b.com,"user,beta"

اختيار الفاصل

قواعد الاقتباس

يجب اقتباس حقل عندما يحتوي على:

• الفاصل
• علامة اقتباس مزدوجة (يُهرَب منها بالتكرار: " -> "")
• سطر جديد

“الاقتباس دائما” أأمن للتوافق عبر الأدوات؛ و“الاقتباس عند الحاجة فقط“ يجعل الملف أسهل للقراءة يدويا.

معالجة الكائن المتداخل

• تسطيح: { user: { name: "A" } } يصبح عمود user.name. المسارات العميقة تصبح a.b.c.d.
• سلسلة JSON: يبقى الكائن المتداخل كقيمة JSON بعمود واحد: "{\"name\":\"A\"}". مفيد عندما تستطيع الأدوات اللاحقة تحليلها.
• التحويل إلى سلسلة: يربط بفاصل، فاقدا البنية.

معالجة المصفوفة

• ربط: ["a", "b"] يصبح "a,b" في عمود واحد.
• أعمدة مفهرسة: ينتج tags.0 وtags.1 وtags.2، يعمل فقط حين يكون طول المصفوفة متسقا.
• العنصر الأول فقط: يأخذ tags[0] ويتجاهل الباقي.

أخطاء شائعة

• مفاتيح متفاوتة عبر الكائنات. إن كان لدى كائن phone وآخر لا، يحصل CSV على عمود phone بخلايا فارغة للصفوف المفقودة. تحقق دائما من اتساق مجموعة المفاتيح.
• نسيان BOM لـ Excel. يقرأ Excel على ويندوز ملفات CSV بترميز UTF-8 دون BOM كـ Latin-1 ويشوّه الأحرف المشكولة. تقدّم الأداة مفتاح “إضافة BOM لـ UTF-8” لتلك الحالة.
• تضمين أسطر جديدة في القيم. قانوني في CSV وفق RFC 4180، لكن بعض المستوردات تختنق. إن كان هدفك هشا، استبدل \n بمسافة أو رمز \\n.
• استخدام Excel كصيغة ذهاب وعودة. يحوّل Excel 007 إلى 7 بصمت، ويقتطع الأرقام الطويلة، ويفسد الأصفار البادئة في المعرّفات. لسلامة البيانات، استخدم CSV مع محلل مناسب.