Вивчайте Основи JSON | Типи Даних у n8n

Визначення

JSON — це структурований, універсальний формат даних, який надає робочим процесам передбачуваний спосіб представлення значень і об'єктів. Він забезпечує узгодженість даних у HTTP-запитах, вебхуках, API та вихідних даних вузлів, що спрощує інструментам зчитування, порівняння та трансформацію інформації без помилок.

JSON по суті є шаблоном, де одні й ті ж поля завжди з'являються на тих самих місцях. Майже все в n8n базується на двох основних структурах: Об'єкти та Масиви. Дані передаються між вузлами у вигляді масиву елементів, де кожен елемент містить об'єкт $json. Коли структура послідовна, робочі процеси виконуються безперебійно; якщо ні — вузли починають працювати некоректно.

Об'єкт із іменованими полями

customer.json

Фігурні дужки { } позначають об'єкт — структурований запис, що складається з пар ключ–значення. Це можна уявити як один рядок електронної таблиці, де кожен заголовок стовпця (ключ) має відповідне значення в комірці.

Масив або список елементів

Список значень. Використовується, коли потрібні прості елементи у певному порядку:

customers.json

Список об'єктів. Використовується, коли кожен елемент має власні поля або атрибути:

products.json

Квадратні дужки [ ] позначають масив — впорядкований список елементів. Це можна уявити як декілька рядків електронної таблиці, кожен з яких містить подібно структуровані дані.

Примітка

Об'єкт представляє одну сутність, а масив — багато. Якщо переплутати дужки, парсер видасть помилку.

Це основні типи даних, з яких складається будь-яка структура JSON.

Більшість API-навантажень є просто комбінаціями цих базових елементів.

Як n8n фактично представляє JSON

У n8n кожен вузол виводить дані у послідовній структурі: масив елементів, де кожен елемент містить об'єкт $json. Ви можете переглядати та змінювати ці дані різними способами, але базова структура завжди залишається незмінною.

Кожен вузол виводить масив елементів, кожен з яких містить об'єкт $json;
Доступ до конкретних полів здійснюється за допомогою виразів, наприклад {{$json["customer"]["first_name"]}};

Перемикайтеся між переглядами Schema, Table та JSON — вони відображають ті самі дані по-різному;

Використовуйте Split Out / Item Lists для розбиття масивів на окремі елементи;
Використовуйте Aggregate / Item Lists для об'єднання кількох елементів назад у єдиний список для AI або пакетної обробки.

Все було зрозуміло?

Дякуємо за ваш відгук!

Секція 3. Розділ 2

Запитати АІ

Запитайте про що завгодно або спробуйте одне із запропонованих запитань, щоб почати наш чат

Suggested prompts:

Can you give me an example of a JSON object and array?

How do I know when to use an object versus an array in my data?

What are some common mistakes people make when working with JSON?

Awesome!

Completion rate improved to 4.17

Свайпніть щоб показати меню