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 d'avoir :

• Un rôle 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

L'espace de travail IoT Logic est disponible uniquement pour les comptes Propriétaires et n'est pas affiché pour les Utilisateurs. Pour des détails sur les rôles des utilisateurs, voir Utilisateurs et rôles.

Configuration du flux

Regardez une courte vidéo qui présente le processus de création d'un nouveau flux avec des calculs d'attributs de données et l'ajout d'attributs personnalisés aux appareils sur la plateforme :

Processus de création d'un nouveau flux avec calculs d'attributs de données et ajout d'attributs personnalisés aux appareils sur la plateforme

Maintenant, décomposons le processus de configuration du flux étape par étape.

1

Étape 1 : Accéder à l'espace de travail IoT Logic

1. Connectez-vous à votre compte Navixy

2. Cliquez sur votre icône de profil dans le coin supérieur gauche de l'écran pour accéder à Paramètres du compte

3. Sélectionnez IoT Logic dans la barre latérale des paramètres

L'espace de travail IoT Logic apparaît avec trois sections principales :

• Barre de paramètres du flux - Contient les commandes pour gérer les flux

• Volet des nœuds - Énumère les nœuds disponibles pour construire votre flux

• Canvas - L'espace de travail principal où vous concevez votre flux

Pour des détails sur l'espace de travail, voir Espace de travail et flux par défaut.

2

Étape 2 : Créer un nouveau flux

1. Cliquez sur le Nouveau flux bouton dans la barre de paramètres du flux

2. Dans la Nouveau flux boîte de dialogue :

• Saisissez un nom descriptif pour votre flux (par exemple, "Fleet Telemetry Processing")

• Ajoutez une brève description expliquant l'objectif du flux

• Assurez-vous que le Flux activé le commutateur est activé

1. Cliquez sur Enregistrer pour créer le flux

Pour des informations supplémentaires sur la configuration du flux, voir Gestion des flux -> Création d'un nouveau flux.

Les flux désactivés ne traitent aucune donnée. Lorsqu'un flux est désactivé, les appareils de ce flux ne transmettront pas de données vers une destination, y compris la plateforme Navixy.

3

Étape 3 : Configurer un nœud Source de données

1. Depuis le Panneau des nœuds volet, faites glisser un Data Source nœud sur le canevas

2. Survolez le nœud avec la souris pour afficher des actions rapides, ou double-cliquez sur le nœud pour ouvrir son panneau de configuration

3. Configurez les paramètres suivants :

• Nom du nœud - Saisissez un nom descriptif, en précisant l'origine des données envoyées (par exemple, Véhicules du personnel)

• Sources - Sélectionnez les appareils dont vous souhaitez envoyer les relevés vers ce flux. Vous pouvez filtrer vos appareils disponibles par Fabricant et Modèle.

1. Cliquez sur Enregistrer pour appliquer la configuration

Pour des détails sur la configuration du nœud, voir Nœud Source de données.

4

Étape 4 : Ajouter un enrichissement de données (Facultatif)

1. Faites glisser un Initiate Attribute nœud sur le canevas

2. Survolez le nœud avec la souris pour afficher des actions rapides, ou double-cliquez sur le nœud pour ouvrir son panneau de configuration

3. Ajoutez un Nom du nœud descriptif pour préciser son objectif et les calculs qu'il effectue (par ex. Température °F en °C)

4. Définissez votre attribut :

   1. Apportez les modifications nécessaires dans les champs de texte des propriétés de l'attribut : - Un nom clair et descriptif (par exemple, "speed_mph")

   2. Champ Formula - L'expression de calcul (par ex., value('speed')/1.609 pour convertir km/h en mph) 💡Remarque : Les noms d'attributs peuvent être remplis automatiquement pour garantir une dénomination correcte. Le remplissage automatique utilise la syntaxe courte par défaut, qui adresse la dernière valeur de l'attribut.

   3. Temps de génération - Quand l'entrée de données a été créée sur l'appareil (par défaut : now())

   4. Temps serveur - Quand les données ont été reçues par le serveur (par défaut : now())

5. Ajoutez des attributs supplémentaires si nécessaire en cliquant sur Ajouter un attribut 💡Remarque : Le Bouton Réinitialiser le formulaire annule tous les attributs créés au sein d'un nœud. Si vous souhaitez supprimer un attribut spécifique, cliquez sur les trois points à droite de la ligne de l'attribut et sélectionnez Cliquez sur le menu apparu et sélectionnez.

6. Cliquez sur Enregistrer pour appliquer la configuration

7. Créer une connexion :

   1. Cliquez sur le connecteur de sortie du Data Source nœud

   2. Faites glisser la transition jusqu'au connecteur d'entrée du Initiate Attribute nœud

Pour des détails sur la configuration des nœuds, voir Nœud Initier Attribut.

Pour des détails sur les actions avec les attributs, voir Gestion des attributs.

Pour des formules de calcul d'exemple, voir Pour d'autres exemples de formules, voir.

5

Étape 5 : Configurer la sortie des données

1. Faites glisser un Output Endpoint nœud sur le canevas

2. Survolez le nœud avec la souris pour afficher des actions rapides, ou double-cliquez sur le nœud pour ouvrir son panneau de configuration

3. Sélectionnez Type de point de terminaison:

• Point de terminaison Navixy - point de terminaison par défaut pour l'envoi des données traitées vers la plateforme Navixy. Il est préconfiguré et ne permet aucune modification

• Point de terminaison MQTT - point de terminaison pour l'envoi des données vers des destinations tierces, utilisant MQTT comme protocole de transport. Nécessite une configuration manuelle décrite dans les étapes suivantes

Les points de terminaison créés au sein du compte sont disponibles en tant que Préréglages. Vous pouvez sélectionner une configuration déjà existante au lieu de la configurer depuis zéro. Point de sortie Navixy est toujours disponible en tant que préréglage.

1. Configurez les paramètres suivants :

   1. Nom du point de terminaison - Saisissez un nom descriptif pour préciser la destination vers laquelle les données sont envoyées

   2. Protocole - Sélectionnez le protocole de données (seul « Navixy Generic Protocol (JSON)" est disponible pour le moment)

   3. IP/Domaine - Saisissez l'adresse de destination

   4. Port - Spécifiez le numéro de port (par défaut : 1883 pour MQTT standard, 8883 pour SSL)

   5. (facultatif) Activer SSL - Activez pour des connexions sécurisées

   6. Version MQTT - Sélectionnez la version appropriée (3.1.1 ou 5.0)

   7. ID client - Saisissez l'identifiant pour votre client afin de garantir que les données sont acceptées par le destinataire

   8. (facultatif) Sujets - Spécifiez les sujets MQTT pour la transmission des données

   9. QoS - Sélectionnez le niveau de Quality of Service pour déterminer la logique de transmission des données (0, 1, ou 2)

2. Si une authentification est requise côté destinataire, activez Authentification MQTT ON Les champs affichés sont préremplis automatiquement avec les identifiants de votre compte plateforme

Le Bouton Réinitialiser le formulaire annule tous les attributs créés au sein d'un nœud. Si vous souhaitez supprimer un attribut spécifique, cliquez sur les trois points à droite de la ligne de l'attribut et sélectionnez Cliquez sur le menu apparu et sélectionnez.

1. Cliquez sur Créer des pour appliquer la configuration

2. Connectez vos autres nœuds à ce nœud de sortie dans l'ordre nécessaire pour finaliser la structure du flux

Chaque flux doit inclure un Default Endpoint nœud pour garantir que les données sont envoyées à la plateforme. Sans cette connexion, les données des appareils ne seront pas visibles dans l'interface Navixy.

Pour des détails sur la configuration des nœuds, voir Nœud Point de terminaison de sortie.

6

Étape 6 : 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 Panneau des nœuds volet

Votre flux est maintenant actif et traite les données en temps réel !

Validation du flux

Pour confirmer que votre flux fonctionne correctement, utilisez l'outil Data Stream Analyzer :

1. Cliquez sur le Analyseur de données bouton dans la barre de paramètres du flux

2. Sélectionnez les appareils que vous souhaitez surveiller dans la liste déroulante

3. Observez les attributs de données entrants 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 valeurs correctes

Pour des détails sur l'utilisation de l'outil, voir Data Stream Analyzer.

Félicitations ! Votre premier flux de données IoT Logic est opérationnel.

Étapes suivantes

Maintenant que vous avez créé votre premier flux IoT Logic, vous pouvez :

• Adapter cet exemple de démarrage rapide à vos besoins métier

• Créer des transformations de données plus complexes avec plusieurs Initialiser des nœuds d'attributs

• Configurer des destinations de sortie 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 pour ajuster le traitement des données à tout changement auquel vous êtes confronté

• Concevoir des flux avancés pour des scénarios métier spécifiques en utilisant différentes combinaisons et configurations de nœuds

Adapter cet exemple

Cet exemple peut être adapté à divers cas d'utilisation industriels en modifiant :

• Sélection des appareils : Choisissez les appareils pertinents pour vos actifs spécifiques

• Conversions d’unités : Ajustez les formules en fonction de vos unités de mesure standard

• Métriques calculées : Créez des indicateurs spécifiques à votre secteur en fonction de vos besoins métier

• Configuration de la sortie : Connectez-vous à votre plateforme d'analyse ou base de données spécifique

Le schéma fondamental de collecte, transformation et transfert reste cohérent entre les industries, faisant de cet exemple un modèle polyvalent pour le traitement des données IoT.

Accès API

La fonctionnalité IoT Logic peut également être accessible de manière programmatique via l'API Navixy. Cela permet aux développeurs d'automatiser la création, la gestion et la surveillance des flux.

Pour des raisons de sécurité, l'accès à l'API nécessite des autorisations appropriées. Contactez l'administrateur de votre compte pour vous assurer que vous disposez des droits d'accès nécessaires.

Pour la documentation complète de l'API, les paramètres, les formats de requête/réponse et des exemples de code, référez-vous à la Documentation de l'API Navixy IoT Logic.

Questions fréquemment posées

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

Les appareils non attribués explicitement à un flux personnalisé sont automatiquement gérés par le flux par défaut, qui envoie leurs données directement à la plateforme Navixy.

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

Non, chaque appareil ne peut être affecté qu'à un seul flux à la fois. Lorsqu'il est ajouté à un flux personnalisé, un appareil est automatiquement retiré du flux par défaut pour éviter le traitement en double des données.

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 le Data Stream Analyzer 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, les appareils affectés à ce flux ne transmettront pas de données vers une destination, y compris la plateforme Navixy. Les appareils apparaîtront hors ligne dans l'interface Navixy jusqu'à ce que vous réactiviez le flux.