> 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/quick-start-guide.md).

# Guide de démarrage rapide

Configurez votre premier flux de données IoT Logic pour commencer à traiter les données télématiques. Requiert un Modèle d'accès Propriétaire et au moins un appareil activé dans votre compte Navixy.

Ce guide vous aide à configurer rapidement votre premier flux de données dans IoT Logic et à commencer à traiter vos données de télématique.

## Prérequis

Avant de continuer la création de votre premier flux, assurez-vous de disposer de :

* Un **Propriétaire** Modèle d’accès dans votre compte Navixy
* Appareils activés dans votre compte
* Compréhension des sources de données que vous souhaitez traiter

{% hint style="info" %}
L’espace de travail IoT Logic est disponible uniquement pour le compte **Propriétaires** et n’est pas affiché pour les utilisateurs standard **Utilisateurs**. Pour plus de détails sur les rôles utilisateur, voir [Droits d’accès](/docs/user/fr/guide/account/users-and-roles.md).
{% endhint %}

## À partir d’un modèle

Les modèles sont une alternative à la création manuelle d’un flux à partir de zéro. Chaque modèle est une structure de flux préconfigurée pour un scénario courant de traitement des données que vous pouvez sélectionner sur la page d’accueil d’IoT Logic et adapter à vos besoins. Pour plus de détails sur les modèles disponibles et leur utilisation, voir [Modèles](/docs/user/fr/guide/account/iot-logic/quick-start-guide/templates.md).

## Configuration du flux

Décortiquons maintenant le processus de configuration de base du flux, étape par étape.

{% stepper %}
{% step %}

### Ouvrez IoT Logic

Dans le menu principal, accédez à **IoT Logic**. La page d’accueil s’ouvre avec deux sections : **galerie des modèles de flux**, une galerie de structures de flux préconfigurées, et **Flux créés**, un tableau répertoriant tous les flux existants de votre compte.

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3d526f4774594125a65fa4fac2b94012de69e2bc%2Fiot-logic-start.png?alt=media" alt="IoT Logic start page showing Flow templates gallery and Created flows table"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Créer un nouveau flux

1. Cliquez sur **Créer un flux**. Dans la boîte de dialogue qui s’ouvre, saisissez un nom et une description pour votre flux et définissez son état d’activation.
2. Cliquez sur **Confirmer** pour ouvrir le canevas et commencer à construire le flux.

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3bb4a6bc33fd29a6ff2500ebcaa0f1ff887ef87e%2Fnew-flow.png?alt=media" alt="Create Flow dialog with name, description, and enabled state fields"><figcaption></figcaption></figure>

{% hint style="info" %}
Si vous préférez partir d’une structure préconfigurée, vous pouvez utiliser un modèle au lieu de créer un flux à partir de zéro. Les modèles sont des flux préconfigurés pour des scénarios courants de traitement des données. Voir [Modèles](/docs/user/fr/guide/account/iot-logic/quick-start-guide/templates.md) pour la liste complète et les instructions de configuration.
{% endhint %}
{% endstep %}

{% step %}

### Configurer un nœud Source de données

Cette étape définit quels appareils enverront leurs relevés à ce flux. Il est essentiel d’alimenter le pipeline avec des données réelles.

1. Depuis le **Nœuds** volet, qui regroupe les nœuds disponibles en **Commencez par**, **Traitement**, **Action** et **Terminez par** sections, faites glisser un **Source de données** nœud sur le canevas
2. Cliquez sur le nœud pour afficher les actions rapides, ou double-cliquez pour ouvrir immédiatement son panneau de configuration
3. Configurez les paramètres suivants :
   1. **Nom du nœud** : Saisissez un nom descriptif en précisant l’origine des données envoyées (par ex., *Véhicules du personnel*)
   2. **Sources** : Sélectionnez les appareils dont vous souhaitez envoyer les relevés à ce flux.
4. Cliquez sur **Appliquez les modifications** pour appliquer la configuration

{% hint style="info" %}
Pour plus de détails sur la configuration du nœud, voir [nœud Source de données](/docs/user/fr/guide/account/iot-logic/nodes/data-source-node.md).
{% endhint %}
{% endstep %}

{% step %}

### Ajouter l’enrichissement des données

À cette étape, configurez les calculs pour enrichir les données brutes ou même créer mathématiquement de nouveaux attributs de données.

1. Faites glisser un **Initialiser un Attribut** nœud sur le canevas
2. Cliquez sur le nœud pour afficher les actions rapides, ou double-cliquez sur le nœud pour ouvrir son panneau de configuration
3. Ajoutez un nom descriptif **Nom du nœud** pour préciser son objectif et les calculs qu’il effectue (par ex., *Température °F vers °C*)
4. Définissez votre attribut :
   1. **Nom de l’attribut** : Un nom clair et descriptif (par ex., « speed\_mph »)
   2. **Formule** : L’expression de calcul (par ex., `speed/1.609` pour convertir km/h en mph)\
      :bulb:**Remarque** : La syntaxe courte est l’option principale. Utilisez la syntaxe complète lorsque vous avez besoin de valeurs historiques/indexées ou de vérifications explicites de validité (par ex., `value('speed', 1, 'valid')`).\
      Noms d’attributs [peuvent être remplis automatiquement](/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) pour éviter les fautes de frappe.
5. Ajoutez des attributs supplémentaires si nécessaire en cliquant sur **Ajouter un attribut**. Pour supprimer un attribut, cliquez sur l’icône de suppression à côté de celui-ci.
6. Cliquez sur **Appliquez les modifications** pour appliquer la configuration
7. Créez une connexion :
   1. Cliquez sur le connecteur de sortie du **Source de données** Nœud
   2. Faites glisser la transition vers le connecteur d’entrée du **Initialiser un Attribut** Nœud

{% hint style="info" %}
Pour plus de détails sur la configuration du nœud, voir [Nœud Initialiser un Attribut](/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node.md).

Pour plus de détails sur les actions avec les attributs, voir [Gestion des attributs](/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md).

Pour des exemples de formules de calcul, voir [Exemples de calcul](/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).
{% endhint %}
{% endstep %}

{% step %}

### Configurer la sortie des données

Cette étape définit où les données sont envoyées depuis ce flux. Vous pouvez les diriger vers Navixy ou vers un système tiers via MQTT.

1. Faites glisser un **Point de sortie** nœud sur le canevas
2. Survolez le nœud avec la souris pour afficher les actions rapides, ou double-cliquez sur le nœud pour ouvrir son panneau de configuration
3. Sélectionnez le point de terminaison **Mode**:

* **Point de sortie par Défaut** : une sortie standard pour envoyer les données du flux à la plateforme Navixy. Elle est préconfigurée et ne peut pas être modifiée.
* **Point de sortie MQTT** : une sortie personnalisée pour envoyer les données du flux vers des destinations tierces via MQTT.

4. Configurez les paramètres spécifiques au préréglage. La sortie par défaut est préconfigurée ; pour obtenir des instructions sur la configuration et les paramètres des autres préréglages, voir [Configurations spécifiques au mode](/docs/user/fr/guide/account/iot-logic/nodes/output-endpoint-node.md#mode-specific-configurations).
5. Cliquez sur **Appliquez les modifications** pour appliquer la configuration
6. Connectez vos autres nœuds à celui-ci dans l’ordre requis pour finaliser la structure du flux

{% hint style="info" %}
Chaque flux doit inclure un **Point de sortie par Défaut** nœud pour garantir que les données soient envoyées à la plateforme. Sans cette connexion, les données des appareils ne sont pas visibles dans l’interface Navixy.

Pour plus de détails sur la configuration du nœud, voir [nœud Point de sortie](/docs/user/fr/guide/account/iot-logic/nodes/output-endpoint-node.md).
{% endhint %}
{% endstep %}

{% step %}

### Enregistrez et activez votre flux

1. Vérifiez que tous les nœuds sont correctement connectés dans votre flux
2. Cliquez sur le **Enregistrer le flux** bouton dans la **Nœuds** volet

{% hint style="success" %}
Votre flux est maintenant actif et traite les données en temps réel !
{% endhint %}
{% endstep %}
{% endstepper %}

## Validation du flux

La structure du flux et les formules sont validées automatiquement par IoT Logic, qui affiche des avertissements et des messages d’erreur si la configuration est incomplète ou incorrecte.

Pour confirmer que les données sont traitées correctement, utilisez le **Analyseur de données** outil :

1. Cliquez sur le **Analyseur de données** onglet en haut du canevas
2. Sélectionnez les appareils que vous souhaitez surveiller dans la liste déroulante
3. Observez les attributs des données entrantes et leurs valeurs
4. Utilisez les options de filtrage pour vous concentrer sur des paramètres spécifiques
5. Vérifiez que les attributs calculés affichent les valeurs correctes

Pour plus de détails sur l’utilisation de l’outil, voir [Analyseur de données](/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md).

{% hint style="success" %}
Félicitations ! Votre premier flux de données IoT Logic est opérationnel.
{% endhint %}

## Étapes suivantes

Après avoir créé votre premier flux IoT Logic, vous pouvez :

* Adapter cet exemple de démarrage rapide aux besoins de votre entreprise
* Créer des transformations de données plus complexes avec plusieurs [nœuds Initialiser un Attribut](/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node.md)
* Configurer d’autres [destinations de sortie](/docs/user/fr/guide/account/iot-logic/nodes/output-endpoint-node.md) pour vos données, qui peuvent devenir des profils réutilisables pour des configurations cohérentes
* [Gérer les flux déjà créés](/docs/user/fr/guide/account/iot-logic/flow-management.md) pour adapter le traitement des données à toute évolution que vous rencontrez
* [Concevoir des flux avancés](/docs/user/fr/guide/account/iot-logic/flow-management/flow-configuration-example.md) pour des scénarios métier spécifiques à l’aide de différentes combinaisons et configurations de nœuds

## Foire aux questions

### Que se passe-t-il pour les appareils non affectés à un flux personnalisé ?

Navixy garantit automatiquement, au niveau système, que leurs données atteignent la plateforme. Aucun flux personnalisé ni aucune configuration supplémentaire n’est nécessaire pour la transmission des données de base. Les flux personnalisés servent à aller au-delà de ce niveau de base, à enrichir les données, à appliquer une logique conditionnelle ou à les acheminer vers des systèmes externes.

### Puis-je utiliser le même appareil dans plusieurs flux ?

Oui. Un appareil peut appartenir à plusieurs flux en même temps. Tous les flux qui incluent l’appareil traitent ses données simultanément, et les résultats sont fusionnés pour éviter toute perte de données. Il n’existe aucune contrainte sur le nombre de flux auxquels un appareil peut appartenir.

### Mon flux continuera-t-il de fonctionner si je me déconnecte ?

Oui, une fois activés, les flux fonctionnent indépendamment de votre session utilisateur. Tant que le flux est activé, il traite les données même lorsque vous n’êtes pas connecté.

### Comment savoir si mon flux fonctionne correctement ?

Utilisez l’Analyseur de données pour surveiller la transmission des données en temps réel. Cet outil affiche à la fois les données brutes des appareils et les attributs calculés, vous permettant de vérifier que vos transformations fonctionnent comme prévu.

### Que se passe-t-il si je désactive un flux ?

Lorsque vous désactivez un flux, toute transmission de données pour les appareils qui lui sont affectés s’arrête, y compris l’envoi vers la plateforme Navixy. Les appareils ne sont plus visibles ni mis à jour dans l’interface jusqu’à ce que le flux soit réactivé. Ne désactivez un flux que lorsque vous souhaitez délibérément arrêter complètement la transmission des données pour les appareils concernés.


---

# 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/quick-start-guide.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.
