محول TSV إلى JSON
تحويل البيانات المفصولة بعلامات جدولة إلى مصفوفة كائنات JSON.
عند نسخ مجموعة خلايا من جداول بيانات Google Sheets أو Excel، تستقر البيانات في الحافظة كنص مفصول بعلامات جدولة (Tab). تحول هذه الأداة النص الملصق مباشرة إلى مصفوفة JSON متكاملة بحيث يمثل كل سطر كائناً مستقلاً.
مصادر بيانات TSV وكيفية إنشائها
نادراً ما يقوم أحد بكتابة ملف بامتداد .tsv يدوياً من الصفر. تظهر هذه الصيغة عملياً عند تصدير التقارير من قواعد البيانات، أو تشغيل أدوات مثل mysql في وضع الدفعات، أو عند نسخ محتوى الخلايا من برامج الجداول الإلكترونية. ميزة هذا المصدر أنه ينتج بيانات ذات هيكل منتظم وخلايا متوازية مقارنة بملفات CSV المعدلة باليد.
في المقابل، تفتقر صيغة TSV عادة إلى آليات الهروب (escaping) الصارمة الموجودة في CSV. إذا احتوت خلية على علامة تبويب أصلية أو سطر جديد، قد تتأثر بعض أدوات التصدير، مما يبرز أهمية مراجعة عدد الأسطر في المخرجات للتأكد من مطابقتها للأصل.
خيارات معالجة الحقول في محول TSV إلى JSON
- تحديد ما إذا كان السطر الأول يمثل ترويسة تعطي أسماء المفاتيح، أو بيانات فعلية، لأن الخطأ هنا يزيح كل القيم بسطر واحد.
- التعامل مع القيم الرقمية مثل
0و1: هل تبقى أرقاماً أم تُترجم إلى قيم منطقية (false وtrue). - معالجة الخلايا الفارغة كقيم نصية فارغة، أو قيمة
null، أو استبعاد المفتاح من كائن JSON تماماً. - حفظ الأكواد المسبوقة بصفر مثل
0501كنصوص دون حذف الصفر الأولي واعتبارها الرقم 501. - طريقة معالجة الأعمدة الفارغة في أطراف الجدول الناتجة عن التصدير، سواء بالإبقاء عليها أو إهمالها.
الفروق بين TSV وCSV عند التحويل إلى كائنات برمجية
لا تتطابق آليات قراءة TSV مع معالجات CSV التقليدية. يتوقع محلل CSV عموماً وجود نصوص محاطة بعلامات اقتباس مزدوجة للتحكم بالحقول المركبة. بينما يؤدي تمرير نص مفصول بجدولة فقط إلى أداة CSV عادية إلى حدوث أخطاء غير مرئية عند مصادفة خانات فارغة أو فواصل غير تقليدية. لهذا السبب، صُممت الأداة خصيصاً للتعامل مع الفواصل المعتمدة على علامة Tab حصراً.
أسئلة شائعة حول تحويل TSV إلى JSON
كيف أبدأ عملية التحويل في الأداة؟
الصق البيانات المنسوخة من جدول البيانات مباشرة داخل المربع المخصص، أو حمّل ملف .tsv، ثم انقر زر التحويل بعد اجتياز التحقق.
لماذا يفقد الرمز البريدي الصفر الأول أثناء التحويل؟
إذا كانت خانة الرمز تحتوي أرقاماً متتالية فقط، قد تُعامل كقيمة رقمية بحتة فيسقط الصفر. احرص على تنسيق العمود في المصدر كنص لحفظ 0501 كرمز كامل.
هل يلزم أن يحتوي الملف على صف ترويسة في البداية؟
ليس بالضرورة، لكن ذلك يحدد شكل النتيجة. بوجود الترويسة تصبح النصوص أسماء للمفاتيح، وبدونها تُعطى الأعمدة مسميات افتراضية مثل column1 وcolumn2.
ماذا يحدث عند وجود علامة جدولة إضافية داخل محتوى الخلية؟
ستؤدي علامة الجدولة غير المفصولة باقتباس إلى فصل الخلية إلى خانتين واختلال محاذاة السطر، نظراً لاعتماد الصيغة على Tab كرمز حاسم للتجزئة.
هل يتم تخزين محتوى جداولي على الخادم بعد الانتهاء؟
تُرسل المدخلات إلى الخادم ليقوم المحرك البرمجي بمعالجتها، دون تخزينها بعد استلامك الناتج النهائي مباشرة.