محول مجاني

محول JSON إلى CSV

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

حول هذه الأداة

يؤدي الانتقال من JSON إلى CSV إلى تسوية البيانات الهرمية في نموذج جدولي. تكمن قوة JSON في قدرته على وصف الكائنات المتداخلة، والمصفوفات ذات الطول المتفاوت، والمعلومات الغنية بالنوع؛ لا يمكن للبنية الأبسط لـ CSV التعبير عن أي من ذلك محليًا. وبالتالي يتضمن التحويل اختيارات: الحقول التي ستصبح أعمدة، وكيفية تسوية الكائنات المتداخلة (باستخدام تدوين نقطي مثل Address.city)، وما يجب فعله بالمصفوفات داخل السجلات.

يتعامل هذا المحول مع الحالة الشائعة - مجموعة من الكائنات المسطحة ذات المفاتيح المتسقة - مباشرةً: يصبح كل كائن صفًا، ويصبح اتحاد المفاتيح عبر جميع الكائنات هو مجموعة الأعمدة، وتتحول الحقول المفقودة إلى خلايا فارغة. بالنسبة للبيانات المتداخلة، يوفر المحول خيار التسوية الذي يربط المفاتيح المتداخلة بالنقاط، مما يؤدي إلى إنتاج رؤوس الأعمدة مثل user.name وuser.email وaddress.zip.

يقوم PapaParse بإنشاء مخرجات CSV، مع تطبيق علامات الاقتباس المناسبة للحقول التي تحتوي على فواصل أو أسطر جديدة أو أحرف الاقتباس. الإخراج متوافق مع RFC 4180 ويتم فتحه بشكل واضح في Excel وGoogle Sheets وأي أداة أخرى متوافقة مع CSV.

لماذا تحويل JSON إلى CSV

لا تزال جداول البيانات هي تنسيق البيانات العالمي لغير المطورين. تعيش فرق المبيعات وفرق المالية وفرق التسويق ومعظم وظائف الأعمال الأخرى في Excel أو جداول بيانات Google، ومطالبتهم باستهلاك JSON مباشرة يطلب منهم قراءة تنسيق بيانات المبرمج. تحويل جسور JSON إلى CSV من مخرجات API وتصدير قاعدة البيانات إلى النموذج الذي يفتحه مستخدمو الأعمال بالفعل.

يعد CSV أيضًا التنسيق الأكثر موثوقية للاستيراد إلى الأنظمة القديمة. تقبل عمليات استيراد CRM الأقدم وبرامج المحاسبة وأدوات التحليلات ملف CSV وليس JSON. غالبًا ما يكون التحويل قبل الاستيراد هو المسار الوحيد.

كيفية الاستخدام

الصق أو حمّل JSON، واختر التسطيح، واحصل على ملف CSV.

  1. أضف ملف JSON الخاص بك: الصق نص JSON في منطقة الإدخال أو قم بإسقاط ملف .json. يجب أن يكون الإدخال عبارة عن مصفوفة JSON من الكائنات (أو كائن JSON يحتوي على مثل هذه المصفوفة). تنتج الأشكال الأخرى مخرجات محدودة.
  2. اختر التسطيح: تعطيل للاحتفاظ بحقول المستوى الأعلى فقط (يتم تقييد الكائنات المتداخلة). تمكين تسوية الكائنات المتداخلة في أعمدة مفصولة بنقاط (user.name، user.email).
  3. تحويل: يسير المحول في مصفوفة JSON، ويجمع اتحاد المفاتيح، ويكتب صفًا واحدًا لكل كائن. يعالج PapaParse الاقتباس والهروب لمخرجات CSV.
  4. تنزيل أو نسخ: احفظه بتنسيق ‎.csv أو انسخه إلى الحافظة. يتم فتح الإخراج في Excel أو Sheets أو أي مستخدم آخر لملف CSV.

حالات الاستخدام الشائعة

التفاصيل الفنية

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

عند تمكين التسوية، يتم نقل الكائنات المتداخلة بشكل متكرر: { user: { name: 'A', email: 'B' } } يصبح عمودين user.name وuser.email. يتم تقييد المصفوفات الموجودة داخل الكائنات (يتم تحويلها مرة أخرى إلى نص JSON) نظرًا لأن ملف CSV لا يمكنه تمثيل قيم متعددة لكل خلية بشكل أصلي.

تقوم وظيفة إلغاء التحليل الخاصة بـ PapaParse بإنشاء إخراج CSV. يتم تغليف الحقول التي تحتوي على فواصل أو أسطر جديدة أو علامات اقتباس بعلامات اقتباس مزدوجة، مع تخطي علامات الاقتباس الداخلية بالمضاعفة. يستخدم الإخراج نهايات سطر CRLF ويتضمن صف الرأس بشكل افتراضي.

أفضل الممارسات

الأسئلة الشائعة

هل يؤدي تحويل JSON إلى CSV إلى تغيير المحتوى؟
يتم الحفاظ على المحتوى بأكبر قدر ممكن من الدقة. ومع ذلك، قد لا تحتوي بعض الميزات الخاصة بالتنسيق على مكافئات مباشرة، لذلك يمكن أن تحدث اختلافات بسيطة في التنسيق.
لماذا التحويل إلى تنسيق CSV؟
يتم دعم ملف CSV عالميًا من خلال تطبيقات جداول البيانات (Excel وGoogle Sheets) وقواعد البيانات ولغات البرمجة. إنه أبسط تنسيق لتبادل البيانات الجدولية.
هل يتعامل المحول مع بنيات JSON المتداخلة أو المعقدة؟
نعم. تقوم الأداة بتحليل الكائنات المتداخلة والمصفوفات وجميع أنواع بيانات JSON القياسية بشكل صحيح، مع الحفاظ على بنية البيانات الكاملة في مخرجات CSV.
هل هذا التحويل آمن وخاص؟
نعم. تتم جميع عمليات المعالجة محليًا في متصفحك. لا تترك بياناتك جهازك أبدًا - لا يوجد تحميل على الخادم، ولا معالجة سحابية، ولا جمع بيانات.
هل يتم تحميل بياناتي على الخادم؟
لا، يتم تشغيل التحويل في متصفحك باستخدام PapaParse.
ماذا عن الكائنات ذات المفاتيح المختلفة في نفس المصفوفة؟
رأس CSV هو اتحاد كافة المفاتيح. الكائنات التي تفتقد مفتاحًا معينًا تنتج خلايا فارغة في هذا العمود. يظل ملف CSV صالحًا، ولكنه متناثر فقط.
هل يمكنني التحويل مرة أخرى من CSV إلى JSON؟
نعم - استخدم أداة CSV إلى JSON. يمكن أن تكون الرحلة ذهابًا وإيابًا بدون خسارة للبيانات الثابتة؛ قد تحتاج البيانات المتداخلة إلى التطبيع.
ما هو الحد الأقصى للحجم؟
ما يصل إلى 50 ميجابايت من مدخلات JSON. قد تتباطأ الملفات الأكبر حجمًا بسبب ذاكرة المتصفح.