ماذا تفعل أداة تنسيق XML؟
تعالج الأداة مستند XML واحدًا وتعرض نتيجة قابلة للنسخ والتنزيل. تتحقق من البنية قبل تنسيق XML أو تصغيره أو تحويله إلى JSON. في الاتجاه الآخر، تقبل كائن JSON وتبني منه XML. لا تتحقق الأداة من مطابقة مخطط XSD أو قواعد تطبيقك.
متى تختار التنسيق ومتى تختار التحويل؟
اختر تنسيق XML أو تصغير XML إذا كان نظامك يتطلب XML. استخدم التحويل إلى JSON للتكامل مع تطبيق آخر بعد مراجعة تمثيل السمات والنصوص والعناصر المتكررة. احتفظ بالمصدر عند الحاجة إلى استعادة المستند الأصلي حرفيًا.
كيف تستخدمها؟
- اختر تنسيق XML أو تصغير XML أو XML → JSON أو JSON → XML من قائمة العملية.
- الصق مستندًا كاملًا في الإدخال، ثم اضغط تحويل. في وضع JSON → XML، استخدم كائنًا يحتوي على خصائص للعناصر الجذرية.
- راجع النتيجة ورسائل الخطأ، ثم انسخ الناتج أو نزّله. حد الإدخال 5 ميغابايت، وتتم المعالجة محليًا.
مثال فعلي للإدخال والإخراج
تنسيق مستند XML مضغوط
الإدخال
<project private="true"><name>KitLumi</name><tool>XML</tool></project>الإخراج
<project private="true">
<name>KitLumi</name>
<tool>XML</tool>
</project>يتحقق المحلل من البنية، ثم يعيد بناء العناصر بمسافة بادئة من مسافتين. قد تتغير طريقة كتابة المستند؛ الناتج ليس نسخة حرفية من المصدر.
أخطاء شائعة وطرق الإصلاح
| العرض | السبب المحتمل | الإصلاح |
|---|---|---|
| تظهر رسالة عن وسم إغلاق غير صالح. | وسم الإغلاق مفقود أو لا يطابق اسم وسم البداية، بما في ذلك حالة الأحرف. | أغلق كل عنصر باسمه الصحيح، وراجع السطر المشار إليه في رسالة المحلل ثم أعد التحويل. |
| تختلف بنية البيانات بعد التحويل بين XML وJSON. | لا تملك سمات XML والنصوص والعناصر المتكررة ومساحات الأسماء تمثيلًا مطابقًا في JSON. | راجع مفاتيح السمات التي تبدأ بـ @_ وقيم #text، واختبر الناتج في النظام المستهدف. احتفظ بالمستند الأصلي. |
| يُرفض الإدخال الكبير أو المتداخل بعمق. | يتجاوز الإدخال حد 5 ميغابايت أو حدود التداخل وتوسيع الكيانات في المحلل. | قلّل حجم المستند أو عمق العناصر، وتجنب تعريفات الكيانات المتكررة بصورة مفرطة. |
حدود التحويل والتحقق
التحقق هنا يخص البنية، وليس التحقق باستخدام XSD. يسمح المحلل بسمات منطقية دون قيمة كامتداد، لذلك لا يعني قبول الإدخال مطابقته الصارمة لكل قواعد XML. قد تتغير التعليقات والنصوص المختلطة والسمات والقيم العددية عند التحويل إلى JSON؛ ولا تضمن الأداة تحويلًا عكسيًا دون فقد. تصغير المسافات قد يؤثر في النص المختلط، لذا راجع الناتج واحتفظ بالمصدر.
المعايير ومراجع التنفيذ
- مواصفة XML 1.0 من W3C (opens in a new tab)تحدد قواعد المستندات والعناصر والسمات والنصوص في XML.
- المستودع الرسمي لـ fast-xml-parser (opens in a new tab)يوثق محلل XML وخيارات التحقق وتمثيل السمات المستخدمة في الأداة.
تنسيق XML — FAQ
هل تُرفع مستندات XML إلى خادم؟
لا. يعمل المحلل ومنشئ XML داخل علامة التبويب الحالية. النسخ والتنزيل محليان أيضًا.
هل تتحقق الأداة من مخطط XSD؟
لا. تفحص الأداة البنية باستخدام المحلل، ولا تقارن المستند بمخطط XSD أو بقواعد التطبيق.
كيف تظهر السمات والنصوص في JSON؟
تبدأ مفاتيح السمات بـ @_ ويُستخدم #text لتمثيل النص عند الحاجة. راجع هذا التمثيل قبل استخدام الناتج في نظام آخر.
هل يحافظ التحويل العكسي على المستند تمامًا؟
ليس دائمًا. تختلف نماذج XML وJSON، وقد يتغير تمثيل العناصر المتكررة ومساحات الأسماء والتعليقات والقيم. احتفظ بالملف الأصلي عندما تحتاج إلى حفظه حرفيًا.
ما الذي تغيّر؟
أُضيفت تعليمات وأمثلة وأسئلة شائعة ورسائل تشغيل باللغة العربية، مع توضيح حدود البنية والتحويل بين XML وJSON واتجاه عرض الشيفرة.