В Нейро42 каждый узел способен обрабатывать несколько элементов данных (items) за одно выполнение.
Это означает, что если на вход узла попадает массив из N элементов, то узел выполнит свою логику N раз — по одному разу для каждого входного элемента.
Это фундаментальный принцип работы всей платформы: один элемент = одно выполнение узла.
Как узлы используют данные текущего элемента
Когда вы настраиваете параметры узла и обращаетесь к значениям из входных данных — например, используя выражения — Нейро42 автоматически подставляет значения из текущего обрабатываемого элемента, а не из всего набора.
Предположим, вы используете узел Trello для создания карточек и связываете поле Name с выражением, которое берет значение name-input-value из входящего массива.
Если входные данные выглядят так:
[
{
«name-input-value»: «test1»
},
{
«name-input-value»: «test2»
}
]
Тогда узел выполнится дважды:
- Для первого элемента — создаст карточку с названием test1
- Для второго элемента — создаст карточку с названием test2
Итог
- Узел получает массив элементов.
- Узел выполняется один раз для каждого элемента.
- Параметры, использующие выражения, всегда обращаются к данным текущего элемента.
- Это позволяет выполнять массовые операции (создание задач, отправка сообщений, генерация документов и т. д.) без построения циклов вручную.
В Нейро42 используется единый, стандартизированный формат данных, который гарантирует, что каждый узел сможет корректно обработать входящие элементы.
Однако данные, которые вы получаете из внешних API, вебхуков или других сервисов, могут иметь структуру, отличающуюся от того, что ожидает платформа. В таких случаях данные необходимо преобразовать, чтобы каждый элемент стал отдельной записью (item) и мог обрабатываться узлами по одному.
Почему нужно преобразование данных
Рассмотрим ситуацию:
Вы выполняете запрос через узел HTTP Request, и API возвращает большой объект или вложенный массив. Нейро42 отобразит это как один элемент, даже если внутри содержится множество записей.
Чтобы превратить такую структуру в набор отдельных элементов — необходимо выполнить преобразование.
Инструменты для преобразования данных
Нейро42 предоставляет набор специализированных узлов, которые помогают адаптировать любые данные под стандартную структуру платформы.
- Агрегирование — объединяет несколько элементов или выбранные части элементов в один элемент.
- Ограничение — отсекает все элементы, количество которых превышает заданный предел.
- Удаление дублей — ищет и удаляет элементы, полностью совпадающие — либо совпадающие только по выбранным полям.
- Сортировка — позволяет отсортировать список элементов по выбранному полю или получить случайную выборку.
- Разделение списка — преобразует один элемент, содержащий массив данных, в множество отдельных элементов. Это один из ключевых узлов, когда API возвращает список объектов, а Нейро42 видит только один item.
- Сводка — позволяет агрегировать элементы, создавая структуру наподобие сводных таблиц Excel (pivot tables).
Преобразование данных требуется, если:
- API возвращает вложенные массивы
- в одном элементе содержится несколько записей
- данные должны быть разнесены в отдельные элементы перед отправкой в сервисы (CRM, таблицы, мессенджеры и т. д.)
- необходимо объединить, отсортировать или очистить набор данных