نحوه کارکرد مبدل CSV / JSON / Excel
این ابزار فرآیند تبدیل فایلهای جدولی بین فرمتهای CSV، JSON و Excel را به طور مستقیم در مرورگر وب شما انجام میدهد. شما میتوانید یک فایل را از دستگاه خود انتخاب کرده یا آن را به درون ابزار بکشید و رها کنید، فرمت خروجی مورد نظر خود را تعیین نمایید و برای تبدیلهای منتهی به CSV، نوع جداکننده را مشخص کنید. پس از اتمام عملیات تبدیل، امکان مشاهده پیشنمایش نتیجه و دانلود فایل جدید برای شما فراهم میشود.
عملیات پردازش و تبدیل فایلهای جدولی در مرورگر کاربر انجام میشود و هیچ دادهای به سرور BroBroGo ارسال نمیگردد. فایلهای CSV، JSON و XLSX در مرورگر شما تجزیه شده و فایل دانلودی به صورت محلی تولید میشود.
فرمتهای ورودی و تنظیمات خروجی
این ابزار برای هر بار استفاده، محدود به پذیرش یک فایل ورودی است. مشخصات ورودیها و خروجیهای سیستم به شرح زیر است:
مشخصات ورودی
- فایل ورودی: یک فایل تک با فرمتهای مجاز CSV، JSON یا XLSX. فایلهای بسیار بزرگ توسط سیستم پذیرفته نمیشوند.
- فرمت ورودی: سیستم به طور خودکار فرمت فایل آپلود شده را تشخیص میدهد.
- فرمت خروجی: توسط کاربر از بین گزینههای CSV، JSON یا Excel انتخاب میشود.
- جداکننده CSV: در صورت انتخاب خروجی CSV، کاربر میتواند یکی از گزینههای کاما، نقطه ویرگول یا تب (Tab) را به عنوان جداکننده تعیین کند.
مشخصات خروجی و متغیرهای نمایشی
پس از انجام فرآیند، ابزار اطلاعات و نتایج زیر را نمایش میدهد:
- نتیجه: نمایش فایل تبدیلشده و پیشنمایش آن.
- ردیفها: تعداد ردیفهای موجود در جدول تبدیلشده.
- ستونها: تعداد ستونهای موجود در جدول تبدیلشده.
- خروجی: حجم فایل خروجی تولید شده.
قوانین تبدیل و مدیریت ساختار دادهها
تبدیل دادهها بین ساختارهای متنی و صفحهگسترده تابع قوانین مشخصی برای حفظ یکپارچگی جدول است:
- تبدیل از Excel: ابزار تنها مقادیر مرئی را از اولین برگه (worksheet) فایل Excel استخراج و تبدیل میکند. این ابزار فرمولها را محاسبه نمیکند و استایل یا قالببندی سلولها را در فایلهای Excel حفظ نمینماید.
- تبدیل از JSON به جدول: آرایههایی از اشیاء به ردیفهای جدول تبدیل میشوند. کلیدهای تعریفشده در اشیاء به عنوان ستونهای جدول قرار میگیرند. کلیدهای مربوط به اشیاء تودرتو (nested objects) با استفاده از مسیرهای نقطهای (dot paths) مسطحسازی میشوند. همچنین آرایههایی از آرایهها به عنوان ردیفهای جدول حفظ میگردند.
خطاها و پیامهای سیستم در حین پردازش
در صورت بروز مشکل در ساختار فایل یا فرآیند تبدیل، سیستم پیامهای خطای زیر را نمایش میدهد:
- اگر فایلی انتخاب نشده باشد: «ابتدا یک فایل انتخاب کنید.»
- اگر فرمت فایل ارسالی نادرست باشد: «یک فایل CSV، JSON یا XLSX انتخاب کنید.»
- اگر حجم فایل از حد مجاز فراتر رود: «این فایل بسیار بزرگ است. از فایلی با حجم کمتر از
{max}استفاده کنید.» - در صورت یکسان بودن فرمت ورودی و خروجی: «یک فرمت خروجی متفاوت انتخاب کنید.»
- در صورت بروز خطای عمومی در تبدیل: «امکان تبدیل این فایل وجود نداشت.»
- اگر ساختار فایل CSV مشکل داشته باشد: «این CSV قابل تجزیه نیست.»
- اگر ساختار فایل JSON نامعتبر باشد: «این JSON نامعتبر است یا ساختار جدولی ندارد.»
- اگر فایل Excel باز نشود: «این فایل Excel باز نشد.»
- اگر فایل فاقد داده باشد: «این فایل فاقد ردیفهای جدولی است.»
- اگر تعداد ردیفها بیش از حد مجاز باشد: «این جدول بیش از
{max}ردیف دارد.» - اگر تعداد ستونها بیش از حد مجاز باشد: «این جدول بیش از
{max}ستون دارد.» - در صورت لغو عملیات: «تبدیل لغو شد.»
- در صورت طولانی شدن فرآیند: «این تبدیل بیش از حد طول میکشد. فایل کوچکتری را امتحان کنید.»
پرسشهای متداول
آیا جداول من آپلود میشوند؟
خیر. فایلهای CSV، JSON و XLSX در مرورگر شما تجزیه میشوند و فایل دانلودی به صورت محلی تولید میشود.
آیا فرمولها و قالببندی Excel حفظ میشوند؟
خیر. این ابزار مقادیر مرئی را از اولین برگه (worksheet) به یک جدول تمیز تبدیل میکند. فرمولها را محاسبه نمیکند و استایل سلولها را حفظ نمیکند.
JSON چگونه به جدول تبدیل میشود؟
آرایههایی از اشیاء به ردیفها تبدیل میشوند، کلیدهای اشیاء به ستونها تبدیل میشوند و کلیدهای اشیاء تودرتو با مسیرهای نقطهای (dot paths) مسطح میشوند. آرایههایی از آرایهها به عنوان ردیفهای جدول حفظ میشوند.