تحويل JSON إلى CSV
جداول مرتبة من بيانات فوضوية

ما الذي تقدمه هذه الأداة عند تحويل JSON إلى CSV

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

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

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

من JSON متداخل إلى أعمدة مسطحة

خلية الجدول تحمل قيمة واحدة. لذلك عندما يحتوي السجل على كائن عنوان، يعطي المحول كل جزء عمودًا خاصًا: address.city وaddress.country وهكذا. الأسماء التي فيها نقطة تبيّن مصدر كل قيمة بدقة.

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

من JSON إلى CSV دون ضياع أي حقل

كثير من المحولات تقرأ JSON بالمحلل المدمج في المتصفح، وهذا المحلل يقرّب الأرقام الطويلة. معرّف طلب مثل 12345678901234567890 يعود بالشكل 12345678901234567000، أي طلبًا آخر. أما هذه الأداة فتقرأ كل رقم كما لصقته حرفيًا. وبهذا تبقى المعرّفات وأرقام الحسابات كاملة.

كذلك نادرًا ما تتطابق السجلات تمامًا. عميل لديه رقم هاتف والذي بعده ليس لديه. يجمع المحول كل حقل بالترتيب الذي يظهر به، ويترك الخلية فارغة حيث تغيب القيمة. بعد ذلك يعدّ جدول الفحوصات هذه الخلايا الفارغة نيابة عنك.

أين تُوجد سجلاتك

غالبًا ما تضع ردود الواجهات البرمجية القائمة التي تريدها داخل كائن آخر، مثل { "data": [ ... ] } أو { "results": [ ... ] }. وإذا كان في الداخل قائمة كائنات واحدة فقط، يستخدمها المحول ويخبرك بذلك. والكائن المفرد يصبح صفًا واحدًا، ومصفوفة المصفوفات تُكتب صفًا بعد صف.

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

من JSON إلى Excel دون حروف مشوهة

برنامج Excel صعب مع الملفات النصية. فإذا لم يبدأ ملف CSV بعلامة صغيرة اسمها علامة ترتيب البايت، قد يخمّن Excel ترميزًا خاطئًا. عندها تتحول الأسماء العربية أو الأسماء مثل Zoë إلى رموز غير مفهومة. فعّل خيار التنزيل الجاهز لـExcel، فيحمل الملف هذه العلامة ويفتح بشكل صحيح بنقرة مزدوجة.

يمكنك أيضًا تغيير الفاصل. في بعض البلدان تُستخدم الفاصلة للكسور العشرية، لذلك يتوقع Excel هناك فاصلة منقوطة بين الأعمدة. اختر الفاصلة المنقوطة أو علامة الجدولة أو الخط العمودي، وستتحدث المعاينة فورًا.

الحماية من صيغ برامج الجداول

الخلية التي تبدأ بـ = أو + أو - أو @ قد تعمل كصيغة عند فتح الملف. يخفي المهاجمون الأوامر بهذه الطريقة، وتسميها OWASP حقن CSV. ومع تفعيل الحماية تحصل هذه الخلايا على فاصلة علوية في بدايتها، فتفتح كنص عادي. أما الأرقام السالبة فلا تُمس، ويذكر جدول الفحوصات كل خلية تغيّرت.

علامات الاقتباس والفواصل وفواصل الأسطر بلا مشاكل

في CSV قاعدة تُفسد الملفات المصنوعة يدويًا: القيمة التي تحتوي على الفاصل أو علامة اقتباس أو سطر جديد يجب أن تكون بين علامتي اقتباس مزدوجتين. كما يجب مضاعفة كل علامة اقتباس داخلها. يتبع المحول المعيار RFC 4180 بدقة، لذلك يصل اسم مثل Sara "Sam" Malik أو عنوان فيه فاصلة سليمًا.

قبل استيراد الملف إلى مكان مهم، يمكنك مقارنته بتصدير أقدم. أداة مقارنة النصوص لدينا تعرض كل سطر تغيّر جنبًا إلى جنب.

من يحتاج بيانات JSON في جدول بيانات

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

المطورون يستخدمونها أيضًا. ملف CSV سريع يسهّل فحص رد واجهة برمجية بالعين، أو ترتيبه، أو إرساله لزميل. وفي الوقت نفسه يحمّل المحللون الملف إلى Google Sheets أو إلى شاشة استيراد في قاعدة بيانات. الخطوات واحدة للجميع: الصق، ثم اقرأ الفحوصات، ثم نزّل.