منسّق XML

جمّل مستندات XML ونسّقها.

واجهة الأداة نفسها باللغة الإنجليزية حاليًا، وتعمل بالكامل داخل متصفحك.

جارٍ تحميل الأداة…

ما هو XML؟

XML، أي لغة الترميز القابلة للتوسيع، وحّدها اتحاد W3C عام 1998 كطريقة عامة لوصف المستندات المنظمة بوسوم تعرّفها بنفسك. وتقوم عليها بنية تحتية كبيرة باقية: خدمات SOAP، وخلاصات RSS، وصور SVG، وملفات Office وOpenDocument، وتخطيطات أندرويد، وبناءات Maven، وتكاملات مؤسسية لا تحصى.

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

لماذا أنشأنا هذه الأداة

كل من يتكامل مع بنك أو خدمة حكومية أو شركة شحن أو نظام مؤسسي قديم ما زال يقضي وقتًا في قراءة XML خام، وهو عادةً غلاف SOAP أو ملف تسوية مُلقى في سطر واحد في سجل.

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

نصائح وأخطاء شائعة

  • بادئات مساحات الأسماء ذات معنى؛ لا تعد تسميتها لترتيب المستند.
  • المسافات داخل العناصر ذات المحتوى المختلط لها دلالة، فقد يختلف الناتج المنسق قليلًا عن الأصل في العقد التي تحمل نصًا.
  • علامة & شاردة كان يجب أن تكون & هي أكثر أسباب فشل سلامة البنية شيوعًا.
  • احذف رؤوس المصادقة من أغلفة SOAP قبل مشاركتها في تذكرة.

بداية سريعة: استخدام منسّق XML

  1. الصق XML الذي تحتاج إلى قراءته في مربع الإدخال أعلاه.
  2. اضبط عرض الإزاحة المفضل.
  3. نسّق المستند؛ فأخطاء التحليل ستشير إلى موضع الخلل.
  4. اقرأ البنية المزاحة لتجد العنصر الذي تبحث عنه.
  5. انسخ XML المنسق أو نزّله كملف.

للمكافئ في JSON، استخدم منسّق JSON. ولمقارنة مستندين سطرًا بسطر، جرّب مقارنة النصوص.

ماذا يفعل التنسيق

يعيد منسّق XML طباعة الترميز بإزاحة متسقة، فيضع كل عنصر في سطره ويُدرج العناصر الفرعية تحت آبائها. البيانات والوسوم لم تتغير؛ فقط أُضيفت مسافات. والمكسب أن التسلسل الهرمي للمستند، أي العنصر الذي يحتوي الآخر، يصبح واضحًا بنظرة.

التنسيق لتتبع الأخطاء

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

  • وسوم غير مغلقة: عنصر فُتح ولم يُغلق.
  • وسوم غير متطابقة: إغلاق </b> وقد فتحت <a>.
  • غياب العنصر الجذري: يحتاج XML إلى عنصر علوي واحد بالضبط يحيط بكل شيء.
  • أحرف غير مهرّبة: & أو < أو > خام داخل النص كان يجب تهريبها إلى &amp; و&lt; و&gt;.

قواعد XML الصارمة

XML أكثر صرامة من HTML. فكل وسم يجب أن يُغلق، والوسوم يجب أن تتداخل بشكل صحيح (دون تشابك)، وقيم السمات يجب أن تُقتبس، ويجب وجود عنصر جذري واحد. والتنسيق يجعل مخالفات هذه القواعد بارزة.

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

  • قراءة استجابة SOAP أو API وصلت مضغوطة.
  • تتبع خطأ في ملف إعدادات أو خلاصة برؤية بنيته.
  • اكتشاف وسم غير مغلق يشكو منه المحلل.
  • ترتيب XML معدّل يدويًا قبل استخدامه.

أدوات أخرى من أدوات المطورين

تصفح جميع أدوات المطورين ←