Перейти до вмісту
Coverton Блог
У цій статті
Таблиці та дані

Перетворіть JSON на JSONL: структура та формат

Перетворіть масив JSON на JSONL, якщо система-одержувач очікує одне значення на рядок. Кожен елемент у вибраному масиві стає лінією; вкладені масиви не розширюються автоматично в додаткові записи.

Відкрийте інструментЯк користуватися цим інструментом ↓
Перетворіть JSON на JSONL
Ілюстрація робочого процесу цього інструменту; це не результат завантаженого файлу.

Як користуватися цим інструментом

  1. Виберіть файли у форматі JSON. Максимальна кількість файлів на пакет: 1.
  2. Перегляньте Шлях до масиву (порожній для кореневого масиву), а потім почніть обробку.
  3. Завантажте результат JSONL і перевірте його вміст і якість.

Виберіть правильні налаштування

Залиште шлях до масиву порожнім для масиву верхнього рівня. Для одного всередині об’єкта введіть пунктирний шлях, наприклад data.items, і підтвердьте, що значення в цьому місці є масивом.

Підтримувані вхідні дані
  • JSON
Результат
  • JSONL
Доступні налаштування
  • Шлях до масиву (порожній для кореневого масиву)

Перед початком

З’ясуйте значення вхідних даних

Перед перетворенням визначте, що означає рядок або значення, і збережіть копію джерела. У таблицях перевірте заголовки, роздільники й кодування, у структурованих файлах — потрібні об’єкти чи масиви. Вигляд у табличній програмі сам по собі не визначає зміст кодів, дат і сум.

Вибирайте доступні ключові стовпці, правила типів і вихідні поля за вимогами одержувача. Випробуйте зразок із порожнім значенням, повтором і розділовими знаками. Для етикеток, діаграм і персоналізованих документів перевірте джерельні стовпці, одиниці та формулювання.

Заздалегідь визначте перевірки: ідентифікатор із незмінним написанням, значення з відомим змістом та очікуваний зв’язок записів. За наявності правил типів чи зіставлення відрізняйте початкове значення від його показу. Перевірте неоднозначні дати й по-різному записані ключі до застосування загального правила. Збережіть правила та вимоги з результатом, щоб пов’язати розбіжність із введенням, тлумаченням або перетворенням.

Звірте значення й винятки

Відкрийте або імпортуйте результат із налаштуваннями цільової програми. Порівняйте заголовки, кількість записів і вибіркові значення. Підсумовування, поділ чи видалення дублікатів можуть навмисно змінити кількість рядків; перевіряйте причину, а не вимагайте однакового числа після кожної операції.

Прочитайте звіти про винятки або перевірки перед продовженням. Якщо стовпці зсунулися, символи спотворені чи ключ відсутній, спершу перевірте роздільник, кодування і точні назви заголовків. Кодування не є шифруванням, форматування не підтверджує змісту. Випробуйте друковані коди чи етикетки до виготовлення всієї серії.

Приклад введення та виведення

[{"record":1},{"record":2}] → один запис JSON за лінією

Приклади описують робочий процес. Результати залежать від вихідного файлу та налаштувань.

Перед збереженням перевірте результат

Порівняти непорожні вихідні рядки з кількістю елементів вибраного масиву. Перевірте, чи кожен рядок дійсний JSON, і перевірте розриви рядків у рядках, щоб переконатися, що вони залишаються частиною своїх значень.

Якщо результат відрізняється від очікуваного

Неможливо обробити відсутній шлях або кінцеве значення, яке не є масивом. Дуже глибокі або великі конструкції можуть досягати межі безпеки, тому підготуйте лише масив, необхідний для цього завдання.

Пам’ятайте про обмеження

  • JSON представляє об’єкти, масиви, рядки, числа, істинні значення та значення null. Назви властивостей беруться в подвійні лапки. Використовуйте форматування для перевірки та CSV для відповідних структур таблиці.
  • JSON не допускає коментарів або кінцевих ком. Синтаксичний аналіз підлягає обмеженням чисельної точності JavaScript.
  • Перевірте кодування символів, роздільники та назви стовпців. Великі числа можуть втратити точність у JavaScript; CSV не зберігає всі типи та вкладені структури.
  • Кожен непорожній рядок має містити рівно одне повне значення JSON. Неправильні рядки зупиняють перетворення. З JSON в JSONL потрібен масив.

Продовжити з пов’язаними інструментами

Перетворіть CSV на JSON

Перший рядок CSV надає ключі для об’єкта JSON кожного рядка даних. Значення клітинок зберігаються як рядки, тому перевірте їх типи, перш ніж передавати результат системі, яка очікує чисел або логічних значень.

Виберіть кодування джерела і використовуйте автоматичне виявлення делімітера або виберіть реальний делімітер. Розв'яжіть порожні або подвійні заголовки і переконайтеся, що кожна рядка має таку ж кількість стовпів, як і заголовка.

Відкрийте інструмент

Перетворіть JSON на CSV

Для перетворення потрібен масив об’єктів. Вирішіть, чи вкладені об’єкти мають стати окремими стовпцями, чи залишитися рядками JSON у клітинках: від цього залежить спосіб читання таблиці.

Увімкніть розгортання вкладених об’єктів, щоб назви їхніх властивостей стали заголовками, з’єднаними крапками. Масиви не розгортаються в кілька рядків; перевірте такі клітинки окремо, якщо потрібно аналізувати кожен елемент масиву.

Відкрийте інструмент
CovertonПеретворіть JSON на JSONL
Відкрийте інструмент

Цей посібник описує загальнодоступний інструмент, що працює в браузері. Збережіть копію оригіналу та перевірте результат перед поширенням.

Цей переклад було підготовлено за допомогою програмного забезпечення. Ви також можете прочитати англійську версію. Читайте англійською