> 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/fr/guide/account/iot-logic/nodes/data-source-node.md).

# Source de données

Le nœud Source de données est le point d’entrée IoT Logic pour la télémétrie des appareils. Il reçoit les données via TCP, UDP, HTTP ou MQTT, les décode et les transmet aux nœuds en aval. Il peut également enrichir un appareil déjà connecté

## Vue d'ensemble technique et fonctionnalités

{% columns %}
{% column %}
**Source de données** Le nœud est un point d'entrée pour les données de télémétrie provenant de dispositifs IoT et de plateformes OEM dans le système IoT Logic. Il fonctionne comme un traducteur universel, recevant les données via les protocoles TCP/UDP/HTTP sur les interfaces réseau et via les files MQTT, puis décodant les flux de données entrants selon le protocole sélectionné. Le nœud transforme les messages des appareils en un format standardisé qui peut ensuite être traité dans votre flux.
{% endcolumn %}

{% column %}

<figure><img src="https://2196179364-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 %}

Outre la réception de la télémétrie, un **Source de données** nœud peut également enrichir un appareil que vous y avez déjà ajouté. Un système externe, tel qu'une plateforme télématique distincte qui n'envoie pas de données à Navixy par défaut, transmet des attributs supplémentaires au flux de l'appareil. Parfois, cette plateforme externe est celle du fabricant de l'appareil. Plutôt que de migrer l'appareil vers l'ingestion native de Navixy, le **Logiciel** onglet le conserve enregistré tel quel. Il enrichit en continu le flux de l'appareil avec des données de cette autre plateforme, de sorte que les deux flux fonctionnent en parallèle. Voir [Comment les données poussées sont gérées](#how-pushed-data-is-handled) pour le fonctionnement, et [Options de configuration](#configuration-options) pour le configurer.

### Intégration à l’architecture du flux

<figure><img src="https://2196179364-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>

**nœud Source de données du flux** sert de point d'entrée pour les données dans un flux IoT Logic. Un seul flux peut contenir plusieurs nœuds source, chacun avec sa configuration indépendante. Cette architecture permet�a0:

* Acquisition initiale des données à partir de plusieurs types d'appareils et formats de protocole
* Transformation standardisée des données de différents fabricants en formats unifiés
* Parcours de traitement parallèles en connectant une source de données à plusieurs nœuds en aval
* Filtrage sélectif des appareils pour n'inclure que les sources de données pertinentes dans votre flux
* Enrichissement du flux pour les appareils déjà connectés, à l'aide d'attributs transmis par un système externe via HTTP

### Fonctionnalités du nœud

Le bloc **nœud Source de données du flux** propose à lui seul�a0:

* **Diversité des protocoles**: Prise en charge de plusieurs fabricants d'appareils, notamment Teltonika, Queclink, Suntech, Jimi et d'autres, grâce aux analyseurs et décodeurs hérités de Navixy
* **Flexibilité du transport**: Prend en charge les protocoles TCP, UDP, HTTP et les connexions au broker MQTT
* **Transformation unifiée des données**: Convertit les messages propres à chaque appareil en un format standardisé pour un traitement cohérent
* **Filtrage des appareils**: Offre des capacités de filtrage pour sélectionner des modèles ou des protocoles spécifiques
* **Traitement en temps réel**: Gère en temps réel les flux de données de télémétrie entrants pour un traitement immédiat
* **Enrichissement par push HTTP**: Fusionne les attributs transmis par un système externe dans le flux d'un appareil déjà sélectionné dans ce nœud. HTTP est aujourd'hui le seul type de push pris en charge, avec une architecture conçue pour en prendre davantage à l'avenir

## Options de configuration

{% columns %}
{% column width="58.333333333333336%" valign="middle" %}
Configurer un **Source de données** Le nœud détermine quels appareils envoient des données dans votre flux et, éventuellement, comment un système externe peut enrichir ces appareils avec des données poussées.

La boîte de dialogue de configuration est organisée en deux onglets :

* **Traceurs**: sélectionne quels appareils envoient de la télémétrie dans le flux. Obligatoire, et fonctionne exactement comme avant.
* **Logiciel**: configure l'enrichissement par push HTTP pour les appareils que vous avez sélectionnés dans l'onglet Appareils. Facultatif, et dépend de cette sélection.
  {% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="https://2196179364-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" %}
Le bloc **Logiciel** Cet onglet dépend de l’ **Traceurs** onglet Appareils. Son **Appareil source** sélecteur ne liste que les appareils déjà sélectionnés dans **Traceurs**, et n'affiche aucune donnée disponible tant que vous n'en sélectionnez pas au moins un là-bas.
{% endhint %}

Voyons quels éléments ce nœud utilise et ce que vous pouvez configurer lorsque vous travaillez avec lui :

### Étapes de configuration

{% stepper %}
{% step %}

#### Spécifiez le nom du nœud

Saisissez un nom descriptif pour cette source de données�a0:

* Utilisez un nom qui vous aide à identifier le fabricant, les modèles ou toute autre information pertinente.
* Ce nom sera affiché dans le diagramme du flux pour une identification facile.
  {% endstep %}

{% step %}

#### Sélectionnez les sources

Dans la liste filtrée, sélectionnez les appareils à inclure. Seuls les appareils enregistrés dans votre compte utilisateur Navixy sont disponibles à la sélection. Cette sélection est également la condition préalable à l’onglet facultatif **Logiciel** qui ne peut associer que les appareils sélectionnés ici.
{% endstep %}

{% step %}

#### Enregistrez la configuration du nœud

Cliquez sur **Appliquer les modifications** pour terminer la création du nœud.
{% endstep %}

{% step %}

#### Configurez l'enrichissement par push HTTP (facultatif)

Passez à l’ **Logiciel** onglet pour enrichir les appareils que vous avez sélectionnés dans Appareils avec des données poussées depuis un système externe. Cette étape est facultative. Voir [Configuration de l'enrichissement par push HTTP](#configuring-http-push-enrichment) pour la configuration complète.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Si vous modifiez les paramètres du fabricant ou du modèle après avoir sélectionné des appareils, Navixy vous signale si certains appareils sélectionnés ne correspondent pas aux nouveaux paramètres, mais ne les supprime pas automatiquement de votre sélection.
{% endhint %}

### Configuration de l'enrichissement par push HTTP

L'enrichissement par push HTTP permet à un système externe d'ajouter des attributs à un appareil déjà sélectionné dans l'onglet de ce nœud **Traceurs** en envoyant des données vers une URL générée. C'est facultatif, et nécessite qu'au moins un appareil soit sélectionné dans [Étapes de configuration](#configuration-steps) d'abord.

C’est utile lorsqu’un appareil communique déjà avec un autre système qui n'envoie pas de données à Navixy par défaut, par exemple une plateforme de gestion de batterie qui suit le niveau de la batterie du même véhicule. Au lieu de migrer l’appareil vers l’ingestion native de Navixy, vous pouvez le conserver enregistré tel quel et faire en sorte que l’autre plateforme transmette ses relevés ici. Un envoi avec `vehicle_id: "truck_12"`, `bms_battery_soc: 76`, et `bms_battery_temp: 34.2` ajoute `bms_battery_soc` et `bms_battery_temp` en tant que nouveaux attributs sur l'appareil mappé, en plus de sa télémétrie GPS native.

{% stepper %}
{% step %}

#### Définissez le type de connecteur

Passez à l’ **Logiciel** onglet et définissez **Type de connecteur** à **HTTP**, actuellement la seule option.
{% endstep %}

{% step %}

#### Enregistrez le flux et copiez l'URL générée

Enregistrez l'intégralité du flux, pas seulement ce nœud. Le **URL** le champ ne génère une valeur qu’une fois le flux enregistré avec **Type de connecteur** défini. Jusque-là, il affiche un espace réservé vous invitant à enregistrer le flux. Une fois l’URL affichée, cliquez sur l’icône de copie à côté, désactivée uniquement lorsque le champ est vide.
{% endstep %}

{% step %}

#### Authentifiez le système externe

Fournissez au système externe un [clé API Navixy](https://navixy.com/docs/user/fr/guide/account/api-keys.md), et configurez-le pour envoyer `Authorization: NVX <api_key>` avec chaque requête push, en plus de l’URL. Un push sans cet en-tête échoue, donc l’URL et l’en-tête sont tous deux requis avant que les données puissent arriver.
{% endstep %}

{% step %}

#### Définissez la clé primaire et les correspondances

Saisissez un **Clé primaire**: le nom du champ que le système externe utilise pour identifier à quel appareil appartient un enregistrement envoyé. Il accepte jusqu'à 64 caractères, uniquement des lettres, des chiffres et des tirets bas.

Ajoutez-en un **Correspondances** ligne par appareil à enrichir. Pour chaque ligne, sélectionnez le **Appareil source**, limité aux appareils déjà sélectionnés dans Appareils, et saisissez le **Valeur de clé** qui identifie cet appareil dans les envois entrants. Ce champ peut stocker jusqu'à 255 caractères, mais le point de terminaison push lui-même n'accepte que jusqu'à 100 caractères par champ, donc gardez la valeur bien en dessous de 100 caractères en pratique.

{% hint style="warning" %}
La clé primaire et la valeur de clé n'acceptent que des lettres, des chiffres et des tirets bas, pas de tirets ni d'autres signes de ponctuation. La validation générale des champs du point de terminaison push est plus permissive et accepte les tirets dans n'importe quel champ sans اعتراض, mais une valeur avec des tirets ne peut jamais correspondre à une valeur de clé stockée, de sorte que les pushes qui en utilisent une sont rejetés silencieusement exactement comme si la valeur ne correspondait pas. Si les identifiants de votre système externe utilisent des tirets (par exemple `truck-12`), traduisez-les, par exemple en `truck_12`, avant de pousser.
{% endhint %}
{% endstep %}

{% step %}

#### Appliquer et enregistrer

Cliquez sur **Appliquer les modifications**, puis enregistrez de nouveau le flux si vous avez configuré l’onglet Software après l’enregistrement initial.
{% endstep %}
{% endstepper %}

### Spécificités du traitement des données

**Nœud Source de données** hérite de tous les analyseurs et décodeurs de Navixy, offrant une compatibilité avec un large éventail d’appareils IoT. Lorsque les données arrivent à ce nœud, elles suivent le processus suivant :

1. Le flux de données entrant est reçu via le protocole de transport spécifié
2. Les données sont transmises au décodeur de protocole approprié en fonction de votre configuration
3. Les messages de l’appareil sont transformés en un format standardisé qu’IoT Logic peut traiter
4. Les données unifiées sont transmises au nœud suivant de votre flux

Ce processus de normalisation vous permet de mettre en place des flux de traitement cohérents, quel que soit le format de données d’origine des différents fabricants d’appareils.

### Comment les données poussées sont gérées

Navixy compare chaque push entrant par la valeur de sa clé primaire à la configuration du Nœud **Correspondances**, puis fusionne les champs restants dans le flux de données de l’appareil mappé sous forme d’attributs : nouveaux si le nom du champ est nouveau, ou inscrits dans l’historique existant de cet attribut si le nom correspond à un nom déjà existant, qu’il soit signalé nativement par l’appareil ou envoyé par le connecteur d’un autre flux. Ils n’affectent ni la localisation ni les autres données de télémétrie. Le champ nommé dans **Clé primaire**, ainsi que `flux_id` et `identifiant_du_nœud`, est utilisé pour le routage et ne devient jamais lui-même un attribut. Une requête peut aboutir dans l’un des trois états�a0:

| Résultat                                                   | Réponse HTTP         | Données fusionnées ?                                                                                                                                    |
| ---------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La valeur de la clé primaire correspond à un mappage       | 200, `succès : true` | Oui. Les champs restants sont fusionnés en tant qu'attributs, nouveaux si le nom est nouveau, historique existant s'il correspond à un nom déjà utilisé |
| La valeur de la clé primaire ne correspond à aucun mappage | 200, `succès : true` | Non. Ignoré silencieusement                                                                                                                             |
| Manquant ou invalide `Authorization` en-tête               | erreur 400           | Non. Rejeté avant que Navixy ne vérifie la clé primaire                                                                                                 |

{% hint style="info" %}
Une réponse 200 confirme seulement que Navixy a accepté la requête, pas que les données ont été fusionnées. Une valeur de clé primaire non correspondante est ignorée silencieusement, sans erreur pour le signaler. Si vous n'êtes pas sûr qu'un envoi a été apparié, vérifiez les attributs de l'appareil mappé dans [Analyseur de données](https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md) plutôt que de vous fier à la réponse.
{% endhint %}

{% hint style="warning" %}
Le nom d'un champ envoyé partage le même espace de noms que les attributs natifs de l'appareil, ainsi que les noms envoyés par le connecteur d'un autre flux enrichissant le même appareil. Si le nom correspond à un nom déjà utilisé, qu'il soit natif à l'appareil ou envoyé par un autre flux, l'envoi écrase l'historique existant de cet attribut au lieu d'en créer un distinct.

Les capteurs, les Rapports et les Règles d’alertes lisent la valeur fusionnée comme une mesure réelle, de sorte qu'un nom en conflit peut produire de fausses données en aval. Par exemple, un champ envoyé nommé `niveau_carburant` qui correspond à l'attribut natif Carburant d'un appareil injecterait une mesure fausse, produisant de faux événements de baisse de carburant ou de ravitaillement dans les Rapports.

Pour éviter cela, préfixez les noms des champs envoyés afin qu'ils n'entrent pas en conflit avec les attributs natifs d'un appareil ou avec les noms envoyés par un autre flux, par exemple `bms_battery_soc` au lieu de `battery_soc`.

Les champs de message système tels que `vitesse`, `latitude`, `longitude`, `cap`, `satellites`, et `hdop` ne peuvent pas être écrasés de cette manière. Les envois ne créent ni ne mettent à jour que des attributs, jamais de télémétrie au niveau du message. Un champ envoyé utilisant l'un de ces noms apparaît toujours sous ce nom dans [Analyseur de données](https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md), séparément de la véritable télémétrie de l'appareil.
{% endhint %}

Un attribut fusionné apparaît comme une entrée à un instant donné dans l'historique des attributs de l'appareil, et non comme une valeur courante persistante. Si l'appareil remonte sa propre télémétrie beaucoup plus souvent que le système externe n'envoie des mises à jour, les paquets de l'appareil peuvent faire avancer l'historique de l'attribut au-delà de la valeur envoyée en quelques secondes, même si la fusion a réussi.

{% hint style="info" %}
C'est une conséquence attendue de deux flux de données fonctionnant à des vitesses différentes, et non un défaut. Référencez l'attribut en aval comme `value('attribute_name', 0, 'valid')` plutôt que par son nom brut. `'valide'` parcourt l'historique de l'attribut jusqu'à la dernière lecture non nulle, de sorte que les nœuds en aval reçoivent la valeur envoyée quelle que soit la synchronisation. Voir [Valeurs manquantes et routage de null](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing) pour savoir comment `'valide'` se compare à `'tous'` dans une condition du nœud Logic.
{% endhint %}

Le point de terminaison d'envoi accepte jusqu'à 1 requête par seconde et par clé API, avec une taille de rafale de 1. Cadencez les requêtes du système externe en conséquence.

## Questions fréquemment posées

#### Puis-je utiliser plusieurs nœuds Source de données dans un flux ?

Oui, vous pouvez en utiliser plusieurs **Nœuds Source de données** dans un même espace de travail. Cela est utile lorsque vous devez traiter des données provenant de différents types d'appareils de différentes manières ou lorsque vous souhaitez fusionner plusieurs flux de données après des transformations spécifiques.

#### Que se passe-t-il si un appareil est déjà utilisé dans un autre flux ?

Un appareil peut appartenir à plusieurs flux en même temps. Si vous ajoutez un appareil déjà utilisé dans un autre flux, les deux flux traitent ses données simultanément et les résultats sont fusionnés pour éviter toute perte de données. Le fait d'être affecté à un autre flux n'est pas une restriction. En revanche, si les connecteurs de deux flux envoient le même nom d'attribut à cet appareil, ils ne se fusionnent pas sans risque. L'historique de l'un des envois écrase celui de l'autre. Voir [Comment les données poussées sont gérées](#how-pushed-data-is-handled) pour éviter les noms en conflit.

#### Tous mes appareils Navixy sont-ils automatiquement disponibles dans IoT Logic ?

Oui, tous les appareils de votre compte utilisateur Navixy peuvent être utilisés dans le traitement IoT Logic. Cela inclut les appareils GPS, les plateformes OEM, les appareils et passerelles MQTT, ainsi que les connecteurs MQTT/Kafka. Un appareil déjà sélectionné dans un **Source de données** nœud peut également être enrichi avec des attributs envoyés depuis un système externe via HTTP, via l’onglet du nœud **Logiciel** onglet.

#### Comment savoir quel fabricant sélectionner pour mes appareils ?

Le protocole doit correspondre au protocole de communication utilisé par le fabricant de votre appareil. La plupart des appareils utilisent un protocole associé à leur fabricant (par exemple, les appareils Teltonika utilisent le protocole Teltonika). Consultez la documentation de votre appareil ou contactez votre fournisseur d'appareil si vous n'êtes pas sûr.

#### Puis-je connecter un nœud Source de données à plusieurs nœuds en aval ?

Oui, vous pouvez connecter un **nœud Source de données du flux** à plusieurs nœuds de traitement pour créer des chemins de traitement parallèles. Cela vous permet d'appliquer différentes transformations au même flux de données. Voici un exemple :

<figure><img src="https://2196179364-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>

#### Puis-je importer des données d'un système qui n'est pas un appareil Navixy ?

Oui, via le **Logiciel** onglet, mais uniquement pour enrichir un appareil que vous avez déjà ajouté dans le **Traceurs** onglet. Ce n'est pas un moyen de créer un flux sans appareils.

#### Le système depuis lequel j'envoie remonte moins souvent que mon appareil, les données envoyées seront-elles perdues ?

Non, mais un attribut envoyé peut cesser d'être la valeur courante rapidement si l'appareil remonte beaucoup plus souvent, car les deux contributeurs partagent le même historique glissant. Référencez l'attribut en aval comme `value('attribute_name', 0, 'valid')` au lieu de son nom brut afin d’obtenir de manière fiable la dernière lecture réelle, quel que soit le moment. C’est une conséquence attendue de deux flux exécutés à des vitesses différentes, et non un défaut. Voir [Comment les données poussées sont gérées](#how-pushed-data-is-handled) et [Valeurs manquantes et routage de null](https://navixy.com/docs/user/fr/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing) pour la `'valide'` contre `'tous'` la distinction dans une condition de Nœud Logic.

#### J’ai poussé des données, mais elles n’apparaissent pas, qu’est-ce qui ne va pas ?

Vérifiez-les dans l’ordre :

1. Confirmez que la requête incluait un `Authorization: NVX <api_key>` en-tête valide. Un en-tête manquant ou invalide provoque une erreur HTTP 400 explicite.
2. Confirmez que le nom du champ poussé correspond exactement au **Clé primaire** paramètre du Nœud, et que sa valeur correspond exactement à l’un des **Correspondances** paramètres configurés, avec uniquement des lettres, des chiffres et des traits de soulignement. Une valeur contenant des traits d’union est la cause la plus fréquente : elle passe la validation propre au point de terminaison de push sans erreur, mais ne peut jamais correspondre à une valeur Key stockée, donc la requête renvoie quand même un succès alors que rien ne se fusionne.
3. Vérifiez l’historique de l’attribut dans l’Analyseur de données, pas seulement sa valeur actuelle. Un appareil qui remonte sa propre télémétrie peut souvent faire sortir une valeur fusionnée de l’emplacement actuel en quelques secondes, même si la fusion a réussi.

#### J’ai poussé un champ et les propres relevés de l’appareil semblent incorrects

Le nom du champ poussé correspondait probablement à un attribut natif que l’appareil remonte déjà, ou à un attribut poussé par le connecteur d’un autre flux, et a écrasé son historique au lieu de créer un attribut distinct. Renommez le champ poussé avec un préfixe distinct, puis vérifiez l’historique de l’attribut dans [Analyseur de données](https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md) afin de confirmer que les valeurs poussées et natives ne sont plus mélangées.


---

# 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/fr/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.
