Aller au contenu
JelinaJelina DocumentationDocumentation technique
Retour au site officiel

Modèle de données et groupes

Edge-EMS Builder distingue quatre catégories de points et utilise dataKey pour relier acquisition, calcul, stratégie et partage. Les scripts métier n’ont pas à manipuler directement les registres des équipements.

Type Source Usages courants
Données brutes (Collection) Valeurs et états de communication acquis par CommBridge Tension, température, état d’équipement ; les points inscriptibles peuvent aussi servir au contrôle
Données agrégées (Aggregation) Expressions Lua ou valeurs d’exécution enregistrées Somme de puissances, évaluation d’état, variables d’exécution
Données par plage horaire (Customization) Configuration manuelle ou par stratégie avec période de validité Tarifs, modes de fonctionnement, courbes programmées
Données partagées (Share) Autres nœuds EMS Builder Calcul et contrôle entre nœuds

Un point partagé est adressé par le code de l’équipement source et dataKey. L’écriture de données brutes ou partagées dépend des droits et de la possibilité d’écrire sur l’équipement cible ; tous les points acquis ne sont pas des points de contrôle.

Les points portent un nom, un alias et une unité, synchronisés lors du partage. Les points bruts peuvent synchroniser le coefficient de lecture CommBridge ; les points sans coefficient et les points d’état peuvent renvoyer une valeur nulle.

La conversion inverse du coefficient lors d’une écriture d’acquisition est réalisée par CommBridge ; le script Edge-EMS Builder ou l’appelant ne doit pas la refaire. Valeurs lues et consignes envoyées doivent utiliser des unités d’ingénierie validées.

  • DAILY_CHANGE : chaque valeur est active sur un intervalle complet de date et heure.
  • DAILY_REPEAT : chaque valeur utilise une plage quotidienne ; une période globale de validité est définie dans la configuration.

Un tarif quotidien répété peut, par exemple, définir un prix de 08:00 à 12:00 et les dates d’application du programme. Avant de remplacer tout le programme, vérifiez les plages existantes et leurs chevauchements.

Un point agrégé peut être calculé par expression ou conserver et lire une valeur d’exécution avec useLatestValue. Une variable d’exécution peut recevoir une valeur initiale à sa création ; une génération via UDE peut aussi utiliser un modèle de valeur initiale.

Dans les formules, une donnée manquante est la chaîne __Null__. Utilisez tonumber pour les calculs numériques et traitez explicitement les absences afin de ne pas les assimiler à zéro. Consultez le moteur d’expressions pour les fonctions et exemples.

Les quatre catégories peuvent être intégrées à des groupes parents et enfants. Définissez l’ordre des sous-groupes et des points, modifiez les informations de base et choisissez le traitement des sous-groupes lors d’une suppression. Les requêtes et abonnements par groupe facilitent une interface organisée par équipement, zone ou usage.

Pour de nombreux équipements similaires, les modèles UDE génèrent automatiquement groupes et mappages.

Suite : Historique, Plans de déclenchement, Partage entre équipements, Lecture/écriture depuis l’interface.