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

## Conditions préalables

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

* Un rôle de **Propriétaire** dans votre compte Navixy
* des appareils activés dans votre compte
* une compréhension des sources de données que vous souhaitez traiter

{% hint style="info" %}
L'espace de travail IoT Logic est disponible uniquement pour les **propriétaires du compte** et n'est pas affiché pour les utilisateurs **standard**. 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 %}

## À 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 de démarrage 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écomposons maintenant, étape par étape, le processus de configuration de base du flux.

{% stepper %}
{% step %}

#### Ouvrez IoT Logic

Dans le menu principal, accédez à **IoT Logic**. La page de démarrage s'ouvre avec deux sections : **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éez 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="/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. Consultez [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 %}

#### **Configurez 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 **volet Nœuds** , faites glisser un **nœud Source de données** sur le canevas
2. Cliquez sur le nœud pour afficher les actions rapides, ou double-cliquez sur le nœud 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 %}

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

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

1. Faites glisser un **Initialiser l'attribut** sur le canevas
2. Ajoutez un nom descriptif
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')`).\
      Les noms d'attribut [peuvent être renseignés 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 **Appliquer les modifications** pour appliquer la configuration
7. Créez une connexion :
   1. Cliquez sur le connecteur de sortie du **nœud 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 Initialiser l'attribut](/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node.md).

Pour plus de détails sur les actions avec les attributs, consultez [Gestion des 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 %}

#### **Configurez la sortie des données**

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

1. Faites glisser un **Point de terminaison de sortie** 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 terminaison 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 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 obtenir 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. 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 terminaison par défaut** nœud Point de terminaison de sortie pour garantir l'envoi des données vers 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 Point de terminaison 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 le **volet 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 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 **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 tous les attributs calculés affichent les bonnes valeurs

Pour plus de détails sur l'utilisation de l'outil, consultez [l'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 Initialiser l'attribut](/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node.md)
* Mettre en place des [destinations de sortie](/docs/user/fr/guide/account/iot-logic/nodes/output-endpoint-node.md) supplémentaires 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 aux changements auxquels vous êtes confronté
* [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 qui ne sont pas 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 aucune configuration supplémentaire n'est nécessaire pour la transmission de données de base. Les flux personnalisés servent à aller au-delà de cette base — enrichir les données, appliquer une logique conditionnelle ou acheminer les données 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 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 des appareils qui lui sont attribué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é. Ne désactivez un flux que lorsque vous souhaitez délibérément arrêter complètement la transmission de données pour les appareils concernés.


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
