نحوه استفاده
- یک آرایه JSON از اشیاء را جایگذاری کنید، یک فایل .json باز کنید یا «یک مثال را امتحان کنید» را بزنید.
- جداکنندهای را که صفحهگسترده شما انتظار دارد و نحوه نوشتهشدن آرایههای داخل اشیاء را انتخاب کنید.
- پیشنمایش CSV را بررسی کنید. هر شیء یک سطر است؛ فیلدهای تودرتو به ستونهایی مانند address.city تبدیل میشوند.
- CSV را کپی کنید یا آن را بهصورت فایل .csv دانلود کنید.
نحوه کار
هر عنصر از آرایه سطح بالا به یک سطر تبدیل میشود. ستونها اجتماع همه کلیدها هستند، به ترتیبی که نخستین بار ظاهر میشوند؛ بنابراین اشیاء با فیلدهای متفاوت همچنان در یک سطر قرار می‌گیرند و مقدار جاافتاده یا null سلول خالی می‌سازد. اشیاء تو در تو با مسیر نقطه‌ای تخت میشوند: {"address": {"city": "Oslo"}} به ستونی به نام address.city تبدیل میشود. اگر ریشه یک شیء تکی باشد، خروجی یک سطر است. آرایه‌هایی از مقادیر ساده (مانند [1, 2, 3]) یک ستون تکی به نام value تولید می‌کنند.
آرایههای داخل اشیاء را به سه شکل می‌توان نوشت: بهصورت متن JSON در یک سلول (["a","b"]), بهصورت ادغامشده در یک سلول (a; b)، یا پخش‌شده در ستونهای شماره‌دار (tags.0، tags.1). وقتی هر سطر فهرست کوتاه و مشابهی دارد، از گزینه آخر استفاده کنید.
خروجی از RFC 4180 پیروی می‌کند: وقتی فیلدی شامل جداکننده، علامت نقل‌قول دوتایی یا شکست خط باشد داخل علامت نقل‌قول دوتایی قرار میگیرد و علامت‌های نقل‌قول دوتایی داخل آن دوبرابر میشوند. سطرها با شکست خط CRLF پایان می‌یابند. در بسیاری از تنظیمات محلی اروپایی Excel نقطهویرگول را به‌جای ویرگول انتظار دارد، زیرا ویرگول جداکننده اعشار است. Excel همچنین ممکن است هنگام باز کردن فایل CSV، اعداد طولانی، صفرهای ابتدایی و متن‌های شبیه تاریخ را دوباره قالب‌بندی کند؛ اگر مقدار دقیق اهمیت دارد، فایل را بهصورت متن وارد کنید. اعداد بزرگ‌تر از 2^53 هنگام تجزیه JSON دقت خود را از دست می‌دهند.
نمونه‌ها
خروجی گرفتن کاربران از API
یک API خروجی [{"id":1,"name":"Ada","address":{"city":"London"}}, …] را برمی‌گرداند. CSV ستونهای id، name و address.city را دارد و برای مرتب‌سازی و فیلتر کردن در صفحه گسترده آماده است.
متن دارای ویرگول و علامت نقل‌قول
نامی مانند Alan "AT" Turing به "Alan ""AT"" Turing" تبدیل میشود و شهری مانند Wilmslow, Cheshire درون علامت نقل‌قول قرار میگیرد تا برنامه‌های صفحهگسترده هر مقدار را در سلول خودش نگه دارند.
باز کردن در Excel آلمانی یا فرانسوی
گزینه نقطهویرگول را به‌عنوان جداکننده انتخاب و UTF-8 BOM را فعال کنید. Excel سپس ستونها را درست جدا می‌کند و نویسه‌هایی مانند ä و é را بدون به‌هم‌ریختگی نشان می‌دهد.
پرسش‌های متداول
برای JSON با تودرتویی زیاد چه اتفاقی میافتد؟
اشیای تودرتو در هر عمق به نام ستونهای مسیر نقطهدار تبدیل میشوند؛ برای مثال order.customer.address.zip. آرایهها طبق گزینهای که انتخاب میکنید پردازش میشوند: متن JSON، مقادیر ادغامشده یا یک ستون برای هر آیتم.
چرا بعضی از سلولها خالی هستند؟
وقتی یک شیء کلید را نداشته باشد یا مقدار آن null باشد، سلول خالی میماند. ستونها از مجموع همه اشیاء ساخته میشوند؛ بنابراین کلیدی که فقط برخی از اشیاء دارند هم یک ستون میگیرد.
کدام جداکننده را انتخاب کنم؟
ویرگول استاندارد است. برای Excel در مناطقی که اعشار با ویرگول نوشته میشود (بخش بزرگی از اروپا و آمریکای لاتین) از نقطهویرگول استفاده کنید؛ و وقتی دادهها خودشان ویرگولهای زیادی دارند یا میخواهید مستقیماً در صفحهگسترده جایگذاری کنید، از Tab استفاده کنید.
آیا میتواند CSV را دوباره به JSON تبدیل کند؟
بله، با مبدل CSV به JSON در همین سایت. توجه داشته باشید که تختسازی کاملاً برگشتپذیر نیست: نام ستونهای مسیر نقطهدار بهصورت کلید سادهای مانند «address.city» برمیگردند، نه اشیاء تودرتو.
حریم خصوصی
تبدیل در مرورگر شما انجام میشود. JSON شما و نتیجه CSV آپلود، ذخیره یا در تحلیلهای آماری استفاده نمیشوند.