محول XML إلى YAML

مثال على التحويل

XML:

<server port="8080" env="production">
  <hosts>
    <host>api.example.com</host>
    <host>api2.example.com</host>
  </hosts>
  <timeout>30</timeout>
</server>

YAML:

server:
  "@attributes":
    port: "8080"
    env: "production"
  hosts:
    host:
      - "api.example.com"
      - "api2.example.com"
  timeout: "30"

التمثيل الثابت

يبقى عنصر الجذر في XML مفتاح المستوى الأعلى في YAML. توضع السمات تحت @attributes. أما العنصر الذي لا يحتوي إلا على نص فيصبح سلسلة YAML بين علامتي اقتباس. وبذلك تظل قيم مثل 0012 وtrue و2026-07-30 نصوصا بدلا من أن يتغير نوعها. وتصبح العناصر الشقيقة المتتالية ذات الاسم نفسه قائمة YAML.

إذا احتوى العنصر على سمات ونص معا، يوضع النص تحت #text. وإذا تداخل النص مع العناصر الأبناء، أو تكرر اسم عنصر بعد عنصر ابن مختلف، يستخدم المحول #content للاحتفاظ بالترتيب. يظهر كل عنصر XML في تلك القائمة كمدخل ذي مفتاح واحد.

تبقى بادئات مساحات الأسماء في XML جزءا من مفاتيح YAML، وتظهر تصريحات مساحات الأسماء تحت @attributes. يحافظ ذلك على الأسماء الظاهرة في XML، لكنه لا يفسر المعنى الدلالي لمساحات الأسماء ولا يتحقق من مخطط يراعيها.

الحدود والبيانات المحذوفة

يقبل المحول مستند XML واحدا بحجم لا يتجاوز 1 ميجابايت، وعمق يصل إلى 100 مستوى، وبحد أقصى 100,000 عنصر. لا يجوز أن يتجاوز YAML الناتج 2 ميجابايت. ترفض الأداة تصريحات DTD وتصريحات ENTITY المخصصة. وتحذف تعليقات XML وتعليمات المعالجة. يتحول CDATA إلى نص عادي، ويفك محلل المتصفح مراجع محارف XML القياسية.

يمثل YAML الناتج البيانات بصورة مقروءة، وليس صيغة تضمن تحويل XML ذهابا وإيابا بلا فقد. راجع النتيجة قبل إضافتها إلى تطبيق أو عملية ترحيل.

الخصوصية والتخزين في المسار الموجّه

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