Mise à jour Energy Management Module (JOOL) 1.3.30
1. Changement de design pour la fiche information
Dans la continuité du nouveau layout de la dernière release, l’onglet “Structure” de la fiche d’information (fiche entité/compteur) a été rénové.
AVANT

APRÈS
- L’ en-tête a été réorganisée pour prendre moins de place tout en gardant visibles toutes les informations utiles.
- Les onglets ont un nouveau rendu visuel reprenant celui des onglets des tableaux de bord.
- Les cases de gauche (parents / enfants) anciennement séparées ont été fusionnées pour montrer le parent et les enfants en une fois.
- L’onglet “Canaux” n’est plus visibles pour les entités, mais uniquement pour les compteurs. Dans le cas où une entité aurait un canal configuré (erreur par le passé, qu’il faudrait nettoyer), l’onglet reste visible pour accéder au canal et en récupérer les infos nécessaires, mais le nom de l’onglet contient un symbole “warning” pour attirer l’attention sur cette erreur de configuration.
Quand on passe en mode édition, la fiche se modifie très légèrement.

- La section “Liens” se sépare en deux, une première partie pour les liens vers des extrémités N et une seconde partie pour les liens vers les extrémités 1.
Pour rappel, les liens ne sont pas symétriques (1:N) et l’ancienne disposition de la fiche rendait peu clair le sens des liens et il était très aléatoire d’en créer un à la main sans savoir réellement dans quel sens il allait être créé.
Cette nouvelle disposition a le mérite de séparer clairement les liens en fonction de leur sens.
- En cliquant sur le bouton “Ajouter un lien” de la section du haut (Liens vers extrémités N), on créera un lien où notre entité active sera du côté 1, et l’item que l’on va chercher pour le lier sera du côté N du lien... et le contraire pour la section du bas.
- Quand on clique sur ces liens “Ajouter un lien”, il est désormais possible de créer un objet à la volée pour le relier à notre item active. Pour cela, il faut cliquer sur le bouton “Ajouter un lien”, et un popup s’ouvrira.
L’option “Elément existant” ouvrira un popup permettant de rechercher un objet et de choisir le type de lien à créer.
L’option “Créer élément” va permettre de créer un nouvel objet à la volée et de le rattacher avec un lien du type choisi.
Cela permet entre autres de créer un nouveau compteur directement depuis la fiche de l’entité à laquelle il sera attaché (rappel: avant, il fallait créer un enfant à l’entité, couper son
lien de parenté puis recréer un lien logique ENTITY_METER).

2. Distinction des entités et des compteurs
a. Configuration des propriétés
Les entités et les compteurs ont été structurellement différenciés sur la plateforme.
Dans le configurateur, les propriétés sont associées soit aux entités soit aux compteurs. Il n’est plus possible de créer des blocs de propriétés qui seront attribués indistinctement à l’une ou l’autre de ces catégories.
Note: certains aniens blocs abonnés étant trop profondément configurés sur des items des deux catégories, ils resteront disponibles des deux côtés, mais ils représentent une exception historique.
b. Configuration des types d’éléments (entités/compteurs)
De la même manière, quand on va dans le configurateur, dans la gestion des types, on ne verra plus
que les propriétés définies pour des entités lors de la définitions d’un nouveau type d’entité. Il n’est
donc plus possible d’attacher un bloc de propriétés dédiées à des compteurs sur un type d’entités.
Dans l’exemple ci-dessous, on est dans la page de définition de types d’entités, désormais distincte
de cette qui définit les types de compteurs, et on ne voit plus ici que les blocs de propriétés dédiés
aux entités et plus les blocs de compteurs (et vice-versa donc).

c. Séparation dans les DataSets
Toujours dans le même ordre d’idées, les DataSets font désormais la différence proprement entre les entités et les compteurs, n’affichant plus pour la catégorie “Entités” que les objets ayant des types de cette catégorie “Entités”, et vice-versa pour les compteurs.

Sur l'image ci-dessus, on a choisi la catégorie “Entités” et on ne voit donc plus que les items de cette catégorie et plus les types de compteurs. Tout logiquement, les propriétés qui seront reprises dans ces répertoires seront uniquement celles associées aux types d’entités.
d. Révision de la définition des entités et des compteurs dans les DataSets
Enfin, étant donné que les objets sont désormais définis comme faisant partie de la catégorie des entités ou celle des compteurs via leur type qui est défini comme étant de l’une ou l’autre de ces catégories, c’est cette nouvelle définition qui est utilisée dans les DataSets quand on demande à lister les entités ou les compteurs.
Cette nouvelle définition remplace les précédentes qui, en plus de ne pas être mutuellement exclusives, empêchaient de récupérer certaines entités et compteurs qui ne remplissaient pas les critères demandés (compteurs sans canaux, ou entités sans compteurs attachés).
3. Amélioration du visuel de la définition des types de liens
Dans le configurateur, la page de définition des types de liens a été clarifiée pour permettre une meilleure compréhension du sens du lien que l’on est en train de créer.

A gauche, l’extrémité “1” du lien, et à droite son extrémité “N”. Chacune des extrémités peut recevoir un label (informatif), et une contrainte sur le type d’objet qui y sera lié. (liste de toutes les classes disponibles, ainsi que les catégories entités et compteurs pour permettre des liens un peu moins stricts sur leurs extrémités).
4. Nouvelle fonction JQL : .tonumeric
Une nouvelle fonction « .tonumeric » permet désormais de convertir de force un texte en la valeur
numérique équivalente.
Cette fonctionnalité va donc permettre de transformer le textstring « 123 » en la valeur numérique 123 permettant ainsi de l’utiliser dans une formule ultérieurement.
Cette fonction a été rendue nécessaire par le fait que les arguments « param » des DataSets, WorkSheets ou Widgets en JQL ne permettent que de contenir des textes. Passer une valeur numérique était alors impossible, tout utilisation ultérieure de la valeur du param se faisant en considérant que celui-ci était un texte. (et donc 123" + 5 = "1235")

- La fonction peut donc recevoir un paramètre optionnel indiquant ce qu’il faut considérer comme un séparateur décimal dans le texte à transformer.
- Elle peut fonctionner sur une liste de textes, renvoyant alors la liste des valeurs numériques correspondantes.
- Elle renverra une erreur si on lui demande de convertir quelques chose qui n’est pas composé exclusivement de nombres (et de séparateur décimal évidemment).
- Elle transformera un numérique en lui-même sans erreur.
- Elle transformera du vide en du vide, ne créant pas une valeur depuis le néant.