Créer ma première variable
Qu'est-ce qu'une variable ?
Une variable représente une donnée collectée ou calculée au sein de la plateforme. Elle est toujours associée à un équipement et permet de stocker les valeurs remontées par vos capteurs ou systèmes.
Il existe deux types de variables :
- Variable classique : Reçoit directement les données envoyées par un équipement
- Variable calculée : Génère des données à partir de formules appliquées sur d'autres variables
Une variable peut être liée à un service ou non. Si une variable est créée à partir d'un service, on dit qu'elle est une instance de ce service. Pour ce guide de démarrage, nous nous concentrons sur la création de variables simples.
Créer une variable
Après avoir sélectionné votre équipement dans le module Administration, un bouton "Ajouter une variable" est disponible sur le côté gauche.
Champs obligatoires
Pour créer une variable, les champs suivants sont requis :
- Item : Catégorie de regroupement de la variable (correspond au champ "Item" dans l'interface)
- Identifiant : Identifiant unique de la variable
- Type : Type de données (numérique, texte, etc.)
Nous vous recommandons de renseigner également le nom de la variable pour une meilleure lisibilité dans l'interface.
Une fois les champs remplis, cliquez sur Créer pour finaliser la création de votre variable.
Informations de la variable
Une fois créée, la variable est associée à :
- Un UUID : Identifiant unique universel
- Un MappingConfig DataHub : Format
itemType|itemIndex|serviceId(exemple dans la vidéo :Global|0|variable_test)
Le MappingConfig DataHub est essentiel pour le ciblage de la variable lors de l'envoi de données vers la plateforme.
Pour aller plus loin : Exemple de transmission de données
