تبدیل CSV به JSON

چرا صفحه‌گسترده را به JSON تبدیل کنیم

JSON فرمت وب است. APIها آن را برمی‌گردانند، JavaScript آن را مستقیماً می‌خواند، ابزارهای بدون کدنویسی و پلتفرم‌های خودکارسازی آن را انتظار دارند و فایل‌های پیکربندی، داده‌های اولیه و داده‌های آزمایشی تقریباً همیشه با آن نوشته می‌شوند. از سوی دیگر، داده معمولاً زندگی‌اش را در یک صفحه‌گسترده شروع می‌کند، چون مردم آنجا راحت ویرایشش می‌کنند. این ابزار این دو را به هم وصل می‌کند: یک فایل CSV یا Excel وارد می‌شود و یک فایل JSON تمیز بیرون می‌آید و سرستون‌ها به نام ویژگی‌ها تبدیل می‌شوند.

دو شکل خروجی

آرایه‌ای از اشیا همان چیزی است که تقریباً همه می‌خواهند. ردیف اول به عنوان سرستون در نظر گرفته می‌شود و هر ردیف بعدی به شیئی با همان کلیدها تبدیل می‌شود:

[
  { "name": "Ada", "email": "ada@example.com", "plan": "pro" },
  { "name": "Grace", "email": "grace@example.com", "plan": "free" }
]

آرایه‌ای از آرایه‌ها جدول خام را، همراه با ردیف سرستون و بدون کلید، نگه می‌دارد. حجم کمتری دارد و زمانی انتخاب درستی است که ردیف سرستون تمیز نیست، ترتیب ستون‌ها اهمیت دارد یا برنامه مصرف‌کننده به جای رکورد، جدول انتظار دارد.

اعداد، مقادیر بولی و خانه‌های خالی

وقتی تبدیل نوع روشن است، مقادیری که شبیه عدد هستند به عدد JSON تبدیل می‌شوند، «true» و «false» به مقدار بولی و خانه‌های خالی به null. وقتی خاموش است، هر مقداری یک رشته متنی است، دقیقاً همان‌طور که در برگه دیده می‌شد. وقتی شناسه‌هایی دارید که عددی به نظر می‌رسند اما باید صفرهای ابتدایی‌شان را نگه دارند، مانند کدهای پستی، کدهای محصول و شماره تلفن‌ها، آن را خاموش کنید.

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

نام ویژگی‌ها دقیقاً همان‌طور که در ردیف سرستون نوشته شده‌اند برداشته می‌شوند. سرستون‌هایی که فاصله یا علائم نگارشی دارند، مانند «First name» یا «Price (USD)»، کلیدهای معتبر JSON هستند اما در کد دست‌وپاگیرند. اگر کلیدهای مرتبی مثل first_name و price_usd می‌خواهید، پیش از تبدیل نام ستون‌ها را در صفحه‌گسترده تغییر دهید. سرستون‌های تکراری یک پسوند عددی می‌گیرند تا هیچ داده‌ای از دست نرود.

ورودی Excel

فایل .xlsx یا .xls را مستقیماً بکشید و رها کنید؛ برگه اول استفاده می‌شود. تاریخ‌ها به جای شماره‌های سریال داخلی Excel به صورت رشته‌های ISO (2026-03-14) نوشته می‌شوند و فرمول‌ها با مقدارشان جایگزین می‌شوند.

کاربردهای رایج

• پر کردن یک پایگاه داده یا نمونه اولیه با داده‌های واقعی از یک صفحه‌گسترده.
• وارد کردن فهرستی از محصولات، شعبه‌ها یا اعضای تیم به فرایند ساخت یک وب‌سایت.
• ورود داده به ابزارهای خودکارسازی مانند Make، n8n یا Zapier که JSON می‌خواهند.
• ساختن داده‌های آزمایشی از یک خروجی واقعی.
• تبدیل یک جدول مرجع برای یک اپلیکیشن موبایل.

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