تحويل JSON إلى XML JavaScript Object Notation ↔ Extensible Markup Language مجاناً عبر الإنترنت آمن
أفلِت ملف JSON وخذ XML. القراءة والكتابة تجريان هنا، داخل متصفحك، فلا يغادر الملف جهازك — وما يُبقيه العبور وما لا يستطيع مكتوبان أدناه، لا متروكان لتكتشفهما بنفسك.
حوِّل ملفك
أفلِت هنا ملف JSON، أو اختر واحداً.
ملفك لا يغادر هذا الجهاز. كل شيء يعمل داخل متصفحك.
لا رفع لأي ملف
التحويل من JSON
التحويل إلى JSON
من أين جاءت هذه الصيغ
صيغةُ 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، فيفقد قليلاً في كل مرة، والعودة لا تردّ ما ذهب. وحيث يوجد خيار، تميل هذه الصفحة إلى حفظ الجودة الأصلية لا إلى إخراج أصغر ملف.
هل يُرفَع ملفي إلى مكانٍ ما؟
لا. يجري التحويل داخل متصفحك، على جهازك أنت؛ فالملف لا يغادره قط، وليس هنا خادمٌ أصلاً يستقبله. ولهذا كان الذي يحدّ الملفَّ الكبير ذاكرتَك أنت لا عمليةَ رفع، ولهذا لا يمكن لشيءٍ تحوّله أن يظهر في سجلات أحد — ولا في سجلاتنا. أما أدوات الصوت والصورة فتجلب محرّك التحويل من هذا الموقع في أول استعمال — نحو ثلاثين ميغابايت، مرةً واحدة؛ وبعدها يبقى العمل كلّه على جهازك.
لماذا يحوّل الناس JSON إلى XML
JSON هي لغة شيفرة الويب الحديثة: خفيفة ومقروءة وتفهمها كل لغات البرمجة. وXML هي الشقيقة الأقدم والأكثر رسمية، تُكتب بوسوم تُفتح وتُغلق، وما زالت الصيغة المطلوبة في عدد مدهش من الأماكن. فبرامج المحاسبة وأنظمة الضرائب والجمارك ومنصات المشتريات العامة وخلاصات المنتجات وسير عمل النشر وبرمجيات المؤسسات وقائمة طويلة من خدمات الويب الأقدم كلها تتوقع XML. وحين تكون بياناتك بصيغة JSON والنظام الذي يجب أن يتلقاها يتكلم XML فلا بد من تحويل. ولهذا يحوّل الناس JSON إلى XML: عندهم المعلومات بشكل ووجهتهم تطلب الآخر.
والمواقف شائعة. مطوّر عليه أن يرسل بيانات من تطبيق حديث إلى خدمة بُنيت قبل سنوات. ومتجر يصدّر المنتجات بصيغة JSON وعليه أن يسلّم خلاصة إلى سوق تريد XML. وفريق يحتاج إلى إعداد بشكل الترميز الذي تفضله أداة. وطالب يريد أن يرى كيف تبدو البيانات نفسها بالصيغتين. وفي كل حالة يكون المحتوى جاهزاً، والمختلف هو الصيغة فقط.
تحوّل هذه الصفحة JSON إلى XML داخل متصفحك. يُقرأ ملفك ويُكتب هنا، فلا يغادر جهازك، وهذا مهم للطلبات والفواتير وكل ما هو خاص. وتخبرك الصفحة مقدماً بما يبقيه العبور وما لا يستطيعه، بدلاً من تركك لتكتشفه. وستجد أدناه كيف يعمل التحويل، وكيف تُعامل الأسماء والقوائم والسمات، وماذا تفعل بمفاتيح لا يقبلها XML.
كيف يعمل التحويل
الشجرة كلها تُنقل
يُقرأ ملف JSON داخل متصفحك، وتُكتب الشجرة كلها XML. تصير الكائنات عناصر، وتصير مفاتيحها أسماء العناصر الأبناء، وتصير القيم النص في داخلها. والتداخل في JSON تداخل في XML، فالشكل الذي تراه بأقواس معقوفة هو الشكل الذي تحصل عليه بوسوم.
يُسمى المستند باسم المفتاح الوحيد
يحتاج مستند XML إلى عنصر جذر واحد بالضبط. فإن كان لكائن JSON مفتاح واحد فهذا المفتاح يسمي المستند. وهذه هي الحالة المريحة: ملف XML حُوّل إلى JSON وأُعيد يشبه نفسه، لأن عنصر الجذر يصير المفتاح الوحيد ويعود عنصر جذر. وإن كان في JSON عدة مفاتيح في الأعلى لفّها المحوّل في عنصر جذر حتى تكون النتيجة سليمة التكوين.
القوائم تكرر العنصر
تكرر المصفوفة عنصرها. فمفتاح products يحمل قائمة من ثلاثة سجلات يعطي ثلاثة عناصر product واحداً بعد الآخر، وهذه هي الطريقة التي يعبّر بها XML عن قائمة. ويُحفظ الترتيب.
ما الذي يُحتفظ به
الشجرة كلها
يُنقل كل كائن وكل قائمة وكل قيمة. لا شيء يُسقط، والتداخل هو تداخل الأصل.
السمات، عبر @
المفتاح الذي يبدأ بـ@ يصير سمة. فسجل بمفتاح @id ومفتاح name يعطي عنصراً بسمة id وعنصراً ابناً name. وهذه هي الاصطلاحية نفسها التي يستعملها التحويل المعاكس، فملف XML حُوّل إلى JSON وأُعيد يحتفظ بسماته.
الترتيب
تحتفظ المفاتيح بالترتيب الذي ظهرت به في JSON، فتتبع العناصر في XML تسلسل المصدر.
ما ينبغي أن تعرفه قبل تحويل JSON إلى XML
أي مفتاح JSON يمكن أن يكون كلمة؛ واسم XML لا يمكن
أي مفتاح JSON يمكن أن يكون كلمة أو رقماً أو عبارة فيها مسافات. أما اسم عنصر XML فلا يمكن: يجب أن يبدأ بحرف أو شرطة سفلية وقد يحوي حروفاً وأرقاماً وواصلات وشرطات سفلية ونقاطاً، لكن بلا مسافات. والمفتاح الذي ليس اسماً صالحاً لا يُشوَّه ليصير واحداً. بل يصير عنصر item بسمة name، يُكتب item name="المفتاح الأصلي"، فيبقى الأصل في الملف وما زال يمكن العثور عليه. ولا شيء يُعاد تسميته بصمت.
لا شيء بنطاق أسماء، ولا شيء له مخطط
لا شيء يُعطى نطاق أسماء، ولا شيء يُعطى مخططاً. والنتيجة سليمة التكوين، لا مُتحقَّق منها. وسيقرؤها أي قارئ XML، لكن هل تستوفي البنية المعينة التي يتطلبها نظام ضرائب أو سوق فسؤال منفصل لا يجيب عنه إلا الطرف المتلقي. وإن طلب مخطط أسماء عناصر معينة فعليك أن تجعل مفاتيح JSON تطابقها مسبقاً.
القيم نصوص
XML بلا أنواع: فكل قيمة في الوسوم نص. وتُكتب الأرقام وtrue وfalse وnull نصوصها. وعلى البرنامج الذي يقرأ XML أن يفسرها كما يرى.
كيف تحوّل JSON إلى XML هنا
أضف ملفك
أسقط ملف JSON على الصفحة أو اخترها من جهازك. يُقرأ داخل متصفحك ولا يُرفع.
حوّل
اضغط الزر. يستغرق ملف بحجم عادي لحظة. أبقِ الصفحة مفتوحة حتى ينتهي.
نزّل وافحص
نزّل XML وافتحه في محرر نصوص أو متصفح. انظر إلى البداية والنهاية، وتأكد من أن أسماء العناصر هي ما تتوقع وأن السمات تظهر حيث قصدت.
نظرة أقرب إلى JSON وXML
طريقتان لكتابة شجرة
كل من JSON وXML تصف شجرة من القيم. فتكتبها JSON بأقواس معقوفة ومربعة، ولا تعرف إلا الكائنات والقوائم والسلاسل النصية والأرقام والقيم المنطقية وnull. وتكتبها XML بوسوم تُفتح وتُغلق، وتضيف السمات ونطاقات الأسماء والمحتوى المختلط. وتتداخلان جيداً للبيانات، مثل السجلات والإعدادات، وتتداخلان بشكل سيئ للمستندات، حيث يتشابك النص والترميز.
لماذا تهم الاصطلاحات
ليس في JSON سمات ولا عنصر جذر ولا مفهوم لتكرار عنصر. فأي تحويل يحتاج إلى اصطلاحات: الـ@ للسمات، والمفتاح الوحيد للجذر، وتكرار العناصر للقوائم. والاصطلاحات المستعملة هنا بسيطة ومتسقة، وتطابق المستعملة عند الانتقال من XML إلى JSON، وهذا ما يتيح لرحلة الذهاب والعودة أن تنجح في الحالات الشائعة.
القيم الفارغة
السلسلة الفارغة وnull كلتاهما تنتهيان عنصراً فارغاً. وإن كان الفرق يهم النظام المتلقي فميّزه في البيانات قبل أن تحوّل JSON إلى XML، مثلاً بعلامة منفصلة.
حالات شائعة بالتفصيل
خلاصات للأسواق ومواقع المقارنة
تطلب منصات كثيرة خلاصات منتجات بصيغة XML. فإن كان برنامج متجرك يصدّر JSON فحوّل JSON إلى XML وافحص أسماء العناصر مقابل مواصفات المنصة وارفع.
الخدمات الأقدم وأنظمة المؤسسات
الأنظمة المبنية في عصر SOAP وواجهات البرمجة المبكرة تتوقع XML. ويستطيع تطبيق حديث أن ينتج JSON وأن يُحوَّل لها.
إعدادات لأدوات تفضل XML
بعض أدوات البناء وأنظمة المحتوى وبرامج سطح المكتب تقرأ إعداداتها من XML. وإعداد مكتوب بصيغة JSON يمكن تحويله إلى الشكل الذي تحتاج إليه.
التعلم والمقارنة
رؤية البيانات نفسها بالصيغتين طريقة جيدة لفهم كيف تختلفان. الصق JSON صغيراً وحوّله وقارن الاثنين جنباً إلى جنب.
نصائح عملية قبل تحويل JSON إلى XML
تأكد من صلاحية JSON
فاصلة شاردة أو علامة اقتباس ناقصة ستوقف التحويل. فإن أبلغت الصفحة عن خطأ فافتح الملف في محرر يبرز مشكلات JSON وأصلح السطر الذي يشير إليه.
اجعل المفاتيح أسماء عناصر صالحة
إن كنت تعرف أن XML سيُفحص مقابل مخطط فاستعمل مفاتيح هي أسماء صالحة وتطابق المخطط. وإلا فسيحفظها المحوّل آمنة عناصر item، وهذا صحيح لكنه قد لا يكون ما يتوقعه المتلقي.
اختر مفتاحاً واحداً في المستوى الأعلى
إن أردت أن يكون لعنصر الجذر في XML اسم معين فلفّ بياناتك في كائن بذلك المفتاح الوحيد قبل أن تحوّل JSON إلى XML.
الملفات الكبيرة
كل شيء يعمل على جهازك، فالملف الكبير جداً يحتاج إلى ذاكرة. ولملفات من عدة ميغابايتات استعمل حاسوباً، وقسّم البيانات إن عانت الصفحة.
أسئلة يطرحها الناس قبل التحويل
ما الذي يسمي عنصر الجذر؟
كائن بمفتاح واحد يسمي المستند باسم ذلك المفتاح.
كيف أحصل على سمة؟
ابدأ المفتاح بـ@. فيصير سمة للعنصر.
ماذا يحدث لمفتاح فيه مسافة؟
ليس اسم عنصر صالحاً، فيصير عنصر item بسمة name تحمل المفتاح الأصلي. ولا شيء يضيع.
هل سيجتاز XML فحص مخطط؟
النتيجة سليمة التكوين، لا مُتحقَّق منها. وهل تلبي مخططاً معيناً يتوقف على أسماء عناصرك وبنيتها.
هل يُرفع ملفي؟
لا. يعمل التحويل في متصفحك ولا يغادر الملف جهازك.
هل أستطيع العودة إلى JSON؟
نعم. XML إلى JSON يقرأ شجرة XML من جديد، بالاصطلاحات نفسها للسمات.
الاختيار الحكيم حين تحوّل JSON إلى XML
هل XML مطلوب فعلاً؟
إن كان النظام المتلقي يقبل JSON فاستعمل JSON. حوّل فقط حين يكون XML مطلوباً.
أهداف أخرى
لإعدادات يحررها الناس فإن JSON إلى YAML أريح في القراءة. وللجداول فإن JSON إلى CSV وJSON إلى XLSX يخدمان جداول البيانات.
احتفظ بـJSON
JSON هو الأصل. فهو يحمل الأنواع. احتفظ به، وعامل XML على أنه نسخة صُنعت لمتلقٍّ بعينه.
الحصول على نتيجة جيدة بعد التحويل
افتحه في متصفح
يعرض المتصفح XML شجرة قابلة للطي. افتح الملف ووسّع العناصر. فإن بدت البنية كما تتوقع فهي سليمة.
قارن بضعة سجلات بالمصدر
خذ بضعة سجلات في المنتصف وافحصها مقابل JSON. يستغرق دقيقة ويخبرك أن التحويل أمين.
أضف ما يحتاج إليه المتلقي
إن طلب المتلقي سطر إعلان أو نطاق أسماء أو إشارة إلى ورقة أنماط فأضفها في محرر نصوص. فهي ليست جزءاً من البيانات ولا تُكتب لك.
تجهيز JSON ليتحول جيداً
استعمل بنى منتظمة
حين تحوّل JSON إلى XML تتحول البيانات المنتظمة خير تحول: قوائم سجلات تشترك في المفاتيح نفسها، كل مفتاح اسم صالح. والبيانات غير المنتظمة تعطي نتيجة صحيحة لكن غير مرتبة.
قرر ما هو سمة
كثيراً ما تكون المعرّفات والرموز والعلامات سمات في XML. علّمها في JSON بـ@، وستبدو النتيجة مثل XML الذي يكتبه إنسان.
اختبر على قطعة صغيرة أولاً
إن كان ملفك كبيراً فخذ أول السجلات إلى ملف اختبار وحوّله. ونظرة سريعة إلى النتيجة تبيّن هل الشكل كما تتوقع.
جعل XML يناسب متلقيه
انظر إلى المواصفات أولاً
قبل أن تحوّل JSON إلى XML لسوق أو بوابة ضرائب أو شريك اقرأ ما يطلبونه. فأغلبهم ينشر وصفاً للعناصر التي يتوقعها وترتيبها وأيها مطلوب. ومواءمة أسماء مفاتيحك معه تكلّف بضع دقائق في JSON وتوفر رفعاً فاشلاً لاحقاً.
قد يهم الترتيب
تتطلب بعض مخططات XML العناصر بترتيب ثابت. ويحتفظ المحوّل بترتيب مفاتيحك، فإن أصر المتلقي على تسلسل فاكتب مفاتيح JSON بذلك التسلسل. وتتبع النتيجة تماماً ما كتبت.
أضف الإعلان إن كان مطلوباً
سطر في الأعلى يذكر الإصدار والترميز معتاد وبعض المتلقين يصر عليه. وهو ليس جزءاً من البيانات، فلا يُكتب لك. أضفه يدوياً في محرر نصوص، قبل العنصر الأول.
انتبه إلى المحارف الخاصة
تُكتب علامات العطف والأقواس الزاوية وعلامات الاقتباس داخل القيم بأشكالها المهرَّبة، فيبقى XML صالحاً أياً كان النص. ولا حاجة إلى تجهيزها في JSON.
احتفظ بعينة قُبلت
حين يقبل المتلقي ملفاً فاحتفظ بنسخة من ذلك الملف بالضبط ومن JSON الذي أنتجه. وحين يفشل رفع لاحق فإن مقارنته بالذي نجح تجد الفرق فوراً.
كرر التحويل بدلاً من التحرير اليدوي
حين تتغير البيانات غيّر JSON وحوّل JSON إلى XML من جديد. فتحرير XML يدوياً يترك نسختين تتباعدان.
الخصوصية والتعامل
لماذا يهم التحويل المحلي للبيانات
كثيراً ما تحوي ملفات البيانات ما هو خاص: عملاء وطلبات وفواتير وإعدادات. وكثير من المحوّلات عبر الإنترنت يرفع ملفك إلى خادم ويعالجه ويعيد النتيجة، ولبعض الوقت تعيش نسخة على جهاز لا تتحكم فيه. أما هنا فمتصفحك أنت يؤدي العمل، فتبقى البيانات على جهازك.
ماذا يحدث حين تغادر
حين تغلق الصفحة يختفي الملف المحوّل من المتصفح، فنزّله أولاً. ولا يُحتفظ بشيء من بياناتك.
إن حدث خطأ ما
تقول الصفحة إن الملف ليس JSON صالحاً
قد توجد فاصلة شاردة أو علامة اقتباس ناقصة أو قوس لا يُغلق. افتح الملف في محرر يبرز أخطاء JSON وأصلح السطر الذي يشير إليه.
يرفض المتلقي XML
النتيجة سليمة التكوين لكنها غير مُتحقَّق منها. قارنها بمواصفات المتلقي وعدّل أسماء المفاتيح وبنية JSON.
تتجمد الصفحة مع ملف كبير
كل شيء يعمل على جهازك، والملف الكبير يحتاج إلى ذاكرة. حاول مجدداً على حاسوب، أو قسّم البيانات.
أدوات ذات صلة
تغطي العائلة نفسها من الأدوات المهام المجاورة. وللعودة استعمل XML إلى JSON. ولملفات الإعدادات فإن JSON إلى YAML وYAML إلى JSON تحوّلان بين هاتين الصيغتين. وللجداول هناك JSON إلى CSV وCSV إلى JSON وJSON إلى XLSX وXLSX إلى JSON.
مثال محلول
لنفترض أن برنامج متجرك يصدّر 300 منتج بصيغة JSON، وأن سوقاً تطلب خلاصة XML بعنصر جذر اسمه catalogue. تلفّ قائمتك في كائن بالمفتاح الوحيد catalogue، وتسقط الملف هنا وتضغط الزر. وبعد لحظة تنزّل XML جذره catalogue ويحوي 300 عنصر product، لكل منها id سمةً لأنك كتبت المفتاح @id. وترفع الخلاصة، فيقبلها السوق. ويبقى JSON في مجلدك مصدراً.
قائمة فحص قصيرة
قبل التحويل
تأكد من أن JSON صالح. اختر اسم الجذر. علّم السمات بـ@. واحتفظ بـJSON.
أثناء التحويل
ابقَ في الصفحة حتى يجهز الملف.
بعد التحويل
افتح XML، وافحص أسماء العناصر والسمات والقوائم، واختبره مع المتلقي.
أخطاء شائعة
افتراض أن النتيجة مُتحقَّق منها
XML سليم التكوين، لا مفحوص مقابل أي مخطط. تحقق منه مقابل قواعد المتلقي.
استعمال مفاتيح بمسافات أو رموز
تصير عناصر item بسمة name. استعمل أسماء صالحة إن كان المتلقي يتوقعها.
حذف JSON
احتفظ به. فهو يحمل الأنواع التي لا يستطيعها XML.
بياناتك تبقى على جهازك
يحدث التحويل محلياً. يقرأ متصفحك أنت ملفك ويعيد كتابته هناك ويعيده إليك بصيغة XML. لا شيء يُرفع، فلا تنتهي نسخة على خادم ولا يستطيع أحد آخر قراءتها. ولبيانات ذات محتوى خاص هذه هي الطريقة الآمنة لتحويل JSON إلى XML.
الخلاصة
لتحوّل JSON إلى XML هنا، أسقط الملف واضغط الزر. يُقرأ ويُكتب في متصفحك، فلا يغادر الملف جهازك. وتُحفظ الشجرة كلها. كائن بمفتاح واحد يسمي المستند باسم ذلك المفتاح، فملف XML حُوّل إلى JSON وأُعيد يشبه نفسه؛ وتكرر المصفوفة عنصرها؛ والمفتاح الذي يبدأ بـ@ يصير سمة. أي مفتاح JSON يمكن أن يكون كلمة؛ واسم عنصر XML لا يمكن. والمفتاح الذي ليس اسماً صالحاً لا يُشوَّه ليصير واحداً: بل يصير عنصر item بسمة name، فيبقى الأصل في الملف وما زال يمكن العثور عليه. ولا شيء يُعطى نطاق أسماء، ولا شيء يُعطى مخططاً: النتيجة سليمة التكوين، لا مُتحقَّق منها.