تحويل XML إلى JSON Extensible Markup Language ↔ JavaScript Object Notation مجاناً عبر الإنترنت آمن
أفلِت ملف XML وخذ JSON. القراءة والكتابة تجريان هنا، داخل متصفحك، فلا يغادر الملف جهازك — وما يُبقيه العبور وما لا يستطيع مكتوبان أدناه، لا متروكان لتكتشفهما بنفسك.
حوِّل ملفك
أفلِت هنا ملف XML، أو اختر واحداً.
ملفك لا يغادر هذا الجهاز. كل شيء يعمل داخل متصفحك.
لا رفع لأي ملف
التحويل من XML
التحويل إلى XML
من أين جاءت هذه الصيغ
صيغةُ CSV أقدمها وأقلّها تقييساً: جدولٌ مكتوبٌ سطوراً من نص، استُعمل منذ السبعينيات ولم يُوصَف كتابةً إلا سنة 2005، وقد كان كل برنامجٍ قد قرّر لنفسه ما الفاصل ومتى تُوضَع علامات الاقتباس. وخرج XML من SGML سنة 1998، للمستندات التي يجب أن تحمل بنيةً صارمة وأن تُراجَع على مخطّط. وانتزع دوغلاس كروكفورد صيغةَ JSON من جافاسكربت نحو سنة 2001، وقد جُرِّدت عمداً إلى كائناتٍ وقوائمَ وأعدادٍ وسلاسلِ حروف — وهذا التجريد هو سبب استيلائها على الوِب. وYAML ابنُ عمها المقروء، حيث تقوم الإزاحةُ بما تقوم به الأقواس في غيرها. والذي يهم في التحويل بينها شيءٌ واحد: CSV مسطحة، شبكةٌ من صفوفٍ وأعمدة، أما JSON وXML وYAML فأشجار.
أين تصادفها
صيغة CSV هي ما يُصدّره جدول الحساب، وما يناولك إياه محاسبٌ أو منصةُ متجرٍ أو كشفُ حساب. وJSON هي ما تتكلم به خدماتُ الوِب، وبها تُكتَب ملفاتُ الإعداد أكثر فأكثر. وXML تعيش في أنظمة المؤسسات الأقدم، وفي معايير الفوترة، وفي داخل صيغ المكاتب نفسها. وYAML حيث يكتب البشرُ الإعداداتِ بأيديهم. والتحويلُ بينها هو عملُ كل يوم: نقلُ البيانات من حيث نشأت إلى حيث تُطلَب.
أسئلة متكررة
فُتح ملف CSV عندي في إكسل عموداً واحداً. لماذا؟
لأن جدول الحساب كان ينتظر فاصلاً آخر. فإكسل يتبع فاصلَ القوائم في إعدادات المنطقة، وهو الفاصلةُ المنقوطة في كل موضعٍ تكون فيه الفاصلةُ علامةً عشرية أصلاً — أي في معظم أوروبا القارية. فيبدو الملفُّ المفصولُ بالفواصل عمودَ نصٍّ واحداً. استعمل نافذة الاستيراد وصرِّح بالفاصل، بدل أن تفتح الملف بنقرتين. وبالإعداد الإقليمي نفسه يُفسَّر وصولُ 3.5 أحياناً على هيئة تاريخ.
لماذا لا يصير ملف JSON المتداخل عندي جدولاً مرتباً؟
لأن جدول الحساب مسطح وJSON شجرة. فالصفُّ يحمل قيمةً واحدة لكل عمود؛ وكائنُ JSON قد يحمل قائمةً داخل حقلٍ داخل قائمةٍ أخرى. والتحويل يعني اختيارَ كيفية تسطيح ذلك: إما وصلُ الأسماء المتداخلة في عنوان عمودٍ واحدٍ طويل، وإما تكرارُ الصف الأب مرةً لكل ابن. وكلاهما تنازل، ولا يمكن نقضُ أيٍّ منهما تلقائياً — ولهذا يحتاج الرجوعُ من الجدول إلى الشكل الأصلي قراراً بشرياً في الغالب.
أيفقد الملف شيئاً من جودته؟
ذلك بحسب ما يسع الصيغتين أن تحملاه. فالتحويل بين صيغتين تحفظان الشيء نفسه — من PNG إلى BMP، ومن WAV إلى FLAC — لا يفقد شيئاً. أما التحويل إلى صيغةٍ تطرح المعلومات توفيراً للمساحة، كـJPEG أو MP3، فيفقد قليلاً في كل مرة، والعودة لا تردّ ما ذهب. وحيث يوجد خيار، تميل هذه الصفحة إلى حفظ الجودة الأصلية لا إلى إخراج أصغر ملف.
هل يُرفَع ملفي إلى مكانٍ ما؟
لا. يجري التحويل داخل متصفحك، على جهازك أنت؛ فالملف لا يغادره قط، وليس هنا خادمٌ أصلاً يستقبله. ولهذا كان الذي يحدّ الملفَّ الكبير ذاكرتَك أنت لا عمليةَ رفع، ولهذا لا يمكن لشيءٍ تحوّله أن يظهر في سجلات أحد — ولا في سجلاتنا. أما أدوات الصوت والصورة فتجلب محرّك التحويل من هذا الموقع في أول استعمال — نحو ثلاثين ميغابايت، مرةً واحدة؛ وبعدها يبقى العمل كلّه على جهازك.
لماذا يحوّل الناس XML إلى JSON
XML هو الشيخ الوقور بين البيانات المهيكلة. فعلى مدى أكثر من عشرين سنة حمل ملفات الإعدادات وموجزات المنتجات والفواتير وخرائط المواقع وموجزات الأخبار وتصديرات برامج المحاسبة وأجوبة خدمات الويب الأقدم. وهو دقيق ومطوّل، مكتوب بوسوم تُفتح وتُغلق. أما JSON فمنافسه الأصغر سناً: أخف وأسهل قراءة، واللغة الطبيعية لشيفرة الويب الحديثة، حيث يستطيع برنامج استخدامه دون إعداد يُذكر. وحين يصل موجز أو تصدير بصيغة XML وكان ما سيستخدمه يتحدث JSON، يلزم تحويل. ولهذا يحوّل الناس XML إلى JSON: بياناتهم بالصيغة الأقدم، والأدوات الجديدة تريد الأحدث.
الحالات شائعة. مطور عليه أن يقرأ جواب خدمة أقدم في سكربت حديث. وصاحب متجر لديه موجز منتجات بصيغة XML ومنصة تستورد JSON. ومحلل بيانات يريد أن ينظر في تصدير كبير بأداة تتعامل مع JSON. وطالب يحتاج إلى فهم ملف مليء بالأقواس المعقوفة. وفي كل حالة تكون المعلومات موجودة، وما ينقص هو شكل أنسب فقط.
تحوّل هذه الصفحة XML إلى JSON في متصفحك. يُقرأ ملفك ويُكتب هنا، ولذلك لا يغادر جهازك أبداً، وهذا مهم للفواتير وبيانات العملاء وكل ما هو خاص. وتخبرك الصفحة مقدماً بما يحفظه العبور وما لا يستطيع، بدل أن تتركك لتكتشفه. ويحمل XML فكرة ليس لدى JSON كلمة لها، وفهمها يوفر عليك المفاجآت. وتجد أدناه كيف يعمل التحويل وما تتوقعه.
كيف يعمل التحويل
العناصر تصبح مفاتيح، والتداخل يصبح تداخلاً
يُقرأ XML لديك داخل متصفحك. وتصبح أسماء العناصر مفاتيح، وتصبح العناصر داخل العناصر كائنات داخل كائنات، ولذلك فتداخل XML هو تداخل JSON. والبنية التي تراها في الوسوم هي البنية التي تحصل عليها بين الأقواس.
تحتفظ السمات باسمها مع @
يمكن أن تحمل عناصر XML سمات، قطعاً صغيرة من البيانات تُكتب داخل الوسم الافتتاحي. وليس في JSON سمات، ولذلك تُحفظ كل منها كمفتاح قائم بذاته، مع @ أمام الاسم. فعنصر مثل كتاب بسمة id يعطي مفتاحاً @id بجانب مفاتيح أبنائه. وتوضح @ أي المفاتيح جاءت من سمات وأيها من عناصر.
نص بجانب عناصر أبناء
يُحفظ النص الذي يشارك عنصراً مع عناصر أبناء تحت #text، لأنه ليس هناك مكان آخر لوضعه. وهذا نادر في ملفات البيانات وشائع في المستندات التي تمزج النثر بالوسوم. ويحمل المفتاح #text النص، وتحمل المفاتيح الأخرى الأبناء.
ما يُحفظ
أسماء العناصر والتداخل والسمات والنص
تُحفظ أسماء العناصر وتداخلها وسماتها ونصها كلها. والمعلومات في البيانات موجودة في JSON، بشكل تستطيع البرامج السير عبره.
ترتيب ما يظهر مرة واحدة
تحتفظ العناصر بالترتيب الذي كُتبت به حين تكون مختلفة، ولذلك فسجل يسرد عنواناً ومؤلفاً وتاريخاً يعرضها بذلك الترتيب.
النص تماماً
يُحفظ نص كل عنصر كما كُتب، بما فيه الفراغات داخله والحروف المشكولة والرموز والأحرف من أبجديات أخرى.
ما ينبغي أن تعرفه قبل أن تحوّل XML إلى JSON
الأسماء المكررة تصبح مصفوفة
يحمل XML فكرة ليس لدى JSON كلمة لها: العناصر مرتبة وقد تتكرر. فالاسم الذي يظهر مرة واحدة يصبح قيمة، والاسم الذي يظهر مرتين يصبح مصفوفة. فقائمة بثلاثة عناصر item تصبح مصفوفة من ثلاثة، لكن قائمة بعنصر واحد تصبح قيمة فقط، لا مصفوفة من واحد. وهذا يعني أن قراءة النتيجة ثانية لا تعطي دائماً XML نفسه. وينبغي للبرنامج الذي يقرأ JSON أن يكون مستعداً للشكلين حيث قد تكون القائمة قصيرة.
التعليقات وتعليمات المعالجة والإعلان تُسقط
التعليقات وتعليمات المعالجة وإعلان XML ليست جزءاً من البيانات ولا تنتقل. فالملاحظة التي تركها مطور في تعليق، والسطر في الأعلى الذي يحدد الإصدار والترميز، والتعليمات المخصصة لبرنامج معين، تختفي. أما البيانات نفسها فتبقى.
كل شيء نص
لا أنواع في XML: كل قيمة في الوسوم نص. والأرقام والتواريخ والرايات في XML لديك تصل كالنص الذي كُتب. وينبغي للبرنامج الذي يقرأ JSON أن يفسرها بحسب حاجته.
كيف تحوّل XML إلى JSON هنا
أضف ملفك
أسقط ملف XML على الصفحة أو اخترْه من جهازك. يُقرأ داخل متصفحك ولا يُرفع.
حوّل
اضغط الزر. يستغرق ملف بحجم عادي لحظة. اترك الصفحة مفتوحة حتى ينتهي.
نزّل وافحص
نزّل ملف JSON وافتحه في محرر نصوص. انظر إلى البداية والنهاية، وتحقق من أن المفاتيح هي الأسماء التي تتوقعها وأن السمات تحمل @ الخاصة بها.
نظرة أقرب إلى XML وJSON
طريقتان لكتابة شجرة
يصف XML وJSON كلاهما شجرة من القيم. ويكتبها XML بوسوم تُفتح وتُغلق، ويسمح بالسمات والمحتوى المختلط. ويكتبها JSON بأقواس معقوفة ومربعة، ولا يعرف إلا الكائنات والقوائم والسلاسل والأرقام والقيم المنطقية وnull. وهما يتداخلان جيداً للبيانات، مثل السجلات والإعدادات، ويتداخلان بشكل سيئ للمستندات، مثل صفحة ويب أو كتاب، حيث يتخلل النص والوسوم بعضهما.
لماذا الرحلة ذهاباً وإياباً غير مضمونة
ينقص الانتقال من XML إلى JSON قليلاً: ترتيب العناصر المختلطة المتكررة، والتعليقات، والتمييز بين السمة والعنصر، الذي يُحفظ فقط عبر @. وعند العودة قد لا تحصل إذن على XML نفسه تماماً. ولتبادل البيانات نادراً ما يهم ذلك. أما للمستندات فيهم، ومن الأفضل إبقاء XML أصلاً.
فضاءات الأسماء
يمكن لأسماء XML أن تحمل بادئة تضعها في فضاء أسماء، مثل مفردات معيار معين. وتُحفظ هذه الأسماء كما كُتبت، بالبادئة، فقد يقرأ المفتاح dc:title. ولا تُحلّ ولا تُعاد كتابتها.
حالات شائعة بالتفصيل
موجزات المنتجات والكتالوجات
غالباً ما يقدم الموردون والأسواق موجزات بصيغة XML. ولاستخدامها في سكربت حديث أو لاستيرادها إلى منصة تأخذ JSON، حوّل XML إلى JSON واقرأ النتيجة.
خدمات الويب الأقدم
الخدمات المبنية في عصر SOAP والواجهات البرمجية المبكرة تجيب بصيغة XML. ويستطيع سكربت يريد استخدام جوابها أن يعمل مع JSON، الأسهل تعاملاً.
ملفات الإعدادات والتفضيلات
تخزن برامج كثيرة الإعدادات بصيغة XML. وتحويل ملف إلى JSON يتيح لك قراءته في أداة مبنية لـ JSON، ومقارنة نسختين أو تغذيته إلى سكربت.
الموجزات وخرائط المواقع والتصديرات
موجزات الأخبار وخرائط المواقع وتصديرات برامج المحاسبة أو المخزون هي XML. والتحويل يعطيك شكلاً أسهل بحثاً وتحميلاً في الشيفرة.
نصائح عملية قبل أن تحوّل XML إلى JSON
تحقق من أن XML سليم التكوين
يجب أن يُغلق كل وسم، وأن يكون للملف عنصر جذر واحد. فإن أبلغت الصفحة عن خطأ فافتح الملف في محرر يبرز مشكلات XML وأصلح السطر الذي يشير إليه.
اعرف أين قد تكون القوائم قصيرة
إن كان في XML قوائم فتذكر أن قائمة بمدخل واحد ستصبح قيمة لا مصفوفة من واحد. خطط للشيفرة التي تقرأ JSON لتتعامل مع الحالتين.
قرر ماذا تفعل بالسمات
تصل السمات كمفاتيح مع @. فإن كان برنامجك يتوقعها بأسماء أخرى فأعد تسميتها بعد التحويل، أو عدّل البرنامج.
الملفات الكبيرة
كل شيء يعمل على جهازك، ولذلك يحتاج ملف كبير جداً إلى ذاكرة. ولملفات من عدة ميغابايتات استخدم حاسوباً، وقسّم البيانات إن تعثرت الصفحة.
أسئلة يطرحها الناس قبل التحويل
لماذا قائمة واحدة مصفوفة وأخرى قيمة مفردة؟
لأن الاسم الذي يظهر مرة واحدة يصبح قيمة، والاسم الذي يظهر مرتين يصبح مصفوفة. وقائمة بمدخل واحد تبدو كقيمة مفردة.
أين ذهبت سماتي؟
إنها مفاتيح مع @ أمام الاسم، بجانب مفاتيح العناصر الأبناء.
أين النص الذي يجلس بجانب عناصر أخرى؟
تحت المفتاح #text، لأنه ليس هناك مكان آخر لوضعه.
لماذا اختفت تعليقاتي؟
التعليقات وتعليمات المعالجة وإعلان XML ليست جزءاً من البيانات ولا تنتقل.
هل يُرفع ملفي؟
لا. يعمل التحويل في متصفحك ولا يغادر الملف جهازك.
هل أستطيع العودة إلى XML؟
نعم. من JSON إلى XML يكتب الشجرة من جديد بصيغة XML، مع أن الرحلة ذهاباً وإياباً ليست مضمونة التطابق.
الاختيار الحكيم حين تحوّل XML إلى JSON
JSON أم YAML أم جدول؟
يناسب JSON البرامج. ولإعداد يحرره الناس، فإن من JSON إلى YAML يُقرأ براحة أكبر بعد التحويل. وإن كان XML في حقيقته جدول سجلات منتظمة، فيمكنك المتابعة بـ من JSON إلى CSV أو من JSON إلى XLSX.
احتفظ بـ XML
XML هو الأصل. فيه التعليقات والإعلان والترتيب الدقيق. احتفظ به، وعامل JSON على أنه نسخة مريحة.
فكر في المستهلك
انظر إلى ما سيقرأ JSON، وشكّل العمل ليناسبه. وسكربت يتوقع بنية ثابتة أسهل كتابةً إن كان XML منتظماً.
الحصول على نتيجة جيدة بعد التحويل
تحقق من JSON في عارض
افتح النتيجة في محرر يفهم JSON واطوِ الكائنات. فإن بدت البنية كما تتوقع فهي سليمة.
قارن بعض السجلات بالمصدر
خذ بضعة سجلات من الوسط وقارنها بـ XML. يستغرق ذلك دقيقة ويخبرك أن التحويل أمين.
صغّر للنشر
إن كان الملف سيُحمَّل في صفحة ويب وكان كبيراً، فتوجد أدوات تزيل الفراغات وتجعله أخف. وتبقى البيانات هي نفسها.
تجهيز XML ليتحول جيداً
أبقِ البنية منتظمة
حين تحوّل XML إلى JSON، تتحول البيانات المنتظمة أفضل: العناصر نفسها في الأماكن نفسها، مع قوائم تُكتب دائماً كعناصر مكررة. والملفات غير المنتظمة تنتج JSON غير منتظم، وعلى البرنامج الذي يقرؤه أن يتعامل معه.
تجنب مزج النص والعناصر حيث تستطيع
يذهب النص بجانب العناصر الأبناء تحت #text. وهذا صحيح، لكنه يجعل النتيجة أصعب استخداماً. وللبيانات أبقِ النص في الأوراق، لا بين الأغصان.
جرّب بقطعة صغيرة أولاً
إن كان ملفك كبيراً فخذ السجلات الأولى إلى ملف اختبار وحوّله. ونظرة سريعة إلى النتيجة تبين هل الشكل كما تتوقع.
قراءة JSON بعد أن تحوّل XML إلى JSON
سِر في البنية، ولا تخمنها
يعكس شكل النتيجة شكل XML، ولذلك فأفضل طريقة لفهمها أن تفتح الاثنين جنباً إلى جنب. اعثر على عنصر الجذر، الذي يصبح المفتاح الأعلى، وتتبع سجلاً واحداً نزولاً إلى أوراقه. وبعد أن تحوّل XML إلى JSON توفر هذه الجولة من عشر دقائق ساعات من التجربة والخطأ في الشيفرة.
اكتب شيفرة دفاعية للقوائم
لأن المدخل الواحد قيمة والمداخل المتعددة مصفوفة، فإن أأمن عادة أن تغلّف ما تقرأ: إن لم يكن مصفوفة فضعه في واحدة. وسطر واحد من الشيفرة في بداية القارئ يبسّط الباقي، ولا ينكسر برنامجك في اليوم الذي يحتوي فيه موجز على منتج واحد فقط.
تعامل مع السمات بعناية
المفاتيح التي تبدأ بـ @ هي سمات. وبعض الأدوات لا تحب هذه الأسماء كأسماء خصائص، ولذلك قد تفضل إعادة تسميتها أثناء التحميل. ويبقى المعنى نفسه؛ وتتغير التسمية فقط.
لا تحرر JSON بديلاً عن المصدر
حين تتغير البيانات، غيّر XML عند مصدره، أو دع النظام ينتج تصديراً جديداً، وحوّل XML إلى JSON من جديد. وتحرير النسخة يترك الاثنين خارج التزامن.
الخصوصية والتعامل
لماذا يهم التحويل المحلي للبيانات
غالباً ما تحمل ملفات XML ما هو خاص: فواتير وعملاء وطلبات وإعدادات. وكثير من المحولات عبر الإنترنت ترفع ملفك إلى خادم، وتعالجه وترد النتيجة، ولبعض الوقت تعيش نسخة على جهاز لا تتحكم فيه. أما هنا فمتصفحك أنت يقوم بالعمل، ولذلك تبقى البيانات على جهازك.
ماذا يحدث حين تغادر
حين تغلق الصفحة يختفي الملف المحوَّل من المتصفح، فنزّله أولاً. ولا يُحتفظ بشيء عن بياناتك.
إن حدث خطأ ما
تقول الصفحة إن XML غير صالح
قد لا يُغلق وسم، أو قد يوجد عنصرا جذر، أو حرف لا يسمح به XML. افتح الملف في محرر يبرز أخطاء XML وأصلح السطر الذي يشير إليه.
البنية ليست ما توقعته
تحقق من القوائم التي فيها مدخل واحد، ومن السمات والنص المختلط. فهي تفسر معظم المفاجآت.
تتجمد الصفحة مع ملف كبير
كل شيء يعمل على جهازك، والملف الكبير يحتاج إلى ذاكرة. جرّب من جديد على حاسوب، أو قسّم البيانات.
أدوات ذات صلة
تغطي عائلة الأدوات نفسها المهام المجاورة. وللعودة استخدم من JSON إلى XML. ولملفات الإعدادات تحوّل من JSON إلى YAML ومن YAML إلى JSON بين هذين. وللجداول هناك من JSON إلى CSV ومن CSV إلى JSON ومن JSON إلى XLSX ومن XLSX إلى JSON.
مثال محلول
لنفترض أن مورداً يرسل إليك موجز منتجات بصيغة ملف XML فيه 800 منتج، لكل منها سمة id واسم وسعر وقائمة فئات. تسقط الملف هنا وتضغط الزر. وبعد لحظة تنزّل JSON فيه مصفوفة من 800 منتج. ومعرّف كل منها مفتاح @id، والاسم والسعر مفتاحان قائمان بذاتهما، وتشكل الفئات مصفوفة. وللمنتجات القليلة ذات الفئة الواحدة تكون القيمة سلسلة بسيطة، ويتعامل سكربت الاستيراد لديك مع الحالتين. ويبقى XML في مجلدك أصلَ المورد.
قائمة مراجعة قصيرة
قبل التحويل
تحقق من أن XML سليم التكوين. دوّن أين قد تكون القوائم قصيرة. احتفظ بـ XML.
أثناء التحويل
ابقَ في الصفحة حتى يجهز الملف.
بعد التحويل
افتح JSON، وتحقق من المفاتيح والسمات والقوائم، واختبره بالبرنامج الذي سيقرؤه.
أخطاء شائعة
افتراض أن كل قائمة مصفوفة
القائمة بمدخل واحد تصبح قيمة. اكتب شيفرة القراءة لتقبل الاثنين.
توقع رحلة ذهاب وإياب كاملة
لا تعتمد على أن الانتقال من XML إلى JSON والعودة يعطي XML نفسه. احتفظ بالأصل.
نسيان أن كل القيم نصوص
لا أنواع في XML. حوّل الأرقام والتواريخ في البرنامج الذي يستخدمها.
بياناتك تبقى على جهازك
يجري التحويل محلياً. يقرأ متصفحك أنت ملفك، ويعيد كتابته هناك ويسلمه إليك بصيغة JSON. ولا شيء يُرفع، فلا تنتهي نسخة على خادم ولا يستطيع أحد آخر أن يقرأها. وللبيانات ذات المحتوى الخاص هذه هي الطريقة الآمنة لتحويل XML إلى JSON.
الخلاصة
لتحويل XML إلى JSON هنا، أسقط الملف واضغط الزر. يُقرأ ويُكتب في متصفحك، ولذلك لا يغادر الملف جهازك أبداً. وتُحفظ أسماء العناصر وتداخلها وسماتها ونصها. وتحتفظ السمة باسمها مع @ أمامه، ويُحفظ النص الذي يشارك عنصراً مع عناصر أبناء تحت #text، لأنه ليس هناك مكان آخر لوضعه. ويحمل XML فكرة ليس لدى JSON كلمة لها: العناصر مرتبة وقد تتكرر. والاسم الذي يظهر مرة واحدة يصبح قيمة والاسم الذي يظهر مرتين يصبح مصفوفة، ولذلك فقراءة النتيجة ثانية لا تعطي دائماً XML نفسه. والتعليقات وتعليمات المعالجة وإعلان XML ليست جزءاً من البيانات ولا تنتقل.