Nœud Initier Attribut

Aperçu technique et capacités

Dans IoT Logic, Initiate Attribute le nœud transforme les relevés de l’appareil en créant de nouveaux attributs de données basés sur la télémétrie entrante. Ce nœud vous permet de manipuler les données via des formules mathématiques, renommer des paramètres existants et effectuer des opérations au niveau des bits en utilisant le Navixy Expression Language. Le nœud sert de composant clé dans un flux, vous permettant d’enrichir les données avant de les envoyer vers vos systèmes cibles.

Initiate Attribute Le nœud est configuré pour chaque flux dans l’interface de la plateforme Navixy. Pour les options de syntaxe spécifiques et la référence détaillée du langage d’expression, voir Navixy Expression Language dans la documentation utilisateur.

Intégration à l’architecture de flux

Initiate Attribute Le nœud fonctionne au sein de l’architecture de flux en fournissant des capacités de transformation de données et en permettant :

• Le traitement des données télémétriques brutes en indicateurs métiers significatifs

• La création de champs calculés basés sur plusieurs valeurs de paramètres

• La conversion d’unités de mesure (p. ex., kilomètres en miles)

• Le calcul des différences entre les relevés actuels et précédents

• La génération d’analyses temporelles sur le comportement des appareils

Le nœud Initiate attribute requiert au moins un Data Source connecté à lui. Aucune opération de calcul ne sera effectuée sans connexions de données en entrée.

Capacités du nœud

Le Initiate Attribute nœud, en lui-même, offre :

• Transformation d’attributs de données: Créez des attributs entièrement nouveaux en appliquant des opérations mathématiques aux paramètres provenant des sources de données

• Conversion d’unités: Convertissez les unités de mesure (p. ex., vitesse de km/h à mph, ou température de °C à °F)

• Calculs basés sur le temps: Comparez les relevés actuels avec les valeurs précédentes pour déterminer les changements

• Manipulation du temps: Personnalisez les horodatages pour le moment où l’attribut a été généré sur un appareil et celui où il a été reçu par le serveur afin d’éviter les incohérences de chronologie et d’unifier les formats temporels

Options de configuration

Initiate Attribute Le nœud vous permet de définir comment les paramètres de l’appareil sont transformés en attributs, lesquels seront disponibles pour un traitement ultérieur dans votre flux de données.

Voyons quels éléments ce nœud utilise et ce que vous pouvez configurer lors de son utilisation :

Étapes de configuration

1

Spécifier Nom du nœud

Saisissez un nom descriptif pour mettre en évidence l’objectif du nœud. Utilisez un nom qui vous aide à identifier les calculs qui seront effectués dans ce nœud ; il sera affiché dans le diagramme de flux pour une identification facile.

2

Activer Spécifier les attributs temporels

si vous devez manipuler les horodatages des événements, cela active deux options supplémentaires :

• Heure de génération: Moment où les données ont été créées (par défaut : now())

• Heure serveur: Moment où les données ont été reçues par IoT Logic (par défaut : now())

3

Définir Nom de l’attribut

Ajoutez un identifiant distinctif de l’attribut.

• Ce nom sera affiché dans Data Stream Analyzer,

• Vous pouvez également utiliser ce nom pour créer des capteurs personnalisés dans le module Tracking Pour ce faire, le Initiate Attribute nœud contenant cet attribut doit être connecté au Default Output Endpoint nœud.

4

Définir Formule

Ajoutez des expressions mathématiques pour calculer les valeurs des attributs.

• Utilisez le value('parameter_name' 0, 'valid') format pour référencer les paramètres d’appareil existants. Remarque. Cliquez dans le Formule champ pour ouvrir la liste des attributs disponibles et sélectionnez celui dont vous avez besoin. Il sera ajouté automatiquement au champ dans le format prêt à l’emploi. Pour des détails sur le remplissage automatique des noms d’attributs, voir Autofill attribute names.

• Appliquez des opérations mathématiques basées sur Navixy IoT Logic Expression Language pour transformer les valeurs.

• Utilisez différentes valeurs d’index de profondeur pour accéder aux valeurs historiques (la valeur par défaut est 0).

5

(optionnel) Cliquez Add Attribute

Ouvrez une nouvelle boîte de configuration d’attribut. Ici vous pouvez créer un nouvel attribut de données si vous avez besoin que plusieurs calculs soient effectués au sein du même nœud.

Voyons un exemple pratique de configuration d’attributs :

Dans cet exemple, nous créons un attribut qui convertit la vitesse de kilomètres en miles par heure en divisant le paramètre de vitesse CAN par 1,609.

Pour des détails sur les calculs pour les nouveaux attributs, voir Exemples de calculs.

Vous trouverez également un exemple détaillé d’utilisation des attributs calculés dans un flux dans Exemple de configuration de flux → étapes 3 et 4.

Options d’affichage

Les nouveaux attributs calculés au sein du Initiate Attribute nœud peuvent être surveillés comme les attributs de données réels provenant des appareils dans Data Stream Analyzer (DSA) et le module Tracking module.

Pour plus d’informations sur les options d’affichage, voir Afficher les nouveaux attributs calculés sur la plateforme Navixy.

Considérations sur le flux de données

Après avoir configuré votre Initiate Attribute nœud, assurez-vous de :

1. Connecter le nœud à au moins un Data Source nœud en tant qu’entrée

2. Connecter la sortie à un Output Endpoint nœud pour envoyer les données transformées

À l’intérieur du Initiate Attribute nœud, les valeurs des paramètres sont traitées selon vos expressions à chaque fois que l’appareil fournit des données. En sortie, vous recevrez :

• Tous les paramètres d’appareil originaux

• Tous les attributs calculés avec leurs valeurs

• Valeurs mises à jour de l’heure de génération et de l’heure serveur conformément à la configuration

Si vous utilisez le même nom pour un attribut calculé qu’un paramètre existant, l’attribut remplacera le paramètre original dans le paquet de données de sortie.

Questions fréquemment posées

Puis-je référencer des valeurs non les plus récentes dans mes calculs ?

Oui. Utilisez le paramètre d’index dans la fonction value pour accéder aux valeurs historiques. Par exemple, value('temperature', 1, 'valid') se réfère à la valeur valide précédente du paramètre de température.

Comment effectuer des calculs impliquant le temps ?

Utilisez les fonctions genTime() et srvTime() pour travailler avec les horodatages. Vous pouvez calculer des différences de temps, ajouter des décalages temporels ou formater des horodatages pour l’affichage.

Que se passe-t-il si je supprime un attribut ?

L’attribut ne sera plus calculé pour les nouvelles données reçues, mais les données historiques restent inchangées. L’attribut n’apparaîtra dans aucun nouveau paquet de données après sa suppression.

Puis-je utiliser des attributs créés dans un nœud Initiate attribute dans un autre ?

Oui. Les attributs créés auparavant dans le flux peuvent être référencés dans des Initiate Attribute nœuds ultérieurs, permettant des calculs en plusieurs étapes. Tous les attributs créés sont également disponibles via la fonctionnalité autofill feature pour garantir la bonne dénomination.

Comment éviter les fautes de frappe lors de la référence aux noms d’attributs dans les formules ?

Utilisez la fonctionnalité de remplissage automatique dans le champ Formula pour sélectionner parmi les attributs disponibles. Pour des instructions détaillées, voir Autofill attribute names.