Основы работы с набором данных

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

Структура данных в N8N

Первое, что нужно понимать: данные в N8N представлены в виде массива объектов. Мы можем создавать такие структуры с помощью элемента Edit Fields. Например, создадим два ключа на уровне данных:

  • Первый ключ — это тест;
  • Второй ключ — H, со значением.

Каждый ключ содержит определённое значение: один — строку, другой — число. С помощью Edit Fields можно добавлять дополнительные данные и формировать набор, который будет использоваться далее. На выходе формируется массив объектов с ключами тест и H.

Применение фильтров

Далее попробуем использовать элемент Filter. Он позволяет отфильтровать данные, которые поступают в систему. Если перетянуть ключ тест в обработку и задать условие, отобразится надпись $JSON, а затем — ключ, к которому хотим обратиться.

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

Важность видимости ключа JSON

Ключ JSON по умолчанию скрыт для упрощения отображения, но он присутствует в структуре данных. Хотя это позволяет уменьшить объём отображаемых данных, иногда отсутствие этого ключа может вызвать путаницу. На практике перед объектом всегда существует ключ JSON, к которому можно обратиться.

Таким образом, формируется массив объектов с ключом JSON, и данные передаются от одного элемента к другому. При использовании стандартных элементов инструментария всё работает корректно, однако при использовании элемента Code (для написания программного кода) важно помнить о существовании ключа JSON, с которым мы будем взаимодействовать в дальнейшем.