Быстрый старт: переводим таблицу в JSON

Чтобы быстро преобразовать выгрузку товаров, список остатков или прайс-лист в структурированный веб-формат, достаточно подготовить таблицу с понятными заголовками в первой строке. Онлайн-конвертер csv в json пошагово на Zyntec автоматически разберет строки и сформирует валидный код для сайта, базы данных или интеграций. Вы сразу получаете готовый массив или словарь, готовый к отправке в интерфейс каталога.

Как подготовить CSV перед обработкой

Перед запуском убедитесь, что таблица оформлена аккуратно. Это убережет от ошибок парсинга и сэкономит время при настройке карточек товаров:

  • Первая строка: содержит заголовки столбцов (например, артикул, название, цена). Они станут ключами объектов в результирующем коде.
  • Разделители: в сервисе доступны варианты «Авто», «Запятая», «Точка с запятой», «Табуляция» и «Вертикальная черта». Если в описании товаров встречаются запятые, укажите разделитель вручную (например, точку с запятой) или выберите «Авто».
  • Согласованность колонок: в каждой строке должно быть ровно столько же значений, сколько названий в первой строке.
  • Уникальность первой колонки: если вы планируете собирать словарь, значения первого столбца (например, уникальный SKU) не должны повторяться.
  • Лимит данных: инструмент принимает текст объемом до 200000 символов. Если файл каталога больше, разделите его на несколько фрагментов.
  • Типы данных: все поля после преобразования остаются строковыми. Цены и остатки сохраняются в виде текста в кавычках.

Пошаговая инструкция

  1. Подготовьте таблицу. Проверьте первую строку с заголовками и убедитесь, что структура колонок не нарушена.
  2. Вставьте данные. Откройте сервис и скопируйте таблицу в поле «CSV-данные».
  3. Укажите разделитель. Оставьте режим «Авто» или вручную выберите нужный вариант: «Запятая», «Точка с запятой», «Табуляция» либо «Вертикальная черта».
  4. Выберите формат JSON. Отметьте «Массив объектов» (для списков товаров) или «Словарь по 1-му столбцу» (для быстрого доступа к товару по ключу).
  5. Запустите конвертацию. Нажмите кнопку обработки и оцените полученный результат.
  6. Проверьте и сохраните. Сверьте названия свойств и количество записей с исходным файлом, после чего скопируйте готовый JSON для использования в проекте.

Наглядные примеры для разных задач

1. Массив объектов для каталога

Универсальный формат для генерации витрины интернет-магазина или товарной сетки.

Исходный CSV:

name,price,qty
Чехол,590,12
Коврик,890,5

Настройки: разделитель «Запятая», формат «Массив объектов».

Результат:

[
  {
    "name": "Чехол",
    "price": "590",
    "qty": "12"
  },
  {
    "name": "Коврик",
    "price": "890",
    "qty": "5"
  }
]

2. Словарь по первой колонке для поиска по артикулу

Удобен, когда нужно быстро обращаться к свойствам товара по его идентификатору.

Исходный CSV:

sku,name,price
a1,Чехол,590
a2,Коврик,890

Настройки: разделитель «Запятая», формат «Словарь по 1-му столбцу».

Результат:

{
  "a1": {
    "name": "Чехол",
    "price": "590"
  },
  "a2": {
    "name": "Коврик",
    "price": "890"
  }
}

3. Автоматическое определение разделителя и кавычки

Если внутри описания или характеристик присутствуют запятые, используйте точку с запятой и кавычки:

name;note
Чехол;"красный, синий, белый"

При выборе режима «Авто» и формата «Массив объектов» значение поля note сохранится единой строкой: красный, синий, белый.

Важные особенности структуры и типов данных

  • Форматы вывода: «Массив объектов» формирует последовательный список, где каждый элемент содержит набор полей из шапки. «Словарь по 1-му столбцу» создает единый объект, где ключами первого уровня выступают значения из первой колонки таблицы.
  • Первая строка: пустые или технические заголовки в первой строке попадут в итоговые ключи, поэтому их стоит скорректировать до конвертации.
  • Типы полей: автоматического приведения чисел к числовому типу не происходит, поля цен и количеств в JSON остаются строками.

Частые ошибки и как их исправить

  • Лишние или пропущенные разделители. Сообщение «Не получилось: Строка 2: ожидалось полей 2, получено 3» появляется, если число значений в строке не совпадает с количеством заголовков. Проверьте вторую строку на лишние запятые или незакрытые кавычки.
  • Не выбран формат вывода. Интерфейс выдает предупреждение «Не получилось: Выберите доступный формат JSON», если переключатель структуры остался пустым. Достаточно выбрать один из двух вариантов.
  • Нарушение синтаксиса CSV. Ошибка «Не получилось: Ошибка парсинга CSV: unexpected end of data» возникает при наличии незакрытой кавычки в тексте. Закройте кавычку в исходнике и повторите запуск.

Читайте также