Принципи роботи та підтримувані формати даних
Конвертер призначений для перетворення табличних файлів між трьома поширеними форматами: CSV, JSON та Excel. Інструмент працює з одним файлом за раз, автоматично визначаючи вхідний формат завантаженого документа. Користувач може самостійно обрати кінцевий формат (CSV, JSON або Excel) та налаштувати параметри розділювача для CSV.
Кожен із підтримуваних форматів має свої особливості представлення даних:
- CSV (Comma-Separated Values): Текстовий формат, де дані організовані у вигляді рядків, а значення впорядковані за допомогою розділювачів. Як розділювач користувач може обрати Кома, Крапка з комою або Табуляція.
- JSON (JavaScript Object Notation): Текстовий формат для обміну даними, що базується на парах "ключ-значення" та впорядкованих списках.
- Excel (XLSX): Бінарний формат електронних таблиць, який використовується для збереження складних табличних структур, що можуть містити кілька робочих аркушів, формули та стилі.
Локальна обробка даних у браузері
Ваш табличний файл конвертується безпосередньо у браузері. Нічого не завантажується на сервери BroBroGo. Файли CSV, JSON та XLSX обробляються безпосередньо у вашому браузері, а файл для завантаження генерується локально.
Такий підхід виключає передачу файлів через мережу інтернет на зовнішні сервери для конвертації. Усі обчислювальні операції з аналізу структури вихідного файлу та формування нового документа виконуються на пристрої користувача.
Правила перетворення та обмеження форматів
При конвертації між текстовими та табличними форматами діють певні правила трансформації даних, зумовлені різницею в їхній структурі:
- Особливості обробки Excel: Інструмент конвертує видимі значення з першого робочого аркуша у чисту таблицю. Він не обчислює формули та не зберігає стилі клітинок. Це означає, що будь-яке візуальне оформлення (шрифти, кольори, межі) та математичні формули будуть втрачені, а в результуючий файл потраплять лише фактичні текстові або числові значення, які відображалися в комірках на момент збереження.
- Трансформація JSON у табличну структуру: Оскільки JSON є ієрархічним форматом, а CSV та Excel — двовимірними таблицями, застосовуються такі правила вирівнювання структури:
- Масиви об'єктів стають рядками таблиці.
- Ключі об'єктів стають стовпцями.
- Вкладені ключі об'єктів розгортаються у пласкі шляхи через крапку.
- Масиви масивів зберігаються як табличні рядки.
Інтерфейс користувача та параметри конвертації
Для початку роботи необхідно завантажити файл, використовуючи область з написом "Виберіть або перетягніть файл CSV, JSON або XLSX". Під цією областю відображається підказка "По одному файлу за раз. Конвертуйте між CSV, JSON та Excel.".
Після вибору файлу інтерфейс відображає статус "Вибрано {name}." та запускає відповідні процеси обробки:
- "Читання
{name}..." - "Аналіз
{name}..." - "Запис результату для
{name}..."
У налаштуваннях користувач взаємодіє з такими елементами керування:
- Вхідні дані: Показує автоматично визначений формат завантаженого файлу.
- Результат: Вибір кінцевого формату (CSV, JSON або Excel).
- Розділювач CSV: Доступний при виборі вихідного формату CSV. Можна вказати значення Кома, Крапка з комою або Табуляція.
Після завершення процесу з'являється повідомлення "Створено {name}.". Користувач може переглянути статистику конвертації, яка містить такі показники:
- Рядки: Кількість оброблених рядків у таблиці.
- Стовпці: Кількість виявлених стовпців.
- Результат: Розмір готового до завантаження файлу.
Для збереження файлу на пристрій використовується кнопка "Завантажити". Для очищення робочої області та повернення до початкового стану призначена кнопка "Очистити" або функція "Вилучити файл".
Помилки обробки та способи їх вирішення
Під час роботи з файлами користувач може зіткнутися з помилками, які виникають через несумісність форматів, пошкодження даних або перевищення лімітів обробки:
- Проблеми з вибором файлу: Якщо спробувати запустити процес без завантаження документа, з'явиться попередження "Спочатку виберіть один файл.". При спробі завантажити непідтримуваний формат відображається помилка "Виберіть файл у форматі CSV, JSON або XLSX.".
- Перевищення лімітів розміру: Якщо файл занадто великий для обробки в браузері, інструмент покаже повідомлення "Цей файл завеликий. Використовуйте файл розміром менше ніж
{max}.". Також передбачено обмеження на структуру даних: "Ця таблиця містить понад{max}рядків." та "Ця таблиця містить понад{max}стовпців.". - Помилки структури даних: Якщо файл пошкоджений або не відповідає специфікації формату, виводяться повідомлення "Не вдалося розпізнати цей CSV.", "Цей JSON некоректний або не має табличної структури." або "Не вдалося відкрити цей файл Excel.". Якщо у файлі відсутні дані, з'явиться помилка "Цей файл не містить табличних рядків.".
- Конфлікти форматів та таймаути: Спроба конвертувати файл у той самий формат, у якому він завантажений, викликає помилку "Виберіть інший вихідний формат.". Якщо процес обробки зупиняється через брак системних ресурсів, користувач побачить повідомлення "Конвертація триває занадто довго. Спробуйте використати менший файл." або загальне сповіщення "Не вдалося конвертувати цей файл.". При ручному скасуванні операції виводиться статус "Конвертацію скасовано.".
Часті запитання (FAQ)
Чи завантажуються мої таблиці на сервер?
Ні. Файли CSV, JSON та XLSX обробляються безпосередньо у вашому браузері, а файл для завантаження генерується локально.
Чи зберігаються формули та форматування Excel?
Ні. Цей інструмент конвертує видимі значення з першого робочого аркуша у чисту таблицю. Він не обчислює формули та не зберігає стилі клітинок.
Як JSON перетворюється на таблицю?
Масиви об'єктів стають рядками, ключі об'єктів — стовпцями, а вкладені ключі об'єктів розгортаються у пласкі шляхи через крапку. Масиви масивів зберігаються як табличні рядки.
Що робити, якщо виникає помилка про завеликий розмір файлу?
Браузер має обмежені ресурси для обробки даних у пам'яті. Якщо ви бачите повідомлення про перевищення ліміту, необхідно зменшити розмір вхідного файлу або кількість рядків і стовпців у ньому.