تبدیل JSON به CSV

آرایه‌ای از اشیاء

آرایه‌ای از اشیاء واضح‌ترین منبع برای CSV است زیرا هر شیء به یک ردیف تبدیل می‌شود.

[
  {"id": 1, "name": "Ada"},
  {"id": 2, "name": "Lin"}
]

کلیدها به ستون‌ها و اشیاء به ردیف‌ها تبدیل می‌شوند.

شیء واحد

یک شیء مسطح واحد به یک ردیف CSV تبدیل می‌شود. اگر شیء حاوی یک آرایه تو در تو از رکوردها باشد، ابزار به شما امکان می‌دهد آن آرایه را به عنوان منبع رکورد انتخاب کنید.

{
  "results": [
    {"id": 1, "status": "active"},
    {"id": 2, "status": "paused"}
  ],
  "count": 2
}

انتخاب results دو ردیف ایجاد می‌کند. مقدار wrapper count به رکورد سوم تبدیل نمی‌شود.

اشیاء با کلیدهای متفاوت

آرایه‌های JSON واقعی همیشه حاوی اشیاء یکسان نیستند. مبدل اتحاد کلیدها را در بین رکوردهای انتخاب شده می‌سازد.

[
  {"id": 1, "email": "[email protected]"},
  {"id": 2, "phone": "555-0100"}
]

CSV شامل ستون‌های id، email و phone است، با مقدار خالی در جایی که رکورد حاوی آن کلید نیست.

اشیاء تو در تو نمی‌توانند مستقیماً در ستون‌های CSV معمولی قرار بگیرند. این ابزار مسیرهای اصلی شیء را به نام ستون‌ها مسطح می‌کند.

{
  "user": {
    "name": "Ada",
    "address": {
      "city": "London"
    }
  }
}

ستون‌های پیشنهادی:

user.name
user.address.city

پنل گزینه‌ها شامل مسطح کردن اشیاء تو در تو (روشن/خاموش)، جداکننده مسیر، حداکثر عمق مسطح‌سازی و رفتار پس از رسیدن به حداکثر عمق است.

آرایه‌ها به یک قانون خروجی عمدی نیاز دارند زیرا یک سلول CSV نمی‌تواند به طور طبیعی رکوردهای ساختاریافته تکراری را نشان دهد.

• پیوستن مقادیر اولیه: ["red","blue"] به red, blue تبدیل می‌شود.
• به عنوان JSON نگه دار: متن کامل آرایه را در یک سلول نقل قول شده حفظ کنید.
• خالی بگذار: فقط به عنوان انتخاب صریح کاربر در دسترس است، هرگز پیش‌فرض بی‌صدا نیست.

جداکننده

کاما، سمی‌کالن، تب، لوله یا یک کاراکتر سفارشی پشتیبانی شده را انتخاب کنید. جداکننده انتخاب شده به طور مداوم در سربرگ و هر ردیف اعمال می‌شود.

ردیف سربرگ

خروجی پیش‌فرض شامل نام ستون‌ها است. یک کلید، سربرگ را برای سیستم‌هایی که فقط ردیف‌های خام را می‌پذیرند حذف می‌کند.

نقل قول

مقادیر CSV حاوی جداکننده، نقل قول یا خط جدید به درستی نقل قول می‌شوند. نقل قول‌های واقعی در داخل یک فیلد نقل قول شده فرار می‌کنند.

• نقل قول حداقلی
• نقل قول همه فیلدها
• پایان خط
• شامل BOM UTF-8 در صورت نیاز برای سازگاری با صفحه گسترده

مقادیر خالی و null

انتخاب کنید که null، کلیدهای از دست رفته و رشته‌های خالی چگونه نمایش داده شوند: سلول خالی، null واقعی یا جای‌گذار سفارشی. پیش‌نمایش تفاوت را قبل از دانلود قابل مشاهده می‌کند.

پیش‌نمایش تعداد رکوردهای شناسایی شده، تعداد ستون‌های تولید شده، مسیر رکورد انتخاب شده و هشدارهایی برای اشکال ناسازگار شیء یا آرایه‌های تو در تو، به همراه نمای جدولی از اولین ردیف‌های رندر شده را نشان می‌دهد. خروجی CSV خام در دسترس است وقتی نیاز به بررسی نقل قول دارید.

خروجی فقط یک ردیف دارد

مقدار JSON انتخاب شده احتمالاً یک شیء واحد است نه آرایه رکورد. آرایه تو در توی حاوی رکوردها را انتخاب کنید.

فیلدهای تو در تو از دست رفته‌اند

مسطح‌سازی را فعال کنید یا «نگه داشتن مقدار تو در تو به عنوان JSON» را انتخاب کنید. ابزار زمانی که مقداری از عمق مسطح‌سازی پیکربندی شده فراتر رود هشدار می‌دهد.

برخی ردیف‌ها سلول‌های خالی دارند

اشیاء JSON حاوی کلیدهای متفاوت یا مقادیر از دست رفته هستند. CSV به یک مجموعه مشترک از ستون‌ها نیاز دارد، بنابراین مقادیر از دست رفته به سلول‌های خالی یا جای‌گذار انتخاب شده تبدیل می‌شوند.

آرایه‌ها در اکسل قابل خواندن نیستند

استراتژی آرایه را تغییر دهید. برای برچسب‌های ساده مقادیر اولیه را بپیوندید، یا آرایه اصلی را به عنوان JSON فشرده نگه دارید وقتی ساختار مهم است.

نویسه‌های دارای لهجه نادرست به نظر می‌رسند

با تنظیمات سازگار با UTF-8 دانلود کنید و فایل را با رمزگذاری صحیح باز کنید. اگر گزینه BOM وجود دارد، فقط پیشوند بایت را تغییر می‌دهد؛ محتوا را دوباره رمزگذاری نمی‌کند.