Cet article explique comment paramétrer des widgets pour appeler les données d'un ou plusieurs sites sur les périodes d'ouverture ou fermeture.
Principe de fonctionnement des formules
La fonction des calendrier de sites vous permet de définir des horaires d'ouverture et de fermeture pour vos sites. Une fois ces plages horaires définies, les fonctions OPEN & CLOSE vous permettront de filtrer l'appel de données dans les widgets, pour ne retenir dans les résultats que les données avec un timestamp correspondant à ces plages horaires.
Attention, seules les données de capteurs avec un pas de temps infra_journalier peuvent être prises en compte. Sur la plage horaire concernée, les données de la dernière heure sont bien prises en compte. Par exemple, pour un site ouvert de 9h à 17h, les données avec un timestamp à 17h sont bien incluses dans le calcul si on appelle les données de la période d'ouverture.
Ces deux fonctions (OPEN & CLOSE) ne peuvent être utilisées qu'en complément d'autres formules. Si vous les utilisez dans un widget, le pas de temps minimal d'agrégation sera journalier.
Filtrer ses données de capteur
Les fonctions OPEN & CLOSE ne peuvent être utilisées qu'avec les formules SENSOR BY LABEL, permettant d'appeler vos données de capteur à partir d'un label.
Exemple : j'ai des capteurs Enedis qui remontent la consommation de mon site toutes les 10 minutes. Grâce à la fonction OPEN, je pourrais appeler cette même donnée en ne gardant que la consommation enregistrée pendant les heures d'ouverture de mon site. La fonction CLOSe me permettra elle de visualiser la consommation enregistrée pendant les heures de fermeture du site.
Dans la formule de mon widget, je vais donc taper OPEN(+la formule SENSOR BY LABEL de mon choix) :
Ici ma formule OPEN(SUM_SENSOR_LABELS(conso-enedis)) appellera toutes les données associées au label "conso-enedis" en ne gardant que celles enregistrées sur les heures d'ouverture du site.
Si je veux appeler la moyenne de ma consommation en période de fermeture, je pourrais utiliser la formule :
CLOSE(AVERAGE_SENSOR_LABELS(conso-enedis))
La formule CLOSE(MAX_SENSOR_LABELS(conso-enedis)) me donnera la valeur maximale relevée entre tous les capteurs portant ce label pendant les heures de fermeture des sites.
Retrouvez toutes les formules SENSOR BY LABEL et leur fonctionnement dans cet article.
Ces fonctions sont bien disponibles en mono et multi-sites.
Comptabiliser les heures d'ouverture et fermeture
Vous avez également la possibilité de compter le nombre d'heure d'ouverture et de fermeture de vos sites.
Dans ce cas, les fonctions OPEN & CLOSE s'associeront à la fonction NB_HOUR.
NB_OPEN_HOUR donnera le nombre d'heures pendant lesquelles votre site était ouvert pendant la période observée par le widget.
NB_CLOSED_HOUR vous donnera le nombre d'heures pendant lesquelles votre site était fermé pendant la période observée par le widget.
La personnalisation des horaires personnalisés des sites ayant une granularité de 15 minutes, vous pourrez obtenir des résultats décimaux, prenant donc en compte le nombre de quarts d'heure sur les plages d'ouverture et de fermeture.