> 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

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

## Prérequis

Avant de procéder à la création de votre premier flux, assurez-vous de disposer de :

* Un **Propriétaire** rôle 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 standards **Utilisateurs**. Pour plus de détails sur les rôles d’utilisateur, consultez [Utilisateurs et rôles](/docs/user/fr/guide/account/users-and-roles.md).
{% endhint %}

## Commencer à partir d’un modèle

Les modèles constituent 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 sur leur utilisation, consultez [Modèles](/docs/user/fr/guide/account/iot-logic/quick-start-guide/templates.md).

## Configuration du flux

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

{% stepper %}
{% step %}

#### Ouvrir 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 dans votre compte.

<figure><img src="/files/d1d1fa4724bf66eda2c734afc7e338973185478a" 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, puis définissez son état d’activation.
2. Cliquez sur **Confirmer** pour ouvrir le canevas et commencer à créer le flux.

<figure><img src="/files/7622a2370b644323095bcb80e6ce9c39cbb3a218" 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 de fournir au pipeline des données réelles.

1. Depuis le **Nœuds** volet, 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 **Appliquer les modifications** pour appliquer la configuration

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

{% step %}

#### **Ajouter un enrichissement des données**

À cette étape, nous configurons les calculs pour enrichir les données brutes, ou même créer mathématiquement des attributs de données entièrement nouveaux.

1. Faites glisser un **Initialiser l'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. **champ 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')`).\
      Les noms d’attribut [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 **Ajouter un attribut**. Pour les supprimer, cliquez sur l’icône de suppression à côté.
6. Cliquez sur **Appliquer les modifications** pour appliquer la configuration
7. Créer 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 l'attribut** nœud

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

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

Pour des exemples de formules de calcul, consultez [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 seront 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 terminaison de sortie** nœud sur le canevas
2. Survolez le nœud avec votre souris pour afficher les actions rapides, ou double-cliquez sur le nœud pour ouvrir son panneau de configuration
3. Sélectionner le point de terminaison **Mode**:

* **Point de terminaison par défaut** - une sortie standard pour envoyer les données du flux vers la plateforme Navixy. Elle est préconfigurée et ne peut pas être modifiée.
* **Point de terminaison 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 des instructions sur la configuration et les paramètres des autres préréglages, consultez [Configurations spécifiques au mode](/docs/user/fr/guide/account/iot-logic/nodes/output-endpoint-node.md#mode-specific-configurations).
5. Cliquez sur **Appliquer les modifications** pour appliquer la configuration
6. Reliez 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 terminaison par défaut** nœud afin de garantir que les données soient envoyées à la plateforme. Sans cette connexion, les données des appareils ne seront pas visibles dans l’interface Navixy.

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

{% step %}

#### **Enregistrer et activer 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 désormais actif et traite les données en temps réel !
{% endhint %}
{% endstep %}
{% endstepper %}

## Validation du flux

La structure et les formules du flux 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 l’ **Analyseur de flux 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, consultez [Analyseur de flux 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

Maintenant que vous avez 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 Initiate Attribute](/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 à tout changement rencontré
* [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 en utilisant différentes combinaisons et configurations de nœuds

## Questions fréquentes

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

Navixy veille automatiquement à ce que leurs données atteignent la plateforme au niveau du système. Aucun flux personnalisé ni configuration supplémentaire n’est nécessaire pour la transmission de base des données. Les flux personnalisés servent à aller au-delà de cette 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 afin d’éviter toute perte de données. Il n’y a aucune contrainte quant au 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 traitera les données même lorsque vous n’êtes pas connecté.

#### Comment savoir si mon flux fonctionne correctement ?

Utilisez l’Analyseur de flux 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, ce qui vous permet 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 seront plus visibles ni mis à jour dans l’interface tant que le flux ne sera pas réactivé. Désactivez un flux uniquement 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/user/fr/guide/account/iot-logic/quick-start-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
