تبدیل JSON به XML JavaScript Object Notation ↔ Extensible Markup Language رایگان آنلاین امن

چرا مردم 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="the original key" نوشته می‌شود، پس اصل هنوز در فایل است و هنوز یافتنی. هیچ چیز بی‌صدا تغییر نام نمی‌دهد.

هیچ فضای نامی ندارد، هیچ طرحواره‌ای ندارد

هیچ چیز فضای نام ندارد و هیچ چیز طرحواره (schema) نمی‌گیرد. نتیجه خوش‌ساخت است، نه اعتبارسنجی‌شده. هر خواننده 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 و API‌های اولیه ساخته شده‌اند 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 نوشته بودید. فید را بارگذاری می‌کنید و بازارچه آن را می‌پذیرد. JSON در پوشه‌تان به عنوان منبع می‌ماند.

یک فهرست کنترل کوتاه

پیش از تبدیل

بررسی کنید JSON معتبر است. نام ریشه را انتخاب کنید. صفت‌ها را با @ علامت بزنید. JSON را نگه دارید.

هنگام تبدیل

تا آماده شدن فایل روی صفحه بمانید.

پس از تبدیل

XML را باز کنید، نام عنصرها، صفت‌ها و فهرست‌ها را بررسی کنید و با دریافت‌کننده آزمایش کنید.

اشتباه‌های رایج

فرض کردن اینکه نتیجه اعتبارسنجی شده

XML خوش‌ساخت است، نه سنجیده‌شده با هیچ طرحواره‌ای. آن را با قواعد دریافت‌کننده اعتبارسنجی کنید.

استفاده از کلیدهایی با فاصله یا نماد

به عنصرهای item با صفت name تبدیل می‌شوند. اگر دریافت‌کننده انتظار دارد، نام‌های معتبر به کار ببرید.

حذف JSON

آن را نگه دارید. نوع‌هایی را دارد که XML نمی‌تواند.

داده‌تان روی دستگاهتان می‌ماند

تبدیل به صورت محلی انجام می‌شود. فایل شما توسط مرورگر خودتان خوانده، همان‌جا بازنویسی و به شکل XML تحویل داده می‌شود. چیزی بارگذاری نمی‌شود، پس هیچ نسخه‌ای روی سرور نمی‌ماند و هیچ‌کس دیگر نمی‌تواند آن را بخواند. برای داده‌ای با محتوای خصوصی، این راه ایمن برای تبدیل JSON به XML است.

خلاصه

برای تبدیل JSON به XML در اینجا، فایل را رها کنید و دکمه را بفشارید. در مرورگر شما خوانده و نوشته می‌شود، پس فایل هرگز دستگاه شما را ترک نمی‌کند. کل درخت حفظ می‌شود. شیئی با یک کلید سند را به نام همان کلید می‌نامد، پس فایل XMLی که به JSON و دوباره برگردانده شود شبیه خودش می‌ماند؛ آرایه عنصرش را تکرار می‌کند؛ کلیدی که با @ شروع شود صفت می‌شود. هر کلید JSON می‌تواند یک کلمه باشد؛ نام عنصر XML نمی‌تواند. کلیدی که نام معتبر نیست به نامی معتبر دست‌کاری نمی‌شود: به عنصر item با صفت name تبدیل می‌شود، پس اصل هنوز در فایل است و هنوز یافتنی. هیچ چیز فضای نام ندارد و هیچ چیز طرحواره نمی‌گیرد: نتیجه خوش‌ساخت است، نه اعتبارسنجی‌شده.