Как преобразовать JSON в Excel за четыре шага
- Добавьте данные JSON. Вставьте объект или массив, либо загрузите поддерживаемый файл
.json. - Выберите записи. Выберите массив верхнего уровня или вложенный массив внутри объекта-обертки.
- Настройте лист. Установите параметры выравнивания, режим массивов и имя листа.
- Просмотр и скачивание. Проверьте таблицу, затем создайте и скачайте книгу
.xlsx.
Выберите массив записей
Ответы API JSON часто оборачивают записи в метаданные.
{
"page": 1,
"results": [
{"id": 1, "name": "Ada"},
{"id": 2, "name": "Lin"}
]
}Селектор записей предлагает results и показывает, что он содержит две записи.
Если выбрать один объект, инструмент создаст одну строку. Если табличный набор записей отсутствует, превью объяснит, почему структура не может быть четко сопоставлена с листом.
Выравнивание вложенных объектов в столбцы
Вложенные объекты могут использовать имена столбцов с точечными путями:
customer.name
customer.address.city- выравнивание включено или выключено
- разделитель пути
- максимальная глубина
- сохранять значения за пределами глубины как текст JSON
Предварительный просмотр листа показывает окончательные заголовки перед созданием файла.
Режим сопоставления массивов в Excel
Объединение простых массивов
Простой массив может стать одной ячейкой. Разделитель объединения по умолчанию — | .
Сохранение как текст JSON
Сохраняйте массив полностью в ячейке, если структура без потерь важнее, чем удобство таблицы.
Поведение по умолчанию не отбрасывает элементы массива без предупреждения.
Создание стабильного набора заголовков
Если записи содержат разные ключи, инструмент объединяет все поля из выбранных записей.
- показывать отсутствующие значения пустыми или использовать выбранный плейсхолдер
- предупреждать, если выравнивание создает дублирующиеся заголовки
- сохранять детерминированный порядок
Один и тот же заголовок не появится дважды на итоговом листе.
Сохранение типов ячеек Excel
- Числа JSON → числовые ячейки Excel
- Логические значения JSON → логические ячейки
- Строки JSON → текстовые ячейки
- Null JSON → пустые ячейки
Строкам в формате даты требуется явная опция. Автоматическое преобразование любой ISO-подобной строки в дату Excel может повредить идентификаторы или исходный текст, поэтому распознанные даты преобразуются только при включении опции.
Параметры книги
Вы можете задать имя листа (проверяется на соответствие правилам именования XLSX) и имя скачиваемого файла. Имя листа автоматически очищается, если содержит запрещенные в Excel символы.
Превью перед созданием XLSX
Превью показывает выбранный путь к записям, их количество, итоговые столбцы, предупреждения о массивах и выравнивании, а также примеры строк до генерации книги.
Частые проблемы при переносе JSON в Excel
Все данные отображаются в одной ячейке
Выбран неправильный узел JSON или вложенные значения сохранены как текст JSON. Выберите массив записей и включите режим выравнивания.
В массивах пропадают значения
Измените стратегию обработки массивов. Объединяйте, сохраняйте или разворачивайте их вместо использования неподдерживаемого режима по умолчанию.
Некоторые столбцы пустые
Записи JSON содержат разные ключи. Книга собирает объединение столбцов, поэтому отсутствующие поля остаются пустыми.
Изменились длинные числа
Числовой точности таблицы может быть недостаточно. Экспортируйте идентификаторы и очень большие целые числа как текст.
Изменился формат дат
Сохраняйте даты как текст или выберите явное преобразование в даты Excel. Автоматическая обработка дат остается опциональной.
Часто задаваемые вопросы по JSON в Excel
Создается ли настоящий файл XLSX?
Да. Страница генерирует настоящую книгу .xlsx прямо в вашем браузере, а не файл CSV, открываемый в Excel.
Можно ли конвертировать вложенный JSON?
Да, благодаря настроенным стратегиям выравнивания и массивов. Превью показывает окончательные столбцы листа.
Как обрабатываются массивы?
Вы можете объединить их значения, сохранить как текст JSON или оставить пустыми. Элементы массивов не пропадают без вашего ведома.
Можно ли выбрать имя листа Excel?
Да. Имя листа задается в параметрах и проверяется на соответствие правилам XLSX.
Сохраняются ли числа и логические типы?
Они преобразуются в соответствующие типы ячеек Excel, если это безопасно. Для очень больших целых чисел требуется режим текста, чтобы избежать округления.
Загружается ли JSON в сеть?
Нет — вставленный JSON обрабатывается локально в вашем браузере. Файлы, превышающие лимит обработки браузера, могут быть отправлены на сервер для конвертации только с вашего явного согласия.