تحويل ⁦JSON⁩ إلى ⁦XML⁩:
المحوّل

كيف يصبح ⁦JSON⁩ ملف ⁦XML:⁩ مثال عملي

خذ هذا المُدخل: {"⁦order⁩": {"@_⁦id⁩": ⁦7,⁩ "⁦customer⁩": {"⁦name⁩": "⁦Ana⁩", "⁦city⁩": "⁦Lyon⁩"}, "⁦items⁩": [{"⁦sku⁩": "⁦A1⁩"}, {"⁦sku⁩": "⁦B2⁩"}]}}. يحتوي الملف على مفتاح واحد في المستوى الأعلى يحمل كائنًا، لذا يصبح ⁦order⁩ هو العنصر الجذر. الناتج هو <⁦order id⁩="⁦7⁩"> ويضم عنصر <⁦customer⁩> بداخله <⁦name⁩>⁦Ana⁩</⁦name⁩> و<⁦city⁩>⁦Lyon⁩</⁦city⁩>، يليه عنصران <⁦items⁩>، واحد لكل إدخال في القائمة.

تكرّر القائمة مفتاحها مرة لكل إدخال بدلًا من إضافة غلاف يضم عناصر <⁦item⁩> فرعية، وهذه هي الطريقة التي تكتب بها معظم صيغ ⁦XML⁩ القوائم. يأتي الناتج بمسافة بادئة من مسافتين.

العنصر الجذر والسمات والنص

• الجذر. عندما يكون ⁦JSON⁩ مفتاحًا واحدًا يحمل كائنًا، يصبح هذا المفتاح هو الجذر. وأي شيء آخر يُغلَّف داخل <⁦root⁩>: كائن له عدة مفاتيح في المستوى الأعلى، أو قيمة مفردة، أو مصفوفة يصبح كل إدخال فيها عنصر <⁦item⁩>.
• السمات. المفاتيح التي تبدأ بـ @_ تصبح سمات، فيتحول "@_⁦currency⁩": "⁦EUR⁩" إلى ⁦currency⁩="⁦EUR⁩". ويُتجاهَل مفتاح @_ الذي يحمل كائنًا أو قائمة، لأن السمة لا تحمل إلا قيمة بسيطة.
• نص العنصر. المفتاح المسمّى #⁦text⁩ يصبح النص الخاص بالعنصر، فينتج {"⁦price⁩": {"@_⁦currency⁩": "⁦EUR⁩", "#⁦text⁩": ⁦9.5⁩}} العنصر <⁦price currency⁩="⁦EUR⁩">⁦9.5⁩</⁦price⁩>.
• تستخدم أداة ⁦XML⁩ إلى ⁦JSON⁩ الأعراف نفسها، لذا يمكن تحويل ناتجها هنا مرة أخرى إلى ⁦XML⁩ مشابه.

حالات خاصة يتعامل معها المحوّل

• مفاتيح ليست أسماء ⁦XML⁩ صالحة. لا يجوز أن تحتوي أسماء العناصر على مسافات أو معظم علامات الترقيم، ولا أن تبدأ برقم. تتحول تلك المحارف إلى شرطات سفلية وتُضاف شرطة سفلية في البداية عند الحاجة، فيصبح "⁦first name⁩" هو ⁦first⁩_⁦name⁩، ويصبح "⁦2nd⁩" هو _⁦2nd.⁩
• النقطتان الرأسيتان. تتحول النقطتان أيضًا إلى شرطة سفلية، فيخرج ⁦dc:title⁩ بالشكل ⁦dc⁩_⁦title.⁩ أما مفاتيح السمات فتبقى كما هي، لذا يظل "@_⁦xmlns:dc⁩" يعمل تصريحًا لنطاق أسماء.
• المحارف الخاصة. تُهرَّب &، و< و> داخل القيم إلى &⁦amp⁩; و&⁦lt⁩; و&⁦gt⁩;، فيبقى المستند صالحًا.
• القيم ⁦null⁩ والفارغة. تصبح ⁦null⁩ والكائنات الفارغة عناصر ذاتية الإغلاق مثل <⁦note/⁩>. أما القائمة الفارغة فلا تُنتج أي عنصر.
• قوائم داخل قوائم. لا يمكن كتابة قيمة مثل [[⁦1, 2⁩], [⁦3, 4⁩]] عناصرَ متكررة عادية، لذا تحصل كل قائمة داخلية على عناصر <⁦item⁩> فرعية خاصة بها.

مطابقة صيغة حدّدها غيرك

لا يوجد مخطط (⁦schema)⁩، لذا لا يستطيع المحوّل أن يعرف هل يريد النظام قيمة ما سمةً أم عنصرًا فرعيًا. لمطابقة صيغة موجودة، عدّل ⁦JSON⁩ أولًا: أضف @_ إلى المفاتيح التي يجب أن تكون سمات، وغلّف كل شيء في مفتاح واحد يحمل اسم العنصر الجذر المتوقع.

يُرفض ⁦JSON⁩ غير الصالح مع ذكر السطر والعمود اللذين فيهما المشكلة، وغالبًا ما تكون فاصلة ناقصة أو زائدة في النهاية أو علامة تنصيص ناقصة. كما أن ⁦JSON⁩ الذي يحتوي على تعليقات // ليس ⁦JSON⁩ صالحًا.

تحتاج إلى جدول بيانات بدلًا من ذلك؟ أداة ⁦JSON⁩ إلى ⁦CSV⁩ تحوّل السجلات إلى صفوف. ولملفات الإعدادات التي يعدّلها الناس يدويًا، تكون أداة ⁦JSON⁩ إلى ⁦YAML⁩ أسهل قراءةً من ⁦XML.⁩