منسّق JSON

اختيار صيغة البيانات

JSON هو الصيغة الافتراضية لكل ما تُرجعه واجهة API أو يقرأه برنامج: فهو يتعامل بطبيعته مع البنى المتداخلة والأرقام والقيم المنطقية وnull، وكل لغة تحلّله. أما CSV فأصغر حجماً ويُفتح مباشرة في جدول بيانات، لكنه لا يملك وسيلة للتعبير عن التداخل ولا معياراً مشتركاً للفاصل أو التنصيص أو مجموعة المحارف، وهذا بالضبط موضع الخطأ في التحويلات. أما XML فمطوّل لكنه يحمل السمات والمحتوى المختلط والمخططات، ولذلك ما زال مهيمناً على صيغ المستندات والتكاملات القديمة. وYAML هو الأسهل قراءةً في الإعدادات لكنه حساس للمسافات البيضاء وفيه إكراه مفاجئ للأنواع («no» تصبح false، وإصدار مثل 1.10 يصبح 1.1). فاختر الصيغة التي تفضّلها الأداة المستهلكة لا الصيغة الأجمل منظراً.

أين تنكسر التحويلات بهدوء

معظم أخطاء التحويل لا تتعلق بالصياغة بل بالمعنى. فعمود من الرموز البريدية في ملف CSV يفقد أصفاره البادئة في اللحظة التي يخمّن فيها جدول البيانات أنه رقم؛ ومعرّف طويل يتجاوز دقة الفاصلة العائمة؛ والتواريخ يتغير معناها بحسب ما إذا كان اليوم أولاً أم الشهر أولاً. ومفاتيح JSON غير مرتبة أما المصفوفات فمرتبة، والأداة التي ترتب المفاتيح لا تغيّر شيئاً بينما التي ترتب المصفوفات تغيّر البيانات. وUnicode فخ آخر: فقد يصل النص بترميز UTF-8 أو UTF-16 أو مع علامة ترتيب البايتات، وفاكّ الترميز الذي يخمّن خطأً يحوّل المحارف المشكّلة إلى نص مشوّه. وقبل أن تثق بأي تحويل، افحص الصف الأول والأخير، وكل حقل فيه أصفار بادئة، وكل حقل يحتوي على علامات تنصيص أو فواصل أو أسطر جديدة.