> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/data-source-node.md).

# Источник данных

Узел «Источник данных» — это точка входа IoT Logic для телеметрии устройств. Он принимает данные по TCP, UDP, HTTP или MQTT, декодирует их и передает последующим узлам. Он также может обогащать уже подключенное

## Технический обзор и возможности

{% columns %}
{% column %}
**Источник данных** Узел является точкой входа для телеметрических данных от IoT-устройств и OEM-платформ в системе IoT Logic. Он выступает в роли универсального преобразователя: принимает данные по протоколам TCP/UDP/HTTP через сетевые интерфейсы и через очереди MQTT, а затем декодирует входящие потоки данных в соответствии с выбранным протоколом. Узел преобразует сообщения устройства в стандартизированный формат, который можно дополнительно обработать в вашем потоке.
{% endcolumn %}

{% column %}

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-af4d64e959feca51b9e4010f02f38e78e4ed22c8%2Fiot-logic-data-source-tile.png?alt=media" alt="Data source node in the flow workspace"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Помимо приема телеметрии, узел также может **Источник данных** обогащать устройство, которое вы уже добавили в него. Внешняя система, например отдельная телематическая платформа, которая по умолчанию не отправляет данные в Navixy, передает дополнительные атрибуты в поток устройства. Иногда такой внешней платформой является собственная платформа производителя устройства. Вместо переноса устройства на нативный прием данных Navixy, **Программное обеспечение** вкладка сохраняет его зарегистрированным как есть. Она постоянно обогащает поток устройства данными из той другой платформы, поэтому оба потока работают параллельно. См. [Как обрабатываются переданные данные](#how-pushed-data-is-handled) о механизме, и [Параметры конфигурации](#configuration-options) чтобы настроить его.

### Интеграция с архитектурой потока

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-2155447864f99240b12cd2f10618cb92cbff488e%2Fiot-logic-data-source-in-flow.png?alt=media" alt="Data source node included in a flow on workspace"><figcaption></figcaption></figure>

**узле «Источник данных»** является точкой входа для данных в потоке IoT Logic. Один поток может содержать несколько узлов-источников с независимыми настройками. Эта архитектура обеспечивает:

* Первичный прием данных от нескольких типов устройств и форматов протоколов
* Стандартизированное преобразование данных от разных производителей в единые форматы
* Параллельные пути обработки за счет подключения одного источника данных к нескольким последующим узлам
* Избирательную фильтрацию устройств, чтобы включать в ваш поток только релевантные источники данных
* Обогащение потока для уже подключенных устройств с использованием атрибутов, передаваемых внешней системой по HTTP

### Возможности узла

Этот **узле «Источник данных»** сам по себе предоставляет:

* **Разнообразие протоколов**: Поддерживает несколько производителей устройств, включая Teltonika, Queclink, Suntech, Jimi и других, с помощью унаследованных парсеров и декодеров Navixy
* **Гибкость транспорта**: Поддерживает протоколы TCP, UDP, HTTP и подключения к MQTT-брокеру
* **Единообразное преобразование данных**: Преобразует сообщения, специфичные для устройства, в стандартизированный формат для последовательной обработки
* **Фильтрация устройств**: Предоставляет возможности фильтрации для выбора определенных моделей или протоколов
* **Обработка в реальном времени**: Обрабатывает входящие потоки телеметрических данных в реальном времени, обеспечивая немедленную обработку
* **Обогащение через HTTP push**: Объединяет атрибуты, передаваемые внешней системой, с потоком устройства, уже выбранного в этом узле. На данный момент поддерживается только HTTP push, а архитектура рассчитана на дальнейшее расширение в будущем

## Параметры конфигурации

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}
Настройка узла **Источник данных** Узел определяет, какие устройства отправляют данные в ваш поток и, при необходимости, как внешняя система может обогащать эти устройства передаваемыми данными.

Диалог настройки разделен на две вкладки:

* **Устройства**: выбирает, какие устройства отправляют телеметрию в поток. Обязательно и работает точно так же, как раньше.
* **Программное обеспечение**: настраивает обогащение через HTTP push для устройств, выбранных вами на вкладке Устройства. Необязательно и зависит от этого выбора.
  {% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3ee99992528681bd753f09ca94f203bd655000c1%2FData_source_node_edit%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Этот **Программное обеспечение** Эта вкладка зависит от **Устройства** вкладки. Ее **Исходное устройство** селектор показывает только устройства, уже выбранные в **Устройства**, и не показывает данные, пока вы не выберете там хотя бы одно.
{% endhint %}

Давайте посмотрим, какие элементы использует этот узел и что можно настраивать при работе с ним:

### Этапы настройки

{% stepper %}
{% step %}

#### Укажите имя узла

Введите описательное имя для этого источника данных:

* Используйте название, которое поможет вам определить производителя, модели или другую важную информацию.
* Это имя будет отображаться на схеме потока для удобной идентификации.
  {% endstep %}

{% step %}

#### Выберите источники

Из отфильтрованного списка выберите устройства, которые нужно включить. Для выбора доступны только устройства, зарегистрированные в вашей учетной записи Navixy. Этот выбор также является предварительным условием для необязательной **Программное обеспечение** вкладки, которая может сопоставлять только устройства, выбранные здесь.
{% endstep %}

{% step %}

#### Сохраните конфигурацию узла

Нажмите **Примените изменения** чтобы завершить создание узла.
{% endstep %}

{% step %}

#### Настройте обогащение через HTTP push (необязательно)

Переключитесь на **Программное обеспечение** вкладку, чтобы обогащать устройства, выбранные на вкладке Устройства, данными, передаваемыми из внешней системы. Этот шаг необязателен. См. [Настройка обогащения через HTTP push](#configuring-http-push-enrichment) для полной настройки.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Если вы измените настройки производителя или модели после выбора устройств, Navixy уведомит вас, если какие-либо выбранные устройства не соответствуют новым параметрам, но не удалит их из вашего выбора автоматически.
{% endhint %}

### Настройка обогащения через HTTP push

Обогащение через HTTP push позволяет внешней системе добавлять атрибуты к устройству, уже выбранному на **Устройства** вкладке этого узла, передавая данные по сгенерированному URL. Это необязательно и требует, чтобы было выбрано как минимум одно устройство в [Этапы настройки](#configuration-steps) сначала.

Это полезно, когда устройство уже передает данные в отдельную систему, которая по умолчанию не передает их в Navixy, например в платформу управления батареями, отслеживающую заряд батареи того же транспортного средства. Вместо переноса устройства на нативный прием данных Navixy вы можете оставить его зарегистрированным как есть и позволить этой другой платформе передавать сюда свои показания. Пуш с `vehicle_id: "truck_12"`, `bms_battery_soc: 76`, и `bms_battery_temp: 34.2` добавляет `bms_battery_soc` и `bms_battery_temp` в качестве новых атрибутов на сопоставленном устройстве, наряду с его штатной GPS-телеметрией.

{% stepper %}
{% step %}

#### Установите тип разъема

Переключитесь на **Программное обеспечение** вкладку и задайте **Тип разъема** в **HTTP**, пока это единственный вариант.
{% endstep %}

{% step %}

#### Сохраните поток и скопируйте сгенерированный URL

Сохраните весь поток, а не только этот Узел. Это **URL** Поле начинает генерировать значение только после сохранения потока с установленным значением. **Тип разъема** установлено. До этого отображается заполнитель с подсказкой сохранить поток. Когда URL появится, нажмите значок копирования рядом с ним; он неактивен только пока поле пусто.
{% endstep %}

{% step %}

#### Аутентифицируйте внешнюю систему

Передайте внешней системе действительный [ключ API Navixy](https://navixy.com/docs/user/ru/guide/account/api-keys.md), и настройте её на отправку `Authorization: NVX <api_key>` с каждым push-запросом вместе с URL. Push-запрос без этого заголовка завершается ошибкой, поэтому до получения данных необходимы и URL, и заголовок.
{% endstep %}

{% step %}

#### Задайте первичный ключ и сопоставления

Введите  **Первичный ключ**: имя поля, которое внешняя система использует для определения, какому устройству принадлежит переданная запись. Оно допускает не более 64 символов и только буквы, цифры и символы подчёркивания.

Добавьте одну **Сопоставления** строку на устройство для обогащения. Для каждой строки выберите **Исходное устройство**, ограниченный устройствами, уже выбранными в разделе Devices, и введите **Значение ключа** которое идентифицирует это устройство во входящих push-запросах. Это поле хранит до 255 символов, но сама конечная точка push принимает не более 100 символов на поле, поэтому на практике держите значение заметно меньше 100 символов.

{% hint style="warning" %}
И Primary key, и Key value принимают только буквы, цифры и символы подчёркивания — без дефисов и другой пунктуации. Общая проверка полей на конечной точке push более либеральна и принимает дефисы в любом поле без возражений, но значение с дефисом никогда не совпадёт с сохранённым значением Key value, поэтому push-операции с таким значением незаметно отбрасываются точно так же, как если бы значение не совпало. Если идентификаторы вашей внешней системы используют дефисы (например `грузовик-12`), переведите их, например, в `truck_12`, перед отправкой.
{% endhint %}
{% endstep %}

{% step %}

#### Применить и сохранить

Нажмите **Примените изменения**, затем сохраните поток снова, если вы настроили вкладку Software после первоначального сохранения.
{% endstep %}
{% endstepper %}

### Особенности обработки данных

**Узел-источник данных** наследует все парсеры и декодеры Navixy, обеспечивая совместимость с широким спектром IoT-устройств. Когда данные поступают в этот узел, они проходят следующий процесс:

1. Входящий поток данных принимается через указанный транспортный протокол
2. Данные передаются в соответствующий декодер протокола в соответствии с вашей конфигурацией
3. Сообщения устройства преобразуются в стандартизированный формат, который может обрабатывать IoT Logic
4. Объединенные данные передаются в следующий узел вашего потока

Этот процесс стандартизации позволяет вам выстраивать единообразные потоки обработки независимо от исходного формата данных от различных производителей устройств.

### Как обрабатываются переданные данные

Navixy сопоставляет каждое входящее push-уведомление по значению первичного ключа с настройкой узла **Сопоставления**, затем объединяет остальные поля в поток данных сопоставленного устройства в виде атрибутов: новые — если имя поля новое, либо записывает их в существующую историю этого атрибута, если имя совпадает с уже существующим, независимо от того, было ли оно нативно передано устройством или отправлено коннектором другого потока. Они не влияют на местоположение или другие телеметрические данные. Поле, указанное в **Первичный ключ**, а также `поток_id` и `ID узла`, используется для маршрутизации и никогда не становится атрибутом само по себе. Запрос может оказаться в одном из трёх состояний:

| Результат                                                          | HTTP-ответ         | Данные объединены?                                                                                                               |
| ------------------------------------------------------------------ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| Значение первичного ключа соответствует сопоставлению              | 200, `успех: true` | Да. Остальные поля объединяются в атрибуты: новые — если имя новое, существующая история — если оно совпадает с уже используемым |
| Значение первичного ключа не соответствует ни одному сопоставлению | 200, `успех: true` | Нет. Отбрасывается без уведомления                                                                                               |
| Отсутствует или недействителен `Authorization` заголовок           | ошибка 400         | Нет. Отклоняется до проверки первичного ключа Navixy                                                                             |

{% hint style="info" %}
Ответ 200 лишь подтверждает, что Navixy приняла запрос, но не то, что данные были объединены. Несовпадающее значение первичного ключа отбрасывается без уведомления, без ошибки, которая бы указывала на это. Если вы не уверены, что отправка была сопоставлена, проверьте атрибуты сопоставленного устройства в [Анализ данных](https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md) вместо того чтобы полагаться на ответ.
{% endhint %}

{% hint style="warning" %}
У отправляемого поля одно пространство имен с собственными атрибутами устройства и с именами, отправленными коннектором другого потока, который обогащает то же устройство. Если имя совпадает с уже используемым — будь то собственное имя устройства или имя, отправленное другим потоком, — отправка перезаписывает существующую историю этого атрибута вместо создания отдельной.

Датчики, Отчеты и Контроль событий считывают объединенное значение как реальное показание, поэтому совпадающее имя может породить ложные данные далее по цепочке. Например, отправляемое поле с именем `уровень_топлива` которое совпадает с собственным атрибутом уровня топлива устройства, внесет ложное показание, создавая в отчетах ложные события падения уровня топлива или заправки.

Чтобы избежать этого, добавляйте префикс к именам отправляемых полей, чтобы они не могли совпасть с собственными атрибутами устройства или с именами, отправленными другим потоком, например `bms_battery_soc` вместо `battery_soc`.

Поля системного сообщения, такие как `скорость`, `широта`, `долгота`, `курс`, `спутники`, и `hdop` не могут быть перезаписаны таким способом. Отправки могут только создавать или обновлять атрибуты, но не телеметрию на уровне сообщения. Отправляемое поле с одним из этих имен по-прежнему отображается под этим именем в [Анализ данных](https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md)отдельно от реальной телеметрии устройства.
{% endhint %}

Объединенный атрибут попадает в историю атрибутов устройства как запись на конкретный момент времени, а не как постоянное текущее значение. Если устройство передает собственную телеметрию гораздо чаще, чем внешняя система отправляет обновления, собственные пакеты устройства могут за считанные секунды продвинуть историю атрибута дальше отправленного значения, даже если объединение прошло успешно.

{% hint style="info" %}
Это ожидаемое следствие того, что два потока данных работают с разной скоростью, а не дефект. Ссылайтесь на атрибут далее по цепочке как `value('attribute_name', 0, 'valid')` вместо его простого имени. `'действительный'` проходит назад по истории атрибута до последнего ненулевого значения, поэтому нижестоящие узлы получают отправленное значение независимо от времени. См. [Отсутствующие значения и маршрутизация null](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing) чтобы понять, как `'действительный'` сравнивается с `'все'` в условии узла Logic.
{% endhint %}

Конечная точка push принимает не более 1 запроса в секунду на каждый API-ключ, с размером всплеска 1. Планируйте запросы внешней системы соответствующим образом.

## Часто задаваемые вопросы

#### Можно ли использовать несколько узлов «Источник данных» в одном потоке?

Да, вы можете использовать несколько **узлов-источников данных** в одном рабочем пространстве. Это полезно, когда нужно обрабатывать данные от устройств разных типов по-разному или объединять несколько потоков данных после определенных преобразований.

#### Что произойдет, если устройство уже используется в другом потоке?

Устройство может одновременно принадлежать нескольким потокам. Если вы добавите устройство, которое уже используется в другом потоке, оба потока будут одновременно обрабатывать его данные, а результаты будут объединяться, чтобы избежать потери данных. Назначение другому потоку не является ограничением. Однако если коннекторы двух потоков отправляют на это устройство одно и то же имя атрибута, они не объединяются без последствий. История одной отправки перезаписывает историю другой. См. [Как обрабатываются переданные данные](#how-pushed-data-is-handled) чтобы избежать совпадающих имен.

#### Все ли мои устройства Navixy автоматически доступны в IoT Logic?

Да, все устройства из вашей учетной записи Navixy можно использовать в обработке IoT Logic. Это включает GPS-устройства, OEM-платформы, устройства и шлюзы MQTT, а также коннекторы MQTT/Kafka. Устройство, уже выбранное в **Источник данных** узле, также можно обогатить атрибутами, отправленными из внешней системы по HTTP, через **Программное обеспечение** .

#### Как мне понять, какого производителя выбрать для моих устройств?

Протокол должен соответствовать протоколу связи, который использует производитель вашего устройства. Большинство устройств используют протокол, связанный с их производителем (например, устройства Teltonika используют протокол Teltonika). Проверьте документацию к вашему устройству или обратитесь к поставщику, если вы не уверены.

#### Можно ли подключить узел «Источник данных» к нескольким downstream-узлам?

Да, вы можете подключить **узле «Источник данных»** его к нескольким узлам обработки, чтобы создать параллельные пути обработки. Это позволяет применять разные преобразования к одному и тому же потоку данных. Вот пример:

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-a6ac4747b6916ec883c48e98e40391c555552988%2Fiot-logic-data-source-multi-output.png?alt=media" alt="Example showing the Data source node in context with multiple outbound connections and outputs"><figcaption></figcaption></figure>

#### Можно ли получать данные из системы, которая не является устройством Navixy?

Да, через **Программное обеспечение** вкладку, но только для обогащения устройства, которое вы уже добавили в **Устройства** вкладку. Это не способ создать поток без устройств в нем.

#### Если система, из которой я отправляю данные, сообщает реже, чем мое устройство, потеряются ли отправленные данные?

Нет, но отправленный атрибут может быстро перестать быть текущим значением, если устройство сообщает гораздо чаще, поскольку оба источника используют одну и ту же скользящую историю. Ссылайтесь на атрибут далее по цепочке как `value('attribute_name', 0, 'valid')` вместо его простого имени, чтобы надежно получать последнее реальное значение независимо от времени. Это ожидаемое следствие того, что два потока работают с разной скоростью, а не дефект. См. [Как обрабатываются переданные данные](#how-pushed-data-is-handled) и [Отсутствующие значения и маршрутизация null](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing) для `'действительный'` vs `'все'` различие в условии логического узла.

#### Я отправил данные, но они не отображаются — что не так?

Проверьте это по порядку:

1. Убедитесь, что запрос содержал действительный `Authorization: NVX <api_key>` заголовок. Отсутствие или некорректный заголовок приводит к явной ошибке HTTP 400.
2. Убедитесь, что имя отправляемого поля точно совпадает с **Первичный ключ** настройкой узла в точности, а его значение совпадает с одним из заданных **Сопоставления** в точности и содержит только буквы, цифры и символы подчёркивания. Значение с дефисом — самая частая причина: оно проходит собственную проверку эндпоинта push без ошибки, но никогда не сможет совпасть с сохранённым значением Key, поэтому запрос всё равно возвращает успех, а ничего не объединяется.
3. Проверьте историю атрибута в Анализ данных, а не только его текущее значение. Устройство, которое передает собственную телеметрию, часто может за несколько секунд вытеснить объединённое значение из текущего слота, хотя объединение прошло успешно.

#### Я отправил поле, и собственные показания устройства выглядят неверными

Имя отправленного поля, вероятно, совпало с родным атрибутом, который устройство уже передает, или с атрибутом, отправленным коннектором другого потока, и перезаписало его историю вместо создания отдельного атрибута. Переименуйте отправленное поле, добавив уникальный префикс, затем проверьте историю атрибута в [Анализ данных](https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md) чтобы убедиться, что отправленные и собственные значения больше не смешиваются.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/data-source-node.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
