Как преобразовать CSV в JSON с заголовками и проверить количество записей

Назначение и подготовка CSV-текста

Преобразователь предназначен для случая, когда исходная таблица уже представлена текстом CSV, а на выходе нужны данные в формате JSON. Вставьте содержимое таблицы в поле инструмента, чтобы получить записи и отдельно увидеть их количество. Такой подход удобен перед проверкой строк, подготовкой данных для другого процесса или просмотром того, как CSV читается в выбранном режиме.

Входом служит именно текст CSV, поэтому книга Excel в формате XLSX здесь не используется. Если таблица находится в электронной таблице, подготовьте текст CSV заранее или скопируйте нужное содержимое в поле исходных данных. Не рассчитывайте на автоматическое распознавание чисел, дат или других типов: значения ячеек читаются как текст.

Самая важная настройка относится к первой строке. Когда строк больше одной, стандартный режим принимает её за названия полей, а следующие строки превращает в записи. Если первая строка тоже содержит данные, сопоставление заголовков нужно отключить. Числовая настройка отступа отвечает за оформление JSON и по умолчанию имеет значение 2, поэтому она меняет читаемость представления, а не состав строк.

Порядок преобразования и проверки

Подготовьте текст CSV и вставьте его в поле исходных данных. Включите в него строку с названиями столбцов, если хотите использовать эти названия как имена полей JSON. Проверьте разделители и расположение строк до запуска, поскольку инструмент разбирает переданный текст, а не исходную книгу Excel.
Определите роль первой строки. Оставьте сопоставление заголовков включённым для таблицы, где первая строка содержит, например, name,city, а следующая строка содержит значения. При таком выборе первая строка задаёт поля, а каждая последующая строка становится записью. Если CSV начинается сразу со значений, отключите сопоставление заголовков: первая строка тогда не резервируется под имена полей.
При необходимости укажите числовой отступ для JSON. Значение 2 уже задано по умолчанию и подходит для обычного многострочного просмотра. Измените его, если требуется иное визуальное оформление результата, но не используйте этот параметр для попытки изменить содержимое или количество записей.
Запустите преобразование и изучите сформированный JSON. Сначала проверьте, что поля отражают выбранный режим первой строки, затем сопоставьте показанное количество записей с числом строк данных. При включённых заголовках не считайте строку названий отдельной записью, а при отключённых учитывайте её как данные.
Для проверки пустого состояния очистите поле и запустите обработку с пустым или состоящим только из пробелов вводом. В этом случае результатом будет пустой JSON-массив, а счётчик покажет ноль записей.
Если пустой массив сопровождается описанием ошибки, не рассматривайте его как корректно обработанный содержательный CSV. При исключении операция всё равно отмечается как успешная, но дополнительно возвращает описание ошибки и нулевой счётчик. Исправьте текст или параметры и повторите запуск.

Проверка результата и границы применения

При обычном успешном преобразовании ориентируйтесь на JSON-массив и число созданных записей. Если заголовки включены и во входе больше одной строки, объекты получают поля из первой строки, тогда как остальные строки становятся записями. Счётчик помогает сравнить результат с ожидаемым количеством строк данных, но сам по себе не подтверждает смысл или качество значений.

Отключение заголовков меняет интерпретацию того же текста. Первая строка больше не задаёт имена полей и входит в набор данных, поэтому количество записей может отличаться от результата стандартного режима. Сравнивайте варианты только после того, как решите, содержит ли начало CSV названия столбцов или реальные значения.

Пустой массив с нулём записей требует дополнительного чтения сопутствующей информации. Для пустого либо пробельного ввода описание ошибки не нужно, а при исключении оно возвращается вместе с пустым массивом и нулевым счётчиком. Наличие описания указывает, что следует проверить исходный текст и заданные параметры, прежде чем использовать результат.

Отступы влияют на вид JSON, но не на число записей. Выборочную проверку выполните по трём признакам: результат представлен в нужном формате, поля соответствуют режиму первой строки, а показанный счётчик совпадает с ожидаемым числом строк данных. Инструмент формирует плоские записи из строк и ячеек, поэтому вложенную структуру из одного CSV-текста ожидать не следует.

Практический пример

Небольшую таблицу с двумя столбцами нужно представить как одну JSON-запись, сохранив названия столбцов в качестве полей.

Вставьте две строки: name,city и Anna,Moscow, оставьте сопоставление заголовков включённым и установите отступ 2. Затем проверьте массив и показанный счётчик записей без пересчёта строки заголовков как данных для этого режима там нет.‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎

Результат имеет форму JSON-массива, а рядом отображается количество созданных записей. При включённых заголовках первая строка задаёт имена полей, а строка с данными становится одной записью.

Ограничения

Преобразование рассчитано на переданный текст CSV с плоским сопоставлением строк и ячеек; результат зависит от того, отведена ли первая строка под названия полей.

Частые ошибки

Первая строка неожиданно стала именами полей из-за включённого сопоставления заголовков. Отключите эту настройку и запустите преобразование заново, если первая строка должна считаться данными.

Частые вопросы

Как преобразовать CSV с заголовками в JSON?

Если первая строка содержит названия столбцов и во входе есть ещё строки, оставьте сопоставление заголовков включённым. Тогда названия станут полями JSON, а последующие строки будут преобразованы в записи.

Что делать, если в CSV нет заголовков?

Если первая строка содержит значения, отключите сопоставление заголовков. В таком режиме она не выделяется под имена полей и вместе с последующими строками обрабатывается как данные для записей JSON en.

Почему результатом стал пустой массив?

Пустой или пробельный ввод даёт пустой JSON-массив и нулевой счётчик. Когда рядом появляется описание ошибки, обработка столкнулась с исключением, поэтому проверьте CSV и параметры перед повторным запуском.