Map Extract
أداة مجانية

تحويل JSON إلى جدول CSV

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

تعمل في متصفحكم. لا يُرفع أي شيء تكتبونه.

أربع خطوات

  1. الصقوا JSON

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

  2. اتركوا التسطيح مفعّلًا

    يصبح {"customer": {"city": ...}} عمودًا باسم customer.city. أطفئوه لإبقاء كل كائن متداخل نص JSON في خلية واحدة.

  3. اختاروا الفاصل

    الفاصلة مناسبة لـ Google Sheets ومعظم البرامج. إن فتحتم الملف في Excel ورأيتم كل البيانات في عمود واحد، فاختاروا الفاصلة المنقوطة وجرّبوا مرة أخرى.

  4. انسخوا أو نزّلوا

    تذكر الملاحظة عدد الصفوف والأعمدة. انسخوا CSV أو نزّلوا data.csv. إن كان JSON غير صالح، تخبركم رسالة الخطأ أين توقفت القراءة.

مثال: طلبات متجر عبايات إلكتروني

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

المُدخل
[
  {"order": 5521, "total": 640, "customer": {"name": "نورة", "city": "الدمام"}, "sizes": ["S", "M"]},
  {"order": 5522, "total": 385.5, "customer": {"name": "هدى", "city": "أبها", "mobile": "+966500000002"}}
]
النتيجة
order,total,customer.name,customer.city,sizes,customer.mobile
5521,640,نورة,الدمام,S; M,
5522,385.5,هدى,أبها,,+966500000002

ماذا يحدث للقوائم داخل السجلات؟

القائمة البسيطة مثل المقاسات تُجمع في خلية واحدة مفصولة بفاصلة منقوطة: S; M. أما قائمة الكائنات، مثل أصناف الطلب لكل منها سعر وكمية، فتُوزَّع على أعمدة مرقّمة مثل items.0.sku وitems.1.sku.

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

أسئلة شائعة

لماذا ظهر العمود customer.mobile في النهاية؟

تُرتَّب الأعمدة حسب أول ظهور لكل مفتاح. الجوال ظهر أولًا في السجل الثاني، فجاء بعد الأعمدة التي ظهرت في السجل الأول.

هل يتعامل مع الملفات الكبيرة؟

يعمل في المتصفح، فالحد هو ذاكرة جهازكم. بضعة آلاف من السجلات لا تمثل مشكلة؛ للملفات الضخمة جدًا جرّبوا جزءًا أولًا.

هل يبقى النص العربي سليمًا عند فتح الملف في Excel؟

يُحفظ الملف بترميز UTF-8. إن ظهرت الحروف مشوهة في Excel فمرّروا الملف على أداة تحويل CSV إلى Excel لتحصلوا على xlsx يُفتح سليمًا.

أين تذهب بياناتكم

يتم التحويل في متصفحكم. لا يُرسل JSON ولا CSV إلى Map Extract ولا إلى أي جهة.

رُوجعت مع الأداة بتاريخ