Documents – Sirea Docs

SmartEMS : Flexibilité

Dernière modification le 15/01/2026 10:50

Table des matières

1. Lecteurs ciblés
2. Introduction
2. Variables disponibles en lecture
3. Variables disponibles en écriture

1. Lecteurs ciblés

Cette documentation est à destination des opérateurs de flexibilité ayant pour mission d’opérer une installation de production ou de gestion d’énergie pilotée par un gestionnaire d’énergie SIREA déléguée dans le cadre d’un contrat d’agrégation.

2. Introduction

Ce document décrit le rôle et les méthodes d’utilisation des variables de lecture et d’écriture permettant la supervision et le pilotage d’un produit équipé d’un EMS développé par SIREA.

L’accès en lecture et en écritures des variables présentées ci-dessous est strictement réservé opérateurs autorisés par SIREA, dans un cadre sécurisé et contractualisé.

2. Variables disponibles en lecture

2.1. Données du site

Les variables suivantes permettent d’obtenir des informations sur les caractéristiques techniques du site.

Variable	Type	Description	Unité	État
`Pinstall`	INT	Puissance crête photovoltaïque installée	kWc	Disponible
`Psousc`	INT	Puissance souscrite auprès du fournisseur d’électricité	VA	Disponible

2.2. Données de puissance

Les variables suivantes permettent d’obtenir les différentes puissances mesurées et collectées par le système en temps réel. Les données étant historisées, il est possible de visualiser l’historique des puissances collectées.

Variable	Type	Description	Unité	État
`R_P_GenTot`	FLOAT	Puissance de production photovoltaïque réelle.	W	Disponible
`R_P_ConsoTot`	FLOAT	Puissance de la consommation totale du site	W	Disponible
`R_P_Res`	FLOAT	Puissance soutirée ou injectée sur le réseau	W Positif = Soutirage Négatif = Injection	Disponible

2.3. Données d’énergie

Les variables suivantes permettent d’obtenir l’historique des énergies calculées sur la période souhaitée.

Variable	Type	Description	État
`R_EaImpBrute_GenTot`	FLOAT	Énergie photovoltaïque réellement produite.	Disponible
`R_EaImp_Autoconso`	FLOAT	Énergie photovoltaïque autoconsommée directement	Disponible
`R_EaImpBrute_Res`	FLOAT	Énergie soutirée au réseau	Disponible
`R_EaExpBrute_Res`	FLOAT	Énergie injectée au réseau	Disponible
`R_EaImpBrute_ConsoTot`	FLOAT	Énergie totale consommée	Disponible

2.4. Informations liées à la batterie

La délégation à un opérateur externe d’une batterie SIREA ne peut se faire que dans un cadre sécurisé et contractualisé. Pour savoir si l’actif est disponible, il convient de vérifier les données en puissance et en énergie disponibles dans la batterie pour s’assurer de la quantité d’énergie nécessaire pour le besoin.

Variable	Type	Description	Unité	État
`RM_SOC`	INT	État de charge de la batterie	%	Disponible
`RM_SOH`	INT	État de santé de la batterie	%	Disponible
`RM_Pbatt`	FLOAT	Puissance de la batterie	W Positif = Charge Négatif = Décharge	Disponible
`RM_EposBatt`	FLOAT	Énergie chargée en batterie (toutes sources)	kWh	Disponible
`RM_EnegBatt`	FLOAT	Énergie déchargée de la batterie (toutes directions)	kWh	Disponible
`R_Nb_cycles`	INT	Nombre de cycles équivalents réalisés par le système batterie	–	Indisponible
`R_Capacite`	INT	Capacité moyenne du module batterie (prise en compte du SOH)	Ah	Indisponible
`WC_NbEltBatt`	INT	Nombre de modules batteries présents dans le système	–	Disponible
`RC_UbatNominale`	INT	Tension nominale d’un module batterie	V	Disponible
`RC_CapaEltBat`	INT	Capacité nominale d’un module batterie	Ah	Disponible

2.5. Données utiles pour le pilotage

Variable	Type	Description	Unité	État
`PuissanceDispoCharge`	FLOAT	Puissance disponible en temps réel par la batterie en charge	W	Indisponible
`PuissanceDispoDecharge`	FLOAT	Puissance disponible en temps réel par la batterie en décharge	W	Indisponible
`EnergieDispoCharge`	FLOAT	Énergie disponible en temps réel par la batterie en charge	kWh	Indisponible
`EnergieDispoDecharge`	FLOAT	Énergie disponible en temps réel par la batterie en décharge	kWh	Indisponible

Description : Variable dynamique calculée en temps réel, tenant compte de :

IMD (courant max de décharge).
IMR (courant max de charge).
SOC (état de charge).
Température de la batterie.
Dédauts (batterie/onduleur).
SOC min et SOC max.

2.6. Données des batteries détaillées par BMS

Pour plus de détail et d’informations sur le système batterie, de nombreuses données sont disponibles en lecture par BMS. Les variables portent à la fin _BX avec X le numéro du BMS dans le système.

Variable	Type	Description	Unité	État
`B_DefCom_BX`	BOOL	Défaut de communication avec le BMS X	–	Disponible
`B_Defaut_BX`	BOOL	Défaut sur le BMS X	–	Disponible
`W_Ibatt_BX`	FLOAT	Courant dans le BMS X	A	Disponible
`W_BattTemp_BX`	FLOAT	Température maximale des batteries du BMS X	°C	Disponible
`W_Tmin_BX`	FLOAT	Température minimale des batteries du BMS X	°C	Disponible
`W_Pbatt_BX`	FLOAT	Puissance dans le BMS X	W	Disponible
`W_SOC_BX`	FLOAT	État de charge des batteries du BMS X	%	Disponible
`W_SOH_BX`	FLOAT	État de santé des batteries du BMS X	%	Disponible
`W_Ubatt_BX`	FLOAT	Tension des batteries du BMS X	V	Disponible
`W_VcellMax_BX`	FLOAT	Tension cellule maximale des batteries dans le BMS X	mV	Disponible
`W_VcellMin_BX`	FLOAT	Tension cellule minimale des batteries dans le BMS X	mV	Disponible
`W_IMD_BX`	FLOAT	Courant maximal autorisé en décharge par le BMS X	A	Disponible
`W_IMR_BX`	FLOAT	Courant maximal autorisé en charge par le BMS X	A	Disponible

3. Variables disponibles en écriture

3.1. Consignes générales sur le pilotage du site

Variable	Type	Description	Unité	État
`ActivationZeroInjection`	BOOL	Activer le bridage automatique de la puissance PV de sorte éviter l’injection d’énergie au réseau. (0 = désactivé / 1 = activé)	–	Disponible
`WC_TauxLimitationPuissanceSouscrite`	INT	Taux de sécurité de limitation de puissance souscrite à ne pas dépasser	%	Disponible
`WC_SOCmin`	INT	Limite de SOC en décharge de la batterie	%	Disponible
`WC_SOCmax`	INT	Limite de SOC en charge de la batterie.	%	Disponible

3.2. Reset des batteries en cas de défaut

En cas de défaut, il peut être utile de faire un reset sur les batteries afin d’acquitter le défaut.

Variable	Type	Description	Unité	État
`B_ResetBMS`	BOOL	Permet de réaliser un reset sur l’ensemble des BMS du système (0 = désactivé / 1 = activé)	–	Disponible
`B_ResetRequest_BX`	BOOL	Permet de réaliser un reset uniquement sur le BMS X du système (0 = désactivé / 1 = activé)	–	Disponible

3.3. Utilisation des batteries en mode forcé

Ce mode peut être utilisé si vous souhaitez prendre la main sur le système batterie en indiquant une consigne en puissance. Attention, le système répondra par une puissance selon la demande tout en regardant l’état du shelter et la disponibilité des batteries. Il est évident que vous ne pouvez pas demander une puissance de consigne supérieure à la puissance disponible en temps réel sur les batteries (en charge ou en décharge). Auquel cas, la consigne ne sera pas honorée. Il est important que vous contrôliez ces variables de puissance et énergie disponible en charge et décharge avant de demander une consigne. Pour utiliser ce mode, il suffit de passer la variable ForceChargeDechargeBattDistance à 1 et d’indiquer la consigne en puissance souhaitée en W dans la variable ForcePuissanceChargeDechargeAC.

Variable	Type	Description	Unité	État
`ForceChargeDechargeBattDistance`	BOOL	Active la consigne de forçage de la puissance de la batterie (0 = désactivé / 1 = activé)	–	Disponible
`ForcePuissanceChargeDechargeAC`	INT	Consigne en puissance demandée en mode forcée en DC	W (Positif = charge / Négatif = décharge)	Disponible

# Forcer une décharge de 50 kW

ForceChargeDechargeBattDistance = 1
ForcePuissanceChargeDechargeAC = -50000

3.4. Utilisation des batteries en mode programmée

Ce mode peut être utilisé si vous souhaitez programmer sur la batterie des charges ou des décharges. Le principe est le même en charge ou en décharge mais les variables sont différentes. Dans le cas de la charge, il faut activer ce mode avec la variable EnableChargeProgrammee, saisir l’heure de début de la charge programmée dans HeureChargeProgrammeeStart et l’heure de fin dans HeureChargeProgrammeeStop, saisir également le SOC souhaité à atteindre SOC_CHARGE_PROGRAMMEE. Vous pouvez également choisir de limiter la puissance max de la charge programmée avec la variable WC_PmaxChargeProgrammee. Si ce n’est pas le cas, vous pouvez laisser la variable à 0.

Attention
Éviter les chevauchements entre les programmations de charge. Il est possible que le SOC désiré ne soit pas atteint sur la période programmée si la limite de puissance ou la durée de charge n’est pas suffisante.

Cas de la charge

Variable	Type	Description	Unité	État
`EnableChargeProgrammee`	BOOL	Active/désactive le programme de charge planifiée. (0 = désactivé / 1 = activé)	–	Disponible
`HeureChargeProgrammeeStart`	INT	Heure de début de la charge planifiée.	H	Disponible
`HeureChargeProgrammeeStop`	INT	Heure de fin de la charge planifiée.	H	Disponible
`SOC_CHARGE_PROGRAMMEE`	INT	Limite de SOC (%) visée pour une charge planifiée.	`%`	Disponible
`WC_PmaxChargeProgrammee`	INT	Permet de définir la puissance max. de charge, sinon, la puissance de charge est également à (Psousc * 0.8)	W Positif = charge Négatif = décharge	Disponible

# Activation de la charge planifiée de 20h à 22h avec un SOC visé  à 80 % sans limitation de puissance

EnableChargeProgrammee = 1
HeureChargeProgrammeeStart = 20
HeureChargeProgrammeeStop = 22
SOC_CHARGE_PROGRAMMEE = 80

Cas de la décharge

Variable	Type	Description	Unité	État
`EnableDechargeProgrammee`	BOOL	Active/désactive le programme de décharge planifiée. (0 = désactivé / 1 = activé)	–	Indisponible
`HeureDechargeProgrammeeStart`	INT	Heure de début de la décharge planifiée.	H	Indisponible
`HeureDechargeProgrammeeStop`	INT	Heure de fin de la décharge planifiée.	H	Indisponible
`SOC_DECHARGE_PROGRAMMEE`	INT	Limite de SOC (%) visée pour une décharge planifiée.	`%`	Indisponible
`WC_PmaxDechargeProgrammee`	INT	Permet de définir la puissance max. de décharge, sinon, la puissance de charge est également à (Psousc * 0.8)	W Positif = charge Négatif = décharge	Indisponible

3.5. Exemple d’utilisation

# Activation des programmes

EnableChargeProgrammee = 1


# Plages horaires

HeureChargeProgrammeeStart = 22
HeureChargeProgrammeeStop = 6


# Seuil max. de puissance sur la plage programmée à 80 kW

WC_PmaxChargeProgrammee = 80000


# Seuil SOC

SOC_CHARGE_PROGRAMMEE = 95

Interprétation :

Nous activons le mode charge programmée.
Nous indiquons ensuite les heures que la batterie commencera sa charge à 22h et arrêtera sa charge à 6h.
Le seuil maximal de puissance de charge lorsque nous sommes en charge programmée permet de lisser la puissance sur la durée. Il limitera donc sur la période de 22h à 6h la puissance de charge à 80 kW jusqu’à ce que le SOC visé soit atteint ou que la durée soit terminée.
La charge se coupera automatiquement si jamais le seuil de 95% d’état de charge (SOC) est atteint avant l’heure d’arrêt de charge ou si l’heure de fin est atteinte. Si la charge est terminée avant l’heure de fin, la batterie est maintenue à son SOC visé jusqu’à l’heure de fin. Il est impossible de décharger la batterie tant que l’heure de fin de la charge programmée n’a pas été atteinte.

Tores Rogowski

Dernière modification le 09/01/2026 17:35

Bobine de Rogowski flexible fixe

Haute linéarité de 10A à 500 kA
Large plage dynamique
Très utile pour les conducteurs de grande taille ou de forme difficile, ou dans les endroits à accès limité
Non endommagé par les surcharges importantes
Non intrusif, ne prélève aucune puissance du circuit principal
Uniformité de mesure quelle que soit la position du conducteur à l’intérieur de la bobine
Excellente immunité aux conducteurs de courant externes
Grâce à son faible poids, elle peut être changée facilement sur le conducteur mesuré
Totalement blindée

Description

Les bobines ESCT-RRC sont des transducteurs de courant flexibles basés sur le principe de Rogowski, particulièrement adaptés aux mesures en combinaison avec des appareils portables. Elles sont disponibles en différentes tailles et peuvent être fournies selon les spécifications du client. Elles sont donc utilisables dans toutes les applications où les transducteurs traditionnels ne conviennent pas en raison de leur taille et/ou de leur poids. Grâce à ses caractéristiques spécifiques, la bobine de Rogowski flexible est une solution extrêmement confortable pour la mesure de courant et peut être utilisée dans de nombreux cas où un transducteur de courant traditionnel n’est pas adapté. Les bobines ESCT-RC sont équipées d’un blindage contre l’influence des champs magnétiques externes, garantissant ainsi une mesure stable des courants faibles jusqu’à des centaines de kA. Les bobines de Rogowski doivent être connectées à un intégrateur électronique pour la compensation du déphasage de 90° et l’égalisation de fréquence. Les appareils portables et les compteurs peuvent interfacer directement les bobines de Rogowski sans besoin d’intégrateurs externes, ce qui est un avantage car il n’y a pas de boîtiers externes ou d’alimentation électrique, ce qui facilite l’utilisation. Les caractéristiques particulières des bobines de Rogowski combinées à la programmation d’entrée extrêmement flexible des appareils portables permettent de réaliser des mesures pour toutes les applications.

Caractéristique

Diamètre de bobine très fin
Calibré à 0,5%
Uniformité de mesure quelle que soit la position du conducteur à l’intérieur de la bobine
Excellente immunité aux conducteurs de courant externes
Livré déjà calibré

Applications

Appareils de mesure, instrumentation de laboratoire
Systèmes de surveillance et de contrôle de puissance
Mesure des ondulations de courant continu
Surveillance des harmoniques et des transitoires
Capteur pour compteur de puissance, analyseur de puissance

Produits Associés

Intégrateurs : S10, S9.1, D1, S1, DA01/05, 01/03

Avantages

Grâce à sa structure, les bobines de Rogowski flexibles permettent d’enlacer des conducteurs ou des câbles groupés, qui sont grands et difficiles d’accès, sans aucun danger.
La sortie de la bobine donne un signal de basse tension, donc il n’y a aucun danger de circuit secondaire ouvert. Cela rend les transducteurs de Rogowski extrêmement adaptés aux mesures temporaires, par exemple en combinaison avec des analyseurs portables.
Contrairement aux transformateurs de courant traditionnels à noyau magnétique, la bobine de Rogowski est un transducteur non intrusif. Comme elle n’a pas de noyau dur, elle ne prélève aucune puissance du circuit principal transportant le courant à mesurer.

Qu’est-ce qu’une bobine de Rogowski ?

Les bobines de Rogowski sont utilisées depuis des décennies pour la détection et la mesure des courants électriques. Elles sont basées sur un principe simple : une bobine « sans noyau » est placée autour du conducteur de manière toroïdale et le champ magnétique produit par le courant induit une tension dans la bobine. La tension de sortie est proportionnelle à la vitesse de variation du courant. Cette tension est intégrée, produisant ainsi une sortie proportionnelle au courant. Grâce à des techniques d’enroulement de précision, spécialement développées à cet effet, les bobines sont fabriquées de manière à ce que leur sortie ne soit pas influencée par la position du conducteur à l’intérieur du tore, et à rejeter les interférences des champs magnétiques externes, causées par exemple par des conducteurs proches. Un système de mesure de courant à bobine de Rogowski se compose d’une combinaison de bobine et d’électronique de conditionnement. Les transducteurs de courant à bobine de Rogowski sont utilisés pour la mesure de courant alternatif. Ils peuvent être utilisés dans des circonstances similaires aux transformateurs de courant, mais pour de nombreuses applications, ils présentent des avantages considérables :

Large plage dynamique
Haute linéarité
Très utile pour les conducteurs de grande taille ou de forme difficile, ou dans les endroits à accès limité
Contrairement aux transformateurs de courant traditionnels, il n’y a aucun danger de circuit secondaire ouvert
Ils ne peuvent pas être endommagés par de grandes surcharges
Ils sont non intrusifs. Ils ne prélèvent aucune puissance du circuit principal transportant le courant à mesurer
Ils sont également légers et, dans certaines applications, suffisamment légers pour être suspendus au conducteur mesuré

Le transducteur ne mesure pas les courants continus, mais contrairement à un transformateur de courant, il peut effectuer des mesures précises de la composante alternative même s’il y a une grande composante continue superposée, car il n’y a pas de noyau de fer causant la saturation. Cette caractéristique est particulièrement utile pour mesurer les courants d’ondulation, par exemple dans les systèmes de charge de batterie.

Spécifications

Transducteur
Longueur de la bobine :	de 20 cm à 1000 cm
Diamètre de la bobine :	Ø8, Ø6, Ø12 mm
Fixation :	support à baïonnette
Poids :	150 g
Matériau :	thermoplastique UL94-V0

Niveau de sortie (RMS) :	ESCT-RC Series : 50 mV/kA @50Hz, 85 mV/kA @50Hz / 80mV/kA @60Hz, 100mV/kA @60Hz ESCT-SRC Series : 120 mV/kA @50Hz, 240 mV/kA @50Hz / 200V/kA @60Hz, 333mV/kA @60Hz
Plage de courant :	10A à 500 kA
Tolérance de sensibilité de sortie :	±5% (non calibré)
Sensibilité de sortie/tolérance :	±5%, 25°C (calibré)
Erreur de position :	±1
Résistance de la bobine :	de 70 à 900 Ω
Erreur de positionnement :	meilleure que ±1% de la lecture (avec câble de 15 mm de diamètre)
Plage de fréquence :	environ 40 Hz à 20 kHz
Tension de travail :	1000 VRMS CAT III / 600 VRMS CAT IV degré de pollution 2
Tension d’essai :	7400 VRMS / 1 min
Câble de connexion
Type :	2 x 0,15 mm + blindage
Longueur :	sur demande
Conditions environnementales
Température de fonctionnement :	de -30°C à +80°C
Température de stockage :	de -40°C à +80°C
Degré de protection :	IP68 Type A B D, IP65 Type E (ESCT-SRC Series), IP54 Type C (ESCT-RC16/24/36)
Conformité aux normes
Sécurité :	EN61010-1, EN61010-031, EN61010-2-031, EN61010-2-032

Tableau des Modèles

Ref de la bobine	Taille de la fenêtre (mm)		Longueur de la bobine (mm)	Longueur du câble (mm)	Ratio	N° de type	Remarque
Ref de la bobine	A	B	Longueur de la bobine (mm)	Longueur du câble (mm)	Ratio	N° de type	Remarque
ESCT-RC60	60	50	200	2000	85 mV/kA @50Hz	A	1. Couleurs de bobine différentes : Noir, Jaune, Rouge, Vert, Bleu (quantité minimale de commande requise) 2. Autres longueurs de câble, supérieures à la norme (2 m), jusqu’à 15 m 3. Autres longueurs de bobine que celles répertoriées, jusqu’à 1000 cm 4. Code produit : ESCT-RC-xxx (taille de la fenêtre)
ESCT-RC100	135	100	395	2000	85 mV/kA @50Hz	B
ESCT-RC105	105	100	350	2000	85 mV/kA @50Hz	A
ESCT-RC150	165	150	525	2000	85 mV/kA @50Hz	B
ESCT-RC200	240	200	665	2000	85 mV/kA @50Hz	B
ESCT-RC240	245	240	800	2000	85 mV/kA @50Hz	A
ESCT-RC16	22	16	80	2000	50 mV/kA @50Hz	C
ESCT-RC24	27,5	24	97	2000	50 mV/kA @50Hz	C
ESCT-RC36	36	37	130	2000	50 mV/kA @50Hz	C
ESCT-RC45	65	45	205	2000	85 mV/kA @50Hz	D
ESCT-SRC100	115	100	380	2000	240 mV/kA @60Hz	E
ESCT-SRC150	175	150	555	2000	240 mV/kA @60Hz	E
ESCT-SRC300	315	300	1000	2000	240 mV/kA @60Hz	E

Référence de Sélection

ESCT-RC60-2M-85-B

RC : < 120 mV/kA
SRC : ≥ 120 mV/kA
Longueur du câble (personnalisable)
Ratio : 85 mV/kA (personnalisable)
Couleur (R : Rouge, B : Bleu, O : Orange, Y : Jaune, G : Vert)

ESCT-RC60-2M-85-B signifie : taille de la fenêtre 60 mm, longueur du câble 2 mètres, ratio nominal 85 mV/kA et couleur bleue.

Tout les paramètres sont modifiables, contactez nous pour plus de détails.

Comment l’utiliser

Sensibilité de position

Position du conducteur	Erreur typique (%)
À côté du mécanisme de clip ensemble	< 0,5%
À côté du bord intérieur de la bobine	< 0,8%
À côté du clip opposé	< 1%

Position du conducteur	Erreur typique (%)
À côté du mécanisme de clip ensemble	< 0,5%
À côté du bord intérieur de la bobine	< 0,8%
À côté du clip opposé	< 1%

Position du conducteur	Erreur typique (%)
À côté du mécanisme de clip ensemble	< 0,5%
À côté du bord intérieur de la bobine	< 0,8%
À côté du clip opposé	< 1%

Position du conducteur	Erreur typique (%)
À côté du mécanisme de clip ensemble	< 0,5%
À côté du bord intérieur de la bobine	< 0,8%
À côté du clip opposé	< 1%

Position du conducteur	Erreur typique (%)
À côté du mécanisme de clip ensemble	< 0,5%
À côté du bord intérieur de la bobine	< 0,8%
À côté du clip opposé	< 1%

Dimensions

Tolérance des dimensions A, B, C, F : ±5 mm, D : ±0,2 mm, E : ±10 mm

Type A : RC60, RC105, RC240

Type A:	RC60	RC105	RC240
A. Taille de la fenêtre A	60	105	245
B. Taille de la fenêtre B	100	150	300
C. Diamètre extérieur de la bobine	66	121	261
D. Section de la bobine	8
E. Longueur total du câble	2000
F. Longueur de la bobine	200	350	800
Ratio (Calibré)		80mV/kA@50Hz; 85mV/kA@50Hz; 100mV/kA@50Hz
Bande passante	1 Hz to 50 kHz (-3dB)

Type B : RC100, RC150, RC200, RC300

Type B:	RC100	RC150	RC200	RC300
A. Taille de la fenêtre A	135	165	210	325
B. Taille de la fenêtre B	100	150	200	300
C. Diamètre extérieur de la bobine	151	181	226	340
D. Section de la bobine	8
E. Longueur totale du câble	2000
F. Longueur de la bobine	395	525	665	1050
Ratio (Calibré)	80mV/kA@50Hz;85mV/kA@50Hz;100mV/kA@50Hz
Bande passante	1Hz to 50kHz(-3dB)

Type C : RC16, RC24, RC36

Type C:	RC16	RC24	RC36
A. Taille de la fenêtre A	22	27.5	36
B. Taille de la fenêtre B	16	24	37
C. Diamètre extérieur de la bobine	34	39.5	48
D. Section de la bobine		6
E. Longueur totale du câble		2000
F. Longueur de la bobine	80	97	130
Ratio (Calibré)	50mV/kA @50Hz
Bande passante	1 Hz to 20 kHz (-3dB)

Type D : RC45

Type D:	RC45
A. Taille de la fenêtre A	65
B. Taille de la fenêtre B	45
C. Diamètre extérieur de la bobine	81
D. Section de la bobine	8
E. Longueur totale du câble	2000
F. Longueur de la bobine	205
Ratio (Calibré)	50mV/kA @50Hz;85mV/kA@50Hz;100mV/kA@50Hz
Bande passante	1 Hz to 50 kHz (-3dB)

Type E : SRC100, SRC150, SRC300

Type E:	RC100	RC150	RC300
A. Taille de la fenêtre A	115	175	315
B. Taille de la fenêtre B	100	150	300
C. Diamètre extérieur de la bobine	139	199	399
D. Section de la bobine		12
E. Longueur totale du câble		2000
F. Longueur de la bobine	380	555	1000
Ratio (Calibré)	240mV/kA @60Hz
Bande passante	1 Hz to 10 kHz (-3dB)

Protégé : Shelter PSS : Mise en service

Dernière modification le 23/04/2024 12:10

Table d’échange modbus

Dernière modification le 11/04/2024 09:56

Adresse	Nom	Type	Description	Unité
1000	Fault	BOOL	Au moins 1 défaut sur l’installation
1001	ForceChargeDechargeBattDistante	BOOL	Pilotage manuel : Activation (1) ou désactivation (0)
22000	ForcePuissanceChargeDechargeAC	INT32	Pilotage manuel : Puissance de charge (+) ou décharge (-) des batteries	W
32006	R_EaExpBrute_Res	FLOAT32	Énergie injectée au réseau	kWh
32012	R_EaImpBrute_ConsoTot	FLOAT32	Énergie consommée	kWh
32008	R_EaImpBrute_GenTot	FLOAT32	Énergie produite par le solaire photovoltaiqe	kWh
32004	R_EaImpBrute_Res	FLOAT32	Energie soutirée du réseau	kWh
32010	R_P_ConsoTot	FLOAT32	Puissance de la consommation	W
32000	R_P_GenTot	FLOAT32	Puissance du solaire photovoltaiqe	W
32002	R_P_Res	FLOAT32	Puissance réseau (soutirage signe positif / injection signe négatif)	W
32022	RM_EnegBatt	FLOAT32	Energie déchargée de la batterie	kWh
32020	RM_EposBatt	FLOAT32	Energie chargée dans la batterie	kWh
32018	RM_Pbatt	FLOAT32	Puissance de la batterie (charge signe positif / décharge signe négatif)	W
32014	RM_SOC	FLOAT32	État de charge de la batterie	%
32016	RM_SOH	FLOAT32	État de santé de la batterie	%

Protégé : MQTT comment faire ?

Dernière modification le 03/02/2023 17:29

Protégé : API serveur de prédiction

Dernière modification le 10/01/2023 14:18

MicroSERVER

Dernière modification le 28/09/2022 10:36

1. Lecteurs ciblés
2. Présentation de l’application
3. API

1. Lecteurs ciblés

Cette documentation est à destination des utilisateurs de l’application MicroSERVER, permettant la visualisation de données collectées depuis des automates SIREA.

2. Présentation de l’application

A venir …

3. API

3.1 Obsolescence

Cette API est disponible sur MicroSERVER jusqu’à la version vX.

3.2 Généralités

Ce document détaille les requêtes HTTP permettant à l’utilisateur d’interagir avec MicroSERVER au travers de fonctions PHP, fournissant ainsi une interface de communication entre le serveur Web et d’autres services externes.

3.3 Fonctions

3.3.1 Authentification

Syntaxe Python :

import requests
server_uri = 'URI'
user = 'USER'
password = 'PASS'
query = 'QUERY'
resp = requests.post(server_uri + query, {'usr': user, 'pwd': password})

Syntax AJAX :

var user = 'USER';
var password = 'PASS';
var query = 'QUERY';
function on_response(data, status, xhr) {
    // do something
}
$.post(query, {usr: user, pwd: password}, on_response);

Paramètre	Commentaire
URI	Adresse IP ou nom d’hôte du serveur hébergeant la base de données
USER	Identifiant de connexion
PASSWORD	Mot de passe associé à l’identifiant de connexion
QUERY	Requête selon les fonctions PHP listées dans le document suivant

Avertissement
Pour des raisons de sécurité, veuillez utiliser la méthode POST pour les paramètres "usr" et "pwd".

Exemple de requête Python :

import requests
server_uri = 'https://192.168.43.108'
user = 'username'
password = 'password'
query = '/get_variables?dev=1'
resp = requests.post(server_uri + query, {'usr': user, 'pwd': password})

Exemple de requête AJAX :

var user = 'username';
var password = 'password';
var query = '/get_variables?dev=1';
function on_response(data, status, xhr) {
    // do something
}
$.post(query, {usr: user, pwd: password}, on_response);

3.3.2 get_variables.php

Cette requête récupère la valeur d’une ou plusieurs variables.

/get_variables.php?dev=DEV&var1=N1&var2=N2&...&varn=Nn

Paramètre	Commentaire
DEV	ID de l’équipement
N1, N2, Nn	ID (ou adresse ou mnémonique) de la variable à partir de laquelle la valeur doit être récupérée. Une même requête permet de récupérer la valeur d’une ou plusieurs variables, sans limite

Information
Vous pouvez utiliser le paramètre "dev" OU les paramètres "var", mais un seul d'entre eux est obligatoire.

Syntaxe de la réponse XML :

<update>
   <variable>
	<timestamp></timestamp>
	<rowid></rowid>
      <address></address>
      <name></name>
	<value></value>
	<fvalue></fvalue>
	<alarm></alarm>
      <ack></ack>
   </variable>
   <variable>
	<timestamp></timestamp>
	<rowid></rowid>
      <address></address>
      <name></name>
	<value></value>
	<fvalue></fvalue>
	<alarm></alarm>
      <ack></ack>
   </variable>
</update>

Tag	Commentaire
<timestamp>	Moment du dernier changement de la variable, mesuré en secondes depuis le 1er septembre 1970
<rowid>	Identifiant de la variable
<address>	Adresse de la variable
<name>	Mnémonique de la variable
<value>	Valeur de la variable, non formatée
<fvalue>	Valeur de la variable, formatée selon le format défini dans MicroSERVER
<alarm>	0 lorsqu’il n’y a pas d’alarme active associée à cette variable et 1 s’il y a des alarmes actives associées à cette variable
<ack>	0 lorsque l’alarme n’est pas acquittée et 1 si l’alarme est acquittée

Exemple de requête :

https://192.168.43.108/get_variables.php?dev=4&var1=17&var2=18

Exemple de la réponse XML :

<update>
   <variable>
      <timestamp>1415788199.94717</timestamp>
      <rowid>17</rowid>
      <value>12</value>
      <address>%POW</address>
      <name>power</name>
      <fvalue>12 W</fvalue>
      <alarm>0</alarm>
      <ack>0</ack>
   </variable>
   <variable>
      <timestamp>1415788167.98588</timestamp>
      <rowid>18</rowid>
      <address>%POW</address>
      <name>power</name>
      <value>10</value>
      <fvalue>10 A</fvalue>
      <alarm>1</alarm>
      <ack>0</ack>
   </variable>
</update>

3.3.3 get_al.php

Cette requête récupère toutes les alarmes actives dans MicroSERVER, ou toutes les alarmes actives associées à une variable ou à un équipement.

/get_al.php?dev=DEV&var=VAR

Paramètre	Commentaire
DEV	ID de l’équipement
VAR	ID (ou adresse ou mnémonique) de la variable à partir de laquelle la valeur doit être récupérée.

Information
Vous pouvez utiliser le paramètre "dev" OU les paramètres "var".

Syntaxe de la réponse XML :

<update>
   <entry>
      <timestamp></timestamp>
      <log_index></log_index>
      <var_index></var_index>
      <dev_index></dev_index>
      <alarm></alarm>
      <ack_timestamp></ack_timestamp>
      <ack_user></ack_user>
      <ack_comment></ack_comment>
   </entry>
</update>

Tag	Commentaire
<timestamp>	Moment du dernier changement de la variable, mesuré en secondes depuis le 1er septembre 1970
<log_index>	ID de l’entrée du journal concernant l’alarme
<var_index>	ID de la variable associée à l’événement
<dev_index>	ID de l’équipement auquel appartient la variable
<alarm>	Libellé de l’alarme associé à l’alarme active
<ack_timestamp>	Moment de l’acquittement de l’alarme, si acquitté ; sinon ce champ reste vide
<ack_user>	Identification de l’utilisateur qui a acquitté l’alarme, si acquittée ; sinon ce champ reste vide
<ack_comment>	Commentaire relatif à l’acquittement d’alarme indiqué par ack_user si acquitté ; sinon ce champ reste vide

Exemple de requête :

https://192.168.43.108/get_al.php?dev=4&var=10

Exemple de la réponse XML :

<update>
   <entry>
      <timestamp>1415788199.94717</timestamp>
      <log_index>7693</log_index>
      <var_index>10</var_index>
      <dev_index>4</dev_index>
      <alarm>Communication default</alarm>
      <ack_timestamp></ack_timestamp>
      <ack_user></ack_user>
      <ack_comment></ack_comment>
   </entry>
</update>

3.3.4 get_bg.php

Cette requête récupère les données à partir d’une date de début et les regroupe selon la période demandée pour chaque variable.

/get_bg.php?time=TIME&period=PERIOD&tz=TZ&var1=N1&var2=N2&...&varn=Nn

Paramètre	Commentaire
TIME	Début de la période sous forme de timestamp
PERIOD	Type de période: – 1 = Une année de données cumulées par mois – 2 = Un mois de données cumulées par jour – 3 = Un jour de données cumulées par heure – 4 = Une heure de données cumulées par pas de 5 minutes
TZ	Chaîne du fuseau horaire, par exemple “Europe/Paris”
N1, N2, Nn	ID (ou adresse ou mnémonique) de la variable à partir de laquelle la valeur doit être récupérée. Une même requête permet de récupérer la valeur d’une ou plusieurs variables, sans limite

Information
Le paramètre « var1 » est obligatoire.

Syntaxe de la réponse XML :

<update>
   <entry>
      <var_index></var_index>
      <timestamp></timestamp>
      <value1></value1>
   </entry>
</update>

Tag	Commentaire
<var_index>	ID de la variable définie
<timestamp>	Moment du début de la période, mesuré en secondes depuis le 1er septembre 1970
<value1>	Valeur de la variable, non formatée

Exemple de requête :

https://192.168.43.108/get_bg.php?time=1415788199.94717&period=1&var=10

Exemple de la réponse XML :

<update>
   <entry>
      <var_index>10</var_index>
      <timestamp>1415788199.94717</timestamp>
      <value1>4</value1>
   </entry>
   <entry>
      <var_index>10</var_index>
      <timestamp>1418380199.94717</timestamp>
      <value1>4</value1>
   </entry>
</update>

Information
Le nom de champ correct pour "valeur" est <valeur1> et non <valeur>.

3.3.5 get_tr.php

Cette requête récupère un ensemble de valeurs sur une période définie pour chaque variable.

/get_tr.php?mintime=MINTIME&maxtime=MAXTIME&np=NP&pval=PVAL&pmult=PMULT&var1=N1&...&varn=Nn

Paramètre	Commentaire
MINTIME	Début de la période sous forme de timestamp
MAXTIME	Fin de la période sous forme de timestamp
NP	Limite maximale de valeurs à récupérer
N1, Nn	ID (ou adresse ou mnémonique) de la variable à partir de laquelle la valeur doit être récupérée. Une même requête permet de récupérer la valeur d’une ou plusieurs variables, sans limite
PVAL, PMULT	Période sous la forme « pval * pmult » secondes. Par exemple, pour « 4 heures », pval = 4 et pmult = 3600

Information
Le paramètre « var1 » est obligatoire.

Syntaxe de la réponse XML :

<update>
   <entry>
      <timestamp></timestamp>
      <rowid></rowid>
      <var_index></var_index>
      <value></value>
   </entry>
</update>

Tag	Commentaire
<timestamp>	Moment du point, mesuré en secondes depuis le 1er septembre 1970
<rowid>	ID de l’entrée de journal du point
<var_index>	ID de la variable définie
<value>	Valeur du point, non formatée

Exemple de requête :

https://192.168.43.108/get_tr.php?mintime=1415788199.94717&maxtime=1418380199.94717&np=1&pval=4&pmult=3600&var1=10

Exemple de la réponse XML :

<update>
   <entry>
      <timestamp>1415788199.94717</timestamp>
      <rowid>546</rowid>
      <var_index>10</var_index>
      <value>24</value>
   </entry>
   <entry>
      <timestamp>1418380199.94717</timestamp>
      <rowid>547</rowid>
      <var_index>10</var_index>
      <value>26</value>
   </entry>
</update>

3.3.6 get_log.php

Cette requête récupère un ensemble d’événements sur une période définie pour chaque variable.

/get_log.php?cat=CAT&lastid=LASTID&period=PERIOD&mintime=MINTIME&maxtime=MAXTIME&var1=N1&...&varn=Nn

Paramètre	Commentaire
CAT	Catégorie du journal à récupérer : – 2 = Événements – 3 = Alarmes – 4 = Valeurs
LASTID	ID de l’entrée du journal à partir duquel récupérer les résultats suivants
PERIOD	Durée de la période en secondes depuis la date actuelle.
MINTIME	Début de la période sous forme de timestamp
MAXTIME	Fin de la période sous forme de timestamp
N1, Nn	ID (ou adresse ou mnémonique) de la variable à partir de laquelle la valeur doit être récupérée. Une même requête permet de récupérer la valeur d’une ou plusieurs variables, sans limite

Information
Le paramètre « var1 » est obligatoire et si « period » est fourni, « mintime » et « maxtime » sont ignorés.

Syntaxe de la réponse XML :

<log>
   <entry>
      <rowid></rowid>
      <dev_index></dev_index>
      <var_index></var_index>
      <var_address></var_address>
      <var_name></var_name>
      <value></value>
      <ack_timestamp></ack_timestamp>
      <ack_user></ack_user>
      <ack_comment></ack_comment>
      <timestamp></timestamp>
   </entry>
</log>

Tag	Commentaire
<rowid>	ID de l’entrée de journal du point
<dev_index>	ID de l’équipement défini (si pas de variable définie)
<var_index>	ID de la variable définie
<var_address>	Adresse de la variable définie (si pas de variable définie)
<var_name>	Nom de la variable définie (si pas de variable définie)
<value>	Valeur du point, non formatée
<ack_timestamp>	Timestamp de l’acquittement, mesuré en secondes depuis le 1er septembre 1970 (si « cat » = 3)
<ack_user>	Identifiant de l’utilisateur qui a acquitté (si “cat” = 3)
<ack_comment>	Commentaire de l’acquittement (si “cat” = 3)
<timestamp>	Moment du dernier changement de la variable, mesuré en secondes depuis le 1er septembre 1970

Exemple de requête :

https://192.168.43.108/get_log.php?cat=3&lastid=1234&period=60&var1=10

Exemple de la réponse XML :

<log>
   <entry>
      <rowid>1235</rowid>
      <var_index>10</var_index>
      <value>1</value>
      <ack_timestamp>1415788199.94717</ack_timestamp>
      <ack_user>admin</ack_user>
      <ack_comment>ok</ack_comment>
      <timestamp>1415785429</timestamp>
   </entry>
</log>

3.3.7 set_variables.php

Cette requête met à jour une ou plusieurs variables.

/set_variables.php?var1=N1&...&varn=Nn&value1=V1&...&valuen=Vn

Paramètre	Commentaire
N1, N2	ID (ou adresse ou mnémonique) de la variable à partir de laquelle la valeur doit être récupérée. Une même requête permet de récupérer la valeur d’une ou plusieurs variables, sans limite
V1, V2	Valeur de la variable à partir de l’ordre des paramètres “var” de la requête.

Information
Le paramètre « var1 » et le paramètre « value1 » sont obligatoires.

Syntaxe de la réponse XML :

<update>
   <variable>
      <status></status>
      <error></error>
   </variable>
</update>

Tag	Commentaire
<status>	« OK » ou « ERR »
<error>	Correspond à un code d’erreur

Exemple de requête :

https://192.168.43.108/set_variables.php?var1=10&var2=11&value1=25&value2=27

Exemple de la réponse XML :

<update>
   <variable>
      <status>OK</status>
   </variable>
   <variable>
      <status>ERR</status>
      <error>XXX</error>
   </variable>
</update>

3.3.8 set_user.php

Cette requête met à jour les informations relatives à l’utilisateur connecté.

/set_user.php?new_pwd=NPASS&locale=LOCALE&email=EMAIL&phone_number=PHONE&active_report_filter=ARF&inactive_report_filter=IRF

Paramètre	Commentaire
NPASS	Nouveau mot de passe de l’utilisateur
LOCALE	Format régional sous forme de code ISO 639-1 de l’utilisateur
EMAIL	E-mail de l’utilisateur
PHONE	Numéro de téléphone de l’utilisateur
ARF, IRF	Période de filtre de rapport actif ou inactif de l’utilisateur. Chaque point doit être séparé par un point virgule, et chaque point est composé de 4 champs : – Premier champ : Jour de la semaine (lundi = 1, dimanche = 7) – Deuxième champ : Jour du mois (1 à 31) – Troisième champ : Mois (1 à 12) – Quatrième champ : Heure (0 à 23) Chaque champ doit être séparé par un espace. Vous pouvez mettre une valeur, ou plusieurs séparées par une virgule, ou une étoile pour dire « tout ». Par exemple : « 2,5 * * *;7 1 2,10 3 » signifie tous les mardis ou vendredis de l’année ET le dimanche 1er de février ou d’octobre à 3h du matin.

Avertissement
Seuls les codes ISO 639-1 "fr", "gb" et "us" sont pris en charge par le paramètre "locale".

Syntaxe de la réponse XML :

<update>
   <variable>
      <status></status>
   </variable>
</update>

Tag	Comment
<status>	« OK » ou « ERR »

Exemple de requête :

https://192.168.43.108/set_user.php?new_pwd=newpass&locale=fr&email=contact@exemple.com&phone_number=0600000000&inactive_report_filter=2,5+*+*+*;7+1+2,10+3

Information
Les espaces doivent être remplacés par "+" ou "%20" dans la requête HTTP pour être considérés comme des espaces.

Exemple de la réponse XML :

<update>
   <variable>
	<status>OK</status>
   </variable>
</update>

MicroSERVER UI

Dernière modification le 30/04/2024 09:51

1. Lecteurs ciblés
2. Présentation de l’application
3. Présentation de l’API
- 3.1 Généralités
- 3.2 Fonctions

1. Lecteurs ciblés

Cette documentation est à destination des utilisateurs de l’application MicroSERVER, permettant la visualisation de données collectées depuis des automates SIREA.

2. Présentation de l’application

2.1 Widgets du tableau de bord

Le tableau de bord contient toutes les données que vous jugez utiles à afficher en premier lieu. Ces données sont contenues dans des cadres appelés « widgets ». Il existe ainsi plusieurs widgets différents afin de visualiser au mieux les données sous différentes formes (tableau, graphe, diagramme…). Le tableau de bord est facilement personnalisable selon les besoins. On peut y ajouter, supprimer, ou déplacer facilement un widget.

2.2 Modes du tableau de bord

Le tableau de bord possède deux modes:

le mode visualisation : c’est le mode par défaut. Il permet de visualiser l’ensemble des widgets avec leurs résultats.
le mode édition : il permet de créer, modifier et bouger les widgets.

Pour accéder au mode visualisation quand on est dans le mode édition, il faut cliquer sur le bouton:

Pour accéder accède au mode édition à partir du mode visualisation, il faut cliquer sur le bouton:

Ces deux boutons se situent en bas à droite de l’écran.

2.3 Attribut d’un widget

2.3.1 Créer un widget

Pour ajouter un widget, il est nécessaire d’être dans le mode édition.
Cliquez ensuite sur le champ « + Ajouter un widget » en bas de la page.
Cette action ouvre une fenêtre popup permettant de créer un nouveau widget. Trois types de widgets sont proposés:

Mise en page
Visualisation
Pilotage

Le choix d’un widget ouvrira une nouvelle fenêtre popup sur la droite qui vous permettra de renseigner un certains nombres de champs. Les indications pour compléter cette fenêtre sont fournies dans Widget Mise en page, Widget Données et Widgets Dédiés. Cliquer sur “Enregistrer” pour confirmer la création. On passe alors dans le mode visualisation.

2.3.2 Déplacer un widget

Quand un widget est créé, on peut le déplacer sur le tableau de bord en cliquant sur cet icône. Elle se trouve en haut à droite du widget et est disponible seulement dans le mode édition.

2.3.3 Modifier le widget

Quand un widget est créé, on peut le modifier en cliquant sur cet icône. Elle se trouve en haut à droite du widget et est disponible seulement dans le mode édition.

2.3.4 Dupliquer le widget

Quand un widget est créé, on peut le dupliquer en cliquant sur cet icône. Elle se trouve en haut à droite du widget et est disponible seulement dans le mode édition. La copie est créé en dessous du widget actuel.

2.3.5 Supprimer le widget

Quand un widget est créé, on peut le supprimer en cliquant sur l’icône:
Cette icône se trouve en haut à droite du widget et est disponible seulement dans le mode édition. Cette action est irréversible.

2.4 Catégorie de widgets : Mise en page

2.4.1 Widget Encart

Ce widget permet de créer un cadre (blanc) dans lequel on va pouvoir créer d’autres widgets. Le but est que l’encart serve de cadre dans lequel on va venir y insérer des widgets comme des photos. Dans l’encart, les widgets pourront changer de place.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

On peut ajouter un Titre à l’encart et un commentaire en remplissant les deux formulaires optionnels.

Capture d’écran de la fenêtre *popup* de création/modification du widget Encart

2.4.2 Widget Encart avec onglets

Création et modification

Ce widget s’inspire du widget encart. Il permet de créer un cadre (blanc) dans lequel on va pouvoir créer d’autres widgets à l’intérieur. Ces widgets seront rangés dans des onglets. Ainsi un encart pourra avoir 0, 1 ou plusieurs onglets.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

On peut ajouter un Titre à l’encart et un commentaire en remplissant les deux formulaires optionnels.

Pour créer un onglet, il suffit de renseigner le « Nom de l’onglet » voulu dans la partie « Onglets » dans le cadre gris.

Si on veut rajouter un nouvel onglet, cliquez sur
+ ONGLET.
Un nouveau cadre gris apparaît. Il est à remplir comme le précédent.

Si on veut supprimer un onglet, cliquez sur la croix en haut du cadre gris de l’onglet concerné. On ne peut supprimer un onglet que si il y en a plus de deux.

Capture d’écran de la fenêtre *popup* de création/modification du widget Encart avec Onglets

Navigation sur le widget

Dans le mode visualisation, on peut changer d’onglets en cliquant sur l’onglet désiré.

Capture d’écran d’un exemple de Widget Encart avec Onglets ayant 3 onglets (Onglet 1, Onglet 2 et Onglet 3)

2.4.3 Widget Volets

Création et modification

Ce widget s’inspire du widget encart avec onglet. Il permet de créer des espaces refermables qui vont permettre d’insérer d’autres widgets. Ces widgets seront rangés dans des volets. Ainsi un encart pourra avoir 0, 1 ou plusieurs volets.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

Pour créer un onglet, il suffit de renseigner le « Nom de l’onglet » voulu dans la partie « Onglets » dans le cadre gris.

Si on veut rajouter un nouveau volet, cliquez sur
+ VOLET. Un nouveau cadre gris apparaît. Il est à remplir comme le précédent.

Si on veut supprimer un volet, cliquez sur la croix en haut du cadre gris de l’onglet concerné. On ne peut supprimer un volet que si il y en a plus de deux.

widget volets configuration — Capture d’écran de la fenêtre *popup* de création/modification du widget Volets

Navigation sur le widget

Dans le mode visualisation, on peut changer de volet en cliquant sur le volet désiré.

widget volets — Capture d’écran de la fenêtre *popup* de création/modification du widget Volets

2.4.4 Widget Code

Ce widget permet de coder et de créer des fonctionnalités qui ne sont pas disponibles avec les autres widgets.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

Le widget sera composé des trois encart suivants:

HTML
CSS
Javascript

Un exemple de fonctionnalité à créer est l’affichage dynamique de la valeur d’une variable (nommé « X » de l’équipement d’index 1) et la possibilité de modifier cette valeur. Ci-dessous, le code associé à cette fonctionnalité:

HTML


<form id="form1" data-table="variables" data-mnemonic="X@1">
    <label class="form-label">Exemple X</label>
    <input type="text" data-field="rawValue" />
    <input type="button" value="Valider" class="btn btn-primary" onclick    ="submitForms()"/>
</form>

var submitForms = () => {
        $('#form1').submit();
    }

Le visuel final de cette fonctionnalité sera le suivant:

exemple widget code — Capture d’écran du visuel pour l’exemple du widget code

2.5 Catégorie de widgets : Visualisation

2.5.1 Widget Valeur

Le widget valeur permet de visualiser la valeur d’une variable à un moment donné.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

Pour choisir la variable souhaitée, il faut dans un premier temps sélectionner dans le menu déroulant, l’équipement et le nom de la variable.
Il y a aussi la possibilité de renommer la variable par un autre nom et de rajouter un commentaire.

Le champ « Type de valeur » permet de choisir quel type de valeur on souhaite avoir parmi trois options:

si on veut une valeur ponctuelle (instantanée), cliquer sur « ponctuelle »
si on veut une valeur moyennée, cliquer sur « moyenne ». De nouvelles informations de temporalité sont alors demandées. On a ainsi le choix de calculer la moyenne sur:

– une période statique. Un intervalle de temps avec une date de début et de fin est alors à renseigner
– une période calendaire. En fonction de la période choisie, si on clique sur précédente, l’intervalle s’étendra alors de l’heure, du jour, de la semaine, du mois ou de l’année précédente jusqu’à la date actuelle. En fonction de la période choisie, si on clique sur actuelle, alors la moyenne sera calculée sur l’heure, la journée, la semaine, le mois ou l’année actuelle. Par défaut la période est celle de la journée actuelle.
– une période glissante. En fonction de la durée N rentrée et de la période, l’intervalle de temps s’étendra sur les N dernière(s) heure(s), les N dernier(s) jour(s), les N dernière(s) semaine(s), les N dernier(s) mois ou les N dernière(s) année(s)

si on veut un écart entre deux valeurs, cliquer sur « écart ». De nouvelles informations de temporalité sont alors demandées. On a ainsi le choix de calculer l’écart entre deux valeurs sur:

– une période statique. L’écart sera calculé entre la date de fin et la date de début renseignées.
– une période calendaire. En fonction de la période choisie, si on clique sur actuelle/précédente, alors l’écart sera calculé entre l’heure, la journée, la semaine, le mois ou l’année actuelle/précédente et la date actuelle. Par défaut, la date sera celle de la journée actuelle.
– une période glissante. L’écart sera alors calculé entre la date actuelle et la N dernière heure, le N dernier jour, la N dernière semaine, le N dernier mois ou la N dernière année

Par défaut, le graphe affichera une valeur ponctuelle.

En fonction des besoins, il est possible d’afficher la valeur brute en cochant « Afficher la valeur brute ». Néanmoins, l’unité ne sera pas affichée.

La taille de l’affichage est réglable puisque la taille de la police diminue si vous cliquez sur la taille petite. Elle augmente si vous cliquez sur « Moyenne » et elle est de taille maximale si vous cliquez sur « Grande ». Par défaut la taille est cochée à « Moyenne ».

Capture d’écran de la fenêtre *popup* de création/modification du widget Valeur

2.5.2 Widget Voyant

Le widget voyant permet de visualiser si la valeur d’une variable respecte une/des condition(s) grâce à un voyant de couleur.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

Pour choisir la variable souhaitée, il faut dans un premier temps sélectionner dans le menu déroulant, l’équipement et le nom de la variable. Il y a aussi la possibilité de renommer la variable par un autre nom et de rajouter un commentaire.

Le champ « Type de valeur » permet de choisir sur quel type de valeur la condition va être exécutée parmi trois options:

si on désire que la condition soit sur une valeur ponctuelle (instantanée), cliquer sur « Ponctuelle »
si on veut que la condition soit sur une valeur moyennée, cliquer sur « Moyenne ». De nouvelles informations de temporalité sont alors demandées. On a ainsi le choix de calculer la moyenne sur:

– une période statique. Un intervalle de temps avec une date de début et de fin est alors à renseigner
– une période calendaire. En fonction de la période choisie, si on clique sur précédente, l’intervalle s’étendra alors de l’heure, du jour, de la semaine, du mois ou de l’année précédente jusqu’à la date actuelle. En fonction de la période choisie, si on clique sur actuelle, alors la moyenne sera calculée sur l’heure, la journée, la semaine, le mois ou l’année actuelle. Par défaut la période est celle de la journée actuelle.
– une période glissante. En fonction de la durée N rentrée et de la période, la moyenne sera calculée sur les N dernière(s) heure(s), les N dernier(s) jour(s), les N dernière(s) semaine(s), les N dernier(s) mois ou les N dernière(s) année(s)

si on désire que la condition soit sur un écart entre deux valeurs, cliquer sur « Écart ». De nouvelles informations de Temporalité sont alors demandées. On a ainsi le choix de calculer l’écart entre deux valeurs sur:

– une période statique. L’écart sera calculé entre la la date de fin et la date de début renseignés.
– une période calendaire. En fonction de la période choisie, si on clique sur actuelle/précédente, alors l’écart sera calculé entre l’heure, la journée, la semaine, le mois ou l’année actuelle/précédente et la date actuelle. Par défaut la date sera celle de la journée actuelle.
– une période glissante. L’écart sera alors calculé entre la date actuelle et la N dernière heure, le N dernier jour, la N dernière semaine, le N dernier mois ou la N dernière année

Par défaut, la condition sera sur une valeur ponctuelle.

Capture d’écran de la fenêtre *popup* de création/modification du widget Voyant

La partie « Conditions » sert à établir les conditions qui vont lever une alarme si elles sont validées.

La condition est construite de la manière suivante:

variable OPÉRATEUR_LOGIQUE valeur

La variable correspond à celle renseignée au-dessus.
Pour créer une condition, il faut compléter l’encart en gris en choisissant tout d’abord l’opérateur logique parmi:

Est égale à (==)
N’est pas égale à (!=)
Est inférieure ou égale à (<=)
Est strictement inférieure à (<)
Est supérieure ou égale à (>=)
Est strictement supérieure à (>)

L’opérateur logique par défaut est « Est égale à » (==).

Enfin, remplissez le champ « Valeur ». La valeur écrite dans cette case correspondra à la valeur dont la variable sera soit égale, non égale, inférieure ou égale, strictement inférieure, supérieure ou égale ou bien strictement supérieure.

En cliquant sur le champ « Couleur du voyant », il est possible de modifier la couleur du voyant à l’aide d’un sélectionneur de couleur. On peut aussi directement y écrire la valeur hexadécimale de la couleur souhaitée. Le voyant aura cette couleur tant que la condition n’est pas vérifiée. Par défaut la couleur est bleue (#276cb8).

Si la condition est vérifiée, un texte peut être affiché plutôt que la valeur de la variable. Le texte voulu doit alors être écrit dans le champ « Texte à afficher ». Si on laisse ce champ vide, c’est la valeur d’origine qui sera affichée.

En bas de l’encart gris à droite, le champ « Afficher la valeur brute » sert, si elle est cochée, à afficher la valeur brute de la variable sans unité.

En dessous de l’encart, la couleur du voyant quand la condition est vérifiée est modifiable en cliquant sur le champ correspondant. Par défaut, la couleur est rouge.

A droite, toujours si la condition est vérifiée, un texte peut être affiché plutôt que la valeur de la variable. Le texte voulu doit alors être écrit dans le champ « Texte à afficher ». Si on laisse ce champ vide, c’est la valeur d’origine qui sera affichée.

Le champ Afficher la valeur brute sert, si elle est cochée, à afficher la valeur brute de la variable sans unité.

Pour l’instant on a une seule condition. Si on désire rajouter d’autres conditions, cliquer sur « + CONDITION ». Un nouvel encart gris s’affiche alors. Il est à remplir comme le précédent explicité ci-dessus.

Ainsi le voyant changera de couleur lorsque la condition1 ET la condition2 seront vraies. Si on a trois conditions, le voyant changera de couleur lorsque la condition1 ET la condition2 ET la condition3 seront vraies, etc.

widget led condition — Capture d’écran de la partie « Condition » de la fenêtre popup de création/modification du widget Voyant

2.5.3 Widget Courbe

Le widget courbe permet d’accéder à une vue d’ensemble de l’évolution des valeurs d’une variable sous forme de courbe.
La fenêtre popup de ce widget se compose de trois onglets:

l’onglet « Apparence »
l’onglet « Données »
l’onglet « Prédiction »

Onglet « Apparence »

Cet onglet permet de configurer l’aspect général du widget et son en-tête.
La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

On peut ajouter un titre au graphique et un commentaire en remplissant les deux formulaires optionnels.
En cochant, « Activer la navigation depuis le widget », on débloque les fonctionnalités de changement des dates de début et de fin sur le widget dans le mode visualisation.

widget courbes apparence — Capture d’écran de l’onglet « Apparence » de la fenêtre popup de création/modification du widget Courbe

Onglet « Données »

Cet onglet permet de configurer les caractéristiques du graphe voulu.

La partie « Temporalité » permet de sélectionner le type de période souhaité parmi trois options disponibles:

« Période statique » définit un intervalle de temps d’affichage. Une date de début et de fin est à renseigner.

Capture d’écran de la partie « Période statique » de l’onglet « Données » de la fenêtre *popup* du widget Courbe

« Période calendaire » définit un intervalle de temps d’affichage par rapport à la date actuelle ou à la date précédente. On peut choisir d’afficher les données de l’heure, du jour, de la semaine, du mois ou de l’année précédente ou actuelle en sélectionnant dans le menu déroulant la période souhaitée ainsi que le décalage. Par défaut la période est celle de la journée actuelle.

Capture d’écran de la partie « Période calendaire » de l’onglet « Données » de la fenêtre *popup* du widget Courbe

Après avoir choisi une période, on peut modifier la précision des points. Cette précision correspond à l’écart de temps entre deux points affichés sur le graphe. Par défaut, cet écart est d’une heure.

Capture d’écran de la partie « Précision » de l’onglet « Données » du widget Courbe

Avertissement
Plus on choisit une longue période avec une petite précision, plus le temps que la courbe se construise et s'affiche sera long.

La partie « Variables » permet de choisir les variables dont on souhaite que les valeurs soient affichées.
Par défaut, une seule variable est affichée sur le widget. Une variable et ses caractéristiques sont dans un encart gris.

Capture d’écran d’un exemple de variable sélectionnée de la fenêtre *popup* du widget Courbe

Pour choisir la variable, sélectionner son équipement et son nom dans les menus déroulants prévus à cet effet. Il est aussi possible de renommer la variable.

Selon les valeurs que l’on a et l’usage dont on veut en faire, deux formes de graphe sont disponibles dans le champ Forme:

graphe en Ligne. Un exemple de graphe en ligne est représenté ci-dessous:

Capture d’écran d’un graphe en ligne (widget Courbe)

graphe en Barre. Un exemple de graphe en barre est représenté ci-dessous:

Capture d’écran d’un graphe en barre (widget Courbe)

Avertissement
Il est possible de combiner graphe en ligne et graphe en barre mais il faut faire attention à l’échelle qui risque de ne pas être la même.

La partie « Type de valeur » permet de choisir quel type de valeur, on souhaite avoir pour chaque point parmi trois options:

si on veut une valeur ponctuelle (valeur de l’instant), cliquer sur « ponctuelle »
si on veut une valeur moyennée (moyenne calculée entre deux points), cliquer sur « moyenne »
si on veut un écart entre deux valeurs (écart entre le point actuel et le point précédent), cliquer sur « écart ».

Par défaut, le graphe affichera des valeurs ponctuelles.

Pour finir on peut choisir l’aspect qu’auront les valeurs de la variable sur le graphe.
Si on a un graphe en ligne, la partie « Aspect » contient six caractéristiques modifiables:

la couleur principale. Si on clique sur ce champ, on peut modifier la couleur par une autre. La couleur par défaut est bleu (#276cb8).
l’épaisseur du trait. Cette valeur va de 1 à 4 pour un trait fin vers épais. L’épaisseur par défaut est 1.
le champ « Trait en pointillé ». Si ce champ est coché alors le trait de la courbe sera en pointillé. Par défaut le champ est décoché.
les mêmes informations apparaissent pour configurer l’aspect de la courbe de comparaison

widget courbe aspect — Capture d’écran de l’aspect d’une variable d’une ligne de l’onglet « Données » de la fenêtre *popup* de création/modification du widget Courbe

Si on a un graphe en barre, la partie « Aspect » contient trois caractéristiques modifiables:

la couleur principale. Si on clique sur ce champ, on peut modifier la couleur par une autre. La couleur par défaut est bleu (#276cb8)
les mêmes informations apparaissent pour configurer l’aspect de la barre de comparaison

widget courbe aspect barre — Capture d’écran de l’aspect d’une variable d’un graphe barre de l’onglet « Données » de la fenêtre *popup* de création/modification du widget Courbe

Information
Il est à noter que la couleur en hexadécimal peut-être écrite dans les cases de couleurs.

Onglet « Prédiction »

Cet onglet comporte une fonctionnalité avancée du widget courbe: la prédiction. Grâce au logiciel NeurEco développé par Adagos, on aura la possibilité de créer un modèle d’intelligence artificielle permettant de prédire les valeurs des variables demandées dans l’onglet « Données ». Ces valeurs dépendront des paramètres que l’on va renseigner dans l’onglet « Prédiction ».

Le bouton « Activer la prédiction » débloque les fonctionnalités de génération de modèle sur le widget ainsi que ces informations dans le mode visualisation. De plus, si le modèle a été généré alors les courbes et/ou les barres prédites seront affichées en plus des courbes réelles.

La partie « Données météorologiques » permet de sélectionner quels paramètres météorologiques on souhaite que notre modèle prennent en compte pour générer le modèle. Les paramètres sélectionnables sont:

la radiation solaire
la température réelle de l’air
la couverture nuageuse
l’humidité de l’air
la vitesse du vent
la direction du vent
la durée d’ensoleillement
la précipitation de pluie

Dans cette partie, on nous demande aussi de compléter le champ « Adresse postale » ainsi que les coordonnées géographiques avec la latitude et la longitude à laquelle les données on été récoltées.

La « Période d’apprentissage » permet de sélectionner la période sur laquelle l’algorithme va se baser pour apprendre et construire le modèle. Il y a 4 choix:

« Aucune période définie ». La période s’étendra alors du premier jour ou il a commencé à y avoir des données jusqu’à maintenant.
« Période statique » définit un intervalle de temps d’affichage. Une date de début et de fin est à renseigner

Capture d’écran de la partie « Période statique » de l’onglet « Prédiction » de la fenêtre *popup* du widget Courbe

« Période calendaire » définit un intervalle de temps d’affichage par rapport à la date actuelle ou à la date précédente. On peut choisir d’afficher les données de l’heure, du jour, de la semaine, du mois ou de l’année précédente ou actuelle en sélectionnant dans le menu déroulant la période souhaitée ainsi que le décalage. Par défaut la période sera celle de la journée actuelle.

Capture d’écran de la partie « Période calendaire » de l’onglet « Prédiction » de la fenêtre *popup* du widget Courbe

« Période glissante » définit un intervalle de temps des dernier(e)(s) heure(s)/ jour(s)/ semaine(s)/ mois jusqu’à la date actuelle. Pour cela, il suffit de renseigner une durée et un type de période dans le menu déroulant. Par défaut, la période s’étendra de hier à aujourd’hui

Capture d’écran de la partie « Période glissante » de l’onglet « Prédiction » de la fenêtre *popup* du widget Courbe

En dessous du choix de la période, on peut décider de la précision des points dans un menu déroulant. La précision est soit à l’heure, au jour, à la semaine ou au mois en sachant qu’il faut une certaines quantités de points pour que le modèle soit fiable. Cette quantité varie en fonctions des données que l’on a. Par défaut la précision est à l’heure.

Capture d’écran de la précision dans l’onglet « Prédiction » de la fenêtre *popup* de création/modification du widget Courbe

La partie « Période de la prédiction » permet de sélectionner la période sur laquelle on souhaite avoir une prédiction. Pour cela, il suffit d’incrémenter et de décrémenter la durée et de choisir une période parmi prochaine(s) heure(s), prochain(s) jour(s), prochaine(s) semaine(s), prochain(s) mois, prochaine(s) année(s). Cette période va se rajouter à la suite de la période d’affichage que l’on a déjà défini dans l’onglet « Données ».

Avertissement
Le temps de génération d'un modèle peut prendre beaucoup de temps en fonction de la quantité de données passées. Par exemple, il est normal que pour une période de deux an avec une précision à l'heure combinée avec plusieurs paramètres météo, le modèle prennent plus d'une heure à se générer.

Navigation sur le widget

Fonctionnalités générales

Une fois que l’on a cliqué sur le bouton « Enregistrer », on peut observer notre widget Courbe.

Information
Si on ne veut que visualiser les valeurs d'une ou de plusieurs variables, on ne va compléter que les onglets "Apparence" et "Données" puis cliquez sur Enregistrer.

Pour zoomer sur une partie du graphe, cliquez sur la zone du graphe que l’on veut agrandir.

Si le champ « Activer la navigation sur le widget » a été coché alors on peut modifier la période d’affichage de la courbe en changeant les dates des champs « Date de début » et « Date de fin » puis en cliquant sur » Appliquer ».

Capture d’écran de la navigation depuis un widget Courbe en mode visualisation

Sur le widget, il est possible de visualiser la date de dernière variation de la variable en bas à gauche du du widget.

Fonctionnalités propres à la prédiction

Si on a aussi rempli l’onglet « Prédiction », alors on va pouvoir dans un premier temps générer un modèle en cliquant sur le bouton « Générer un modèle »

La génération d’un modèle peut prendre un certains temps en fonction de la quantité de données qu’on lui donne en paramètres. On peut donc suivre l’avancée de la génération de ce modèle avec le barre d’avancement située en bas du widget. Plusieurs états d’avancée sont possibles:

Envoi des données pour l’apprentissage
Génération du modèle
Apprentissage terminée

Si un modèle n’a pas encore généré, l’information « Apprentissage non démarré » est affichée

De plus, certaines erreurs peuvent être levées lors de la création du modèle:

Erreur de communication avec le serveur de prédictions

La génération du modèle sera alors interrompu.

Lorsque la génération s’est déroulée correctement alors on va pouvoir observer que la courbe prédite s’affiche sur le widget (couleur plus claire que les courbe réelle). On peut alors vérifier si notre modèle est correct ou pas en fonction de si la courbe réelle et la courbe prédite se chevauchent (si la période est dans le passé).

Capture d’écran d’un graphe en ligne avec une courbe réelle (rose foncé) et une courbe prédite (rose pâle) (widget Courbe)

2.5.4 Widget Diagramme

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

On peut ajouter un titre au graphique et un commentaire en remplissant les deux formulaires optionnels.

Ensuite, on peut sélectionner la forme du diagramme parmi les trois formes suivantes:

camembert

anneau

polaire

Le champ « Type de valeur » permet de choisir quel type de valeur on souhaite que notre diagramme représente parmi trois options:

si on veut des valeurs ponctuelles (instantanées), cliquer sur « Ponctuelle »
si on veut des valeurs moyennées, cliquer sur « Moyenne ». De nouvelles informations de temporalité sont alors demandées. On a ainsi le choix de calculer les moyennes sur:

si on veut un écart entre deux valeurs, cliquer sur « Écart ». De nouvelles informations de temporalité sont alors demandées. On a ainsi le choix de calculer l’écart entre deux valeurs sur:

Par défaut, des valeurs ponctuelles seront représentées sur le diagramme.

Pour que le diagramme soit construit, il a besoin de valeurs. Pour cela, il faut compléter la partie « Variables ».

Pour chaque variable, sélectionnez l’équipement auquel elle appartient ainsi que son nom dans les menus déroulants.

Si le nom de la variable ne convient pas, on peut le renommer en remplissant le champ « Renommer ».

La variable aura aussi une couleur sur le diagramme. Cette couleur est par défaut bleue (#276cb8) mais est modifiable en cliquant sur le champ « Couleur ». Un sélectionneur de couleur s’affiche.

Information
Il est à noter que la couleur en hexadécimal peut-être écrite dans les cases de couleurs.

Pour ajouter une variable sur le diagramme, cliquez sur + Variable. Un nouvel encart apparaît. Il est à compléter de la même manière qu’explicitée précédemment.

2.5.5 Widget Radar

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

On peut ajouter un titre au graphique et un commentaire en remplissant les deux formulaires optionnels.

Le champ « Type de valeur » permet de choisir quel type de valeur on souhaite que notre radar représente parmi trois options:

si on veut des valeurs ponctuelles (instantanées), cliquer sur « Ponctuelle »
si on veut des valeurs moyennées, cliquer sur « Moyenne ». De nouvelles informations de temporalité sont alors demandées. On a ainsi le choix de calculer les moyennes sur:

– une période statique. Un intervalle de temps avec une date de début et de fin est alors à renseigner
– une période calendaire. En fonction de la période choisie, si on clique sur précédente, l’intervalle s’étendra alors de l’heure, du jour, de la semaine, du mois ou de l’année précédente jusqu’à la date actuelle. En fonction de la période choisie, si on clique sur actuelle, alors la moyenne sera calculée sur l’heure, la journée, la semaine, le mois ou l’année actuelle. Par défaut la période est celle de la journée actuelle
– une période glissante. En fonction de la durée N rentrée et de la période, l’intervalle de temps s’étendra sur les N dernière(s) heure(s), les N dernier(s) jour(s), les N dernière(s) semaine(s), les N dernier(s) mois ou les N dernière(s) année(s)

si on veut un écart entre deux valeurs, cliquer sur « Écart ». De nouvelles informations de temporalité sont alors demandées. On a ainsi le choix de calculer l’écart entre deux valeurs sur:

– une période statique. L’écart sera calculé entre la la date de fin et la date de début renseignés
– une période calendaire. En fonction de la période choisie, si on clique sur actuelle/précédente, alors l’écart sera calculé entre l’heure, la journée, la semaine, le mois ou l’année actuelle/précédente et la date actuelle. Par défaut la date sera celle de la journée actuelle
– une période glissante. L’écart sera alors calculé entre la date actuelle et la N dernière heure, le N dernier jour, la N dernière semaine, le N dernier mois ou la N dernière année

Par défaut, des valeurs ponctuelles seront représentées sur le diagramme.

Les données que le widget va représenter vont être celles d’équipements. Dans la partie « Équipement », sélectionnez dans le menu déroulant du champ « Équipement », l’équipement souhaité.
On peut renommer son nom sur le widget en remplissant le champ « Renommer ». Cependant, ce remplissage est optionnel.
Pour ajouter un axe, cliquez sur + Équipement.

Les axes du diagramme vont être des variables. Dans la partie « Variable », sélectionnez dans le menu déroulant du champ « Variable », la variable souhaitée.
On peut renommer son nom sur le widget en remplissant le champ « Renommer ». Cependant, ce remplissage est optionnel.
Pour ajouter un axe, cliquez sur + Variable.

Information
Le diagramme en radar sert à représenter sur un plan en deux dimensions au moins trois ensembles de données. Il est donc recommandé de sélectionner trois équipements.

Capture d’écran de la fenêtre *popup* de création/modification du widget Radar

Capture d’écran d’un exemple de diagramme Radar

2.5.6 Widget Tableau

Ce widget sert à créer et visualiser un tableau. Plusieurs types de tableaux sont déjà pré-configurés mais on a la possibilité de personnaliser nos propres tableaux en fonction des besoins.

Onglet « Apparence »

Cet onglet permet de configurer l’aspect général du widget et son en-tête.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

On peut ajouter un Titre au graphique et un commentaire en remplissant les deux formulaires optionnels.

Onglet « Données »

Le tableau peut afficher différentes informations en fonction du type de contenu voulu. En cliquant sur le champ « Type de contenu », on a le choix entre les informations sur:

le calendrier
les comptes utilisateurs
les équipements
les procédures
les profils utilisateurs
les reports
les variables

Une fois que l’on a sélectionné le type de contenu, on observe les colonnes par défaut du tableau. Une colonne est représentée dans un encart gris suivant l’exemple:

Capture d’écran d’une colonne de l’onglet « Données » de la fenêtre *popup* du widget Tableau

Le nom de la colonne est écrit dans le champ « Contenu ». On peut sélectionner une autre colonne dans le menu déroulant.

Avertissement
Si on choisit un nouvelle colonne alors il se peut déjà qu’elle soit sélectionnée plus bas. Il est ainsi bien important de visualiser l’ensemble des colonnes pour ne pas se retrouver avec deux fois ou plus la même colonne.

En remplissant, le champ « Renommer », on renomme le nom de la colonne. Cette action est optionnelle et par défaut le nom de la colonne sera celui inscrit dans le champ « Contenu ».

On a aussi la possibilité de choisir la taille de la largeur de la colonne. Par défaut, la taille de la colonne sera ajustée automatiquement mais on peut la changer en cliquant sur « Largeur de la Colonne ». Elle pourra être ainsi:

petite (10%)
moyenne (25%)
grande (50%)

En cochant, « Tronquer la valeur si trop longue » alors le tableau va afficher des variables tronquées dont le nombre de chiffres significatifs dépendra de la taille du widget.

Pour supprimer la colonne, cliquez sur la croix rouge en haut à droite.

Pour changer l’ordre des colonnes, cliquez sur le bouton en haut à droite puis faites glisser la colonne vers l’endroit souhaité.

Pour ajouter une colonne, cliquez sur le bouton
+ COLONNE. Une nouveau encart gris à compléter apparaît.

Chaque type de contenu, il y a des colonnes par défaut et des colonnes additionnelles disponibles (se référer au tableau ci-dessous).

Type de contenu	Colonnes par défaut	Colonnes disponibles
Calendrier	– Catégorie – Équipement – Variable – Commentaire – Date de début – Date de fin – Valeur de début – Valeur de retour – Occurrence	– Catégorie de la variable
Comptes utilisateurs	– Intitulé – Commentaire – Profil	– Activé – Format régional – Adresse email – Numéro de téléphone – Filtre zones – Filtres équipements – Période de disponibilité – Période d’indisponibilité
Équipements	– Index – Type – Intitulé – Zones – Etat de la com. – Alarmes	– Activé – Commentaire – Timeout (en secondes) – Délai de rafraîchissement (en secondes) – Protocole de com. – Port de com. – Numéro d’esclaves
Procédures	– Intitulé – Commentaire – Variables associées – Exécuter au démarrage – Exécuter périodiquement	– Jours de la semaine – Jours du mois – Mois – Heures – Minutes – Secondes – Code
Profils utilisateurs	– Intitulé – Commentaire – Peut administrer le système – Peut gérer les utilisateurs	– Filtre catégories – Peut rafraîchir les équipements – Peut forcer les variables – Peut acquitter les alarmes
Reports	– Intitulé – Commentaire – Type	– Destinataire – Envoyé sur déclenchement d’alarme – Sujet sur déclenchement d’alarme – Message sur déclenchement d’alarme – Envoyer sur arrêt d’alarme – Sujet sur arrêt d’alarme – Message sur arrêt d’alarme – Filtre zones – Filtre équipements – Filtre catégories – Filtre types de variables
Variables	– Équipement – Adresse – Mnémonique – Libellé – Valeur – Dernière variation	– Type – Registre – Commentaire – Interne – Publique – Forçable – Priorité – Valeur de forçage min. – Valeur de forçage max. – Catégories – Format – Précision – Valeur brute min. – Valeur brute max. – Valeur mise à l’échelle min. – Valeur mise à l’échelle max. – Générer des alarmes – Libellé des alarmes – Condition de l’alarme – Générer des événements – Libellé des événements – Condition de l’événement – Historiser les valeurs – Moyenner la courbe – Délai entre deux points (en secondes) – Hystérésis

Tableau des différentes colonnes pour chaque contenu

Information
Pour créer le tableau que l’on souhaite, il faut modifier les colonnes par défaut, ajouter de nouvelle(s) colonne(s) ou bien en supprimer selon les indications explicitées au dessus.

Onglet « Tri & filtre »

Tri par défaut

Pour visualiser la tableau, il est nécessaire de sélectionner une colonne (dans le menu déroulant Colonne) dont les éléments seront triés soit par ordre ascendant ou descendant (dans le menu déroulant Ordre).

Filtre par défaut

Si on souhaite visualiser des éléments précis, on peut filtrer en sélectionnant le ou les attributs de filtrage d’une colonne. Il est tout à fait possible de filtrer sur une ou plusieurs colonnes.

On peut supprimer un attribut en cliquant sur la croix à sa gauche (sur l’attribut même)(par exemple pour supprimer l’attribut AEA Formation, cliquez sur la croix à sa gauche).

Pour exclure un filtre sur une colonne, cliquez sur le bouton

La case de la colonne est alors entourée en rouge

Pour vider un filtre de tous ses attributs, cliquez sur l’icône du balai à droite dans la case filtrée.

Pour chaque type de contenu, on peut filtrer sur différentes colonnes (se référer au tableau ci-dessous).

Contenu	Filtre sur la/les colonnes
Calendrier	– Équipement – Variable – Catégorie
Comptes utilisateurs	– Intitulé – Activé – Commentaire – Profil – Format régional – Adresse email – Numéro de téléphone – Filtre zones – Filtres équipements
Équipements	– Index – Activé – Type – Intitulé – Commentaire – Zones – Timeout (en secondes) – Délai de rafraîchissement (en secondes) – Protocole de com. – Port de com. – Numéro d’esclaves
Procédures	– Intitulé – Commentaire – Variables associées – Exécuter au démarrage – Exécuter périodiquement – Jours de la semaine – Jours du mois – Mois – Heures – Minutes – Secondes – Code
Profils utilisateurs	– Intitulé – Commentaire – Filtre catégories – Peut administrer le système – Peut gérer les utilisateurs – Peut rafraîchir les équipements – Peut forcer les variables – Peut acquitter les alarmes
Reports	– Intitulé – Commentaire – Type – Destinataire – Envoyé sur déclenchement d’alarme – Sujet sur déclenchement d’alarme – Message sur déclenchement d’alarme – Envoyer sur arrêt d’alarme – Sujet sur arrêt d’alarme – Message sur arrêt d’alarme – Filtre zones – Filtre équipements – Filtre catégories – Filtre types de variables
Variables	– Équipement – Type – Mnémonique – Libellé – Catégorie – Valeur

Tableau des colonnes sur lesquelles on peut filtrer en fonction du type de contenu

2.5.7 Widget Alarmes

Ce widget sert à afficher la liste des alarmes qui se sont levées. Ces alarmes peuvent toujours être levées ou bien éteintes. Elles peuvent être aussi acquittées.

Onglet « Apparence »

Cet onglet permet de configurer l’aspect général du widget et son en-tête.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

On peut ajouter un nom au widget et un commentaire en remplissant les deux formulaires optionnels.

En cochant, « Activer le filtre depuis le widget », on débloque les fonctionnalités de filtrage des alarmes sur le widget depuis le mode visualisation.

Onglet « Données »

La liste des alarmes va être présentée sous forme d’un tableau modulable.
Un tableau possède plusieurs colonnes.
Une colonne est représentée dans un encart gris suivant l’exemple suivant:

Le nom de la colonne est écrit dans le champ « Contenu ». On peut sélectionner une autre colonne dans son menu déroulant.

Avertissement
Si on choisit un nouvelle colonne alors il se peut déjà qu’elle soit sélectionnée plus bas. Il est ainsi bien important de visualiser l’ensemble des colonnes pour ne pas se retrouver avec 2 fois ou plus la même colonne.

Le tableau par défaut sera composé de quatre colonnes dont les noms par ordre sont:

Date
Équipement
Variable
Alarme

Une cinquième colonne (Catégorie de la variable) est disponible dans le menu déroulant du champ « Contenu ».

En remplissant, le champ « Renommer », on renomme le nom de la colonne. Cette action est optionnelle et par défaut le nom de la colonne sera celui inscrit dans le champ « Contenu ».

On a aussi la possibilité de choisir la taille de la largeur de la colonne. Par défaut la taille de la colonne sera ajustée automatiquement mais on peut la changer en cliquant sur « Largeur de la Colonne ». Elle pourra être ainsi:

petite (10%)
moyenne (25%)
grande (50%)

En cochant, « Tronquer la valeur si trop longue » alors le tableau va afficher des variables tronquées dont le nombre de chiffre significatif dépendra de la taille du widget.

Pour supprimer la colonne, cliquez sur la croix rouge en haut à droite.

Pour changer l’ordre des colonnes, cliquez sur l’icône à quatre flèches en haut à droite puis faites glisser la colonne vers l’endroit souhaité.

Pour ajouter une colonne, cliquez sur le bouton
+ COLONNE en bas. Une nouveau encart gris à compléter apparaît.

Onglet « Tri & filtre »

Tri par défaut

On a le choix de trier selon cinq colonnes:

Alarme
Catégories de la variable
Date
Équipement
Variable

Filtre par défaut

Si on souhaite visualiser des éléments précis, on peut filtrer en sélectionnant le ou les attributs de filtrage d’une colonne. Il est tout à fait possible de filtrer sur plusieurs colonnes.

On peut supprimer un attribut en cliquant sur la croix à sa gauche (sur l’attribut même)(par exemple pour supprimer l’attribut AEA Formation, cliquez sur la croix à sa gauche).

Le filtre sur une colonne en particulier peut-être mis en place en non. Pour exclure un filtre sur une colonne, cliquez sur le bouton suivant:

La case de la colonne est alors entourée en rouge.

Pour vider un filtre de tous ses attributs, cliquez sur l’icône du balai à droite dans la case filtrée.

Pour le type de contenu calendrier, on peut filtrer sur la/les colonne(s) qui constitue(nt) notre tableau. Ces colonnes sont les mêmes que celles déclarées précédemment dans l’onglet « Données ».

En plus de réaliser un filtrage sur les colonnes, on peut filtrer les alarmes sur une période précise dans la partie « Date ».

Quatre choix de période s’offre à nous:

« Aucune période définie »: toutes les alarmes vont être affichées.
« Période statique »: on doit choisir la date de début et de fin délimitant la période. En cliquant sur la case Date de début ou Date de fin, on a la possibilité de rentrer la date en l’écrivant ou bien en la sélectionnant grâce au sélectionneur de date affiché.

Capture d’écran de la partie « Période statique » de l’onglet « Filtre » de la fenêtre *popup* du widget Alarme

« Période calendaire »: définit un intervalle de temps d’affichage par rapport à la date actuelle ou à la date précédente. On peut choisir d’afficher les alarmes de l’heure, du jour, de la semaine, du mois ou de l’année précédente ou actuelle en sélectionnant dans le menu déroulant la période souhaitée ainsi que le décalage. Par défaut la période est celle de la journée actuelle.

Capture d’écran de la partie « Période calendaire » de l’onglet « Filtre » de la fenêtre *popup* du widget Alarme

« Période glissante »: définit un intervalle de temps des dernier(e)(s) heure(s)/ jour(s)/ semaine(s)/ mois jusqu’à la date actuelle. Pour cela, il suffit de renseigner une durée et un type de période dans le menu déroulant. Par défaut, la période s’étend de hier à aujourd’hui.

Capture d’écran de la partie « Période glissante » de l’onglet « Filtre » de la fenêtre *popup* du widget Alarme

Navigation sur le widget

Filtrage en mode visualisation

Une fois le widget créé, si on a coché « Activer le filtre depuis le widget » alors on peut directement sur le widget filtrer les alarmes en cliquant sur « Filtre » depuis le mode visualisation. On peut filtrer les alarmes sur les colonnes Équipement, Variable et Catégorie.

Si on recherche une ou des alarme(s) précise(s) alors on peut écrire un de leur mot-clé dans le champ « Rechercher » pour que seules les alarmes concernées par ce mot-clé s’affichent.

La période peut aussi être modifié dans la partie « Date ». Les mêmes champs que précédemment sont disponibles.

Une fois le filtrage réalisé, cliquez sur « Appliquer ».

Si on veut ré-initialiser les champs (pour qu’ils soit tous vierges à nouveau), cliquez sur le bouton « Ré-initialisé les champs ».

Capture d’écran du filtrage des événements depuis le widget Alarme

Acquitter une alarme

Acquitter une alarme signifie que l’on a bien remarqué qu’il y avait une alarme. En aucun cas l’alarme va s’éteindre à la suite d’un acquittement. Il faut régler le problème que soulève l’alarme pour qu’elle s’éteigne. L’acquittement est un pense-bête.

Ainsi, quand une alarme se lève, on a la possibilité de l’acquitter en cliquant sur l’icône:

Un message Acquitter apparaît, cliquez y dessus. Une fenêtre popup s’ouvre. On peut y écrire un message (par exemple, « Problème à régler d’ici 2 jours »). Cliquez ensuite sur « Enregistrer ».
Si on s’est trompé et que l’on ne veut pas acquitter l’alarme, il faut cliquer sur « Annuler ».

Tri des colonnes

On peut changer le tri des colonnes, en cliquant sur les flèches haut et bas à coté de la colonne sur laquelle on veut que le tri s’effectue. Par exemple, sur la capture d’écran, on observe les flèches haut et bas à droite de la colonne nommée « Date ».

2.5.8 Widget Événements

Ce widget sert à afficher la liste des événements qui se sont levés sur une certaine période.

Onglet « Apparence »

Cet onglet permet de configurer l’aspect général du widget et son en-tête.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

On peut ajouter un nom au widget et un commentaire en remplissant les deux formulaires optionnels.

En cochant, « Activer le filtre depuis le widget » on débloque les fonctionnalités de filtrage des événements sur le widget depuis le mode visualisation.

Onglet « Données »

La liste des événements va être présentée sous forme d’un tableau modulable.
Un tableau possède plusieurs colonnes.
Une colonne est représentée dans un encart gris suivant l’exemple:

Le nom de la colonne est dans le champ « Contenu ». On peut sélectionner une autre colonne dans son menu déroulant.

Avertissement
Attention, si on choisi un nouvelle colonne alors il se peut déjà qu’elle soit sélectionnée plus bas. Il est ainsi bien important de visualiser l’ensemble des colonnes pour ne pas se retrouver avec 2 fois ou plus la même colonne.

Le tableau par défaut sera composé de 5 colonnes dont les noms par ordre sont:

Date
Équipement
Variable
Libellé
Action

Une sixième colonne (Catégorie de la variable) est disponible dans le menu déroulant du champ « Contenu ».

En remplissant, la case « Renommer », on renomme le nom de la colonne. Cette action est optionnelle et par défaut le nom de la colonne sera celui inscrit dans le champ « Contenu ».

petite (10%)
moyenne (25%)
grande (50%)

En cochant, « Tronquer la valeur si trop longue » alors le tableau va afficher des variables tronquées dont le nombre de chiffre significatif dépendra de la taille du widget.

Pour supprimer la colonne, cliquez sur la croix rouge en haut à droite.

Pour changer l’ordre des colonnes, cliquez sur l’icône à quatre flèches en haut à droite puis faites glisser la colonne vers l’endroit souhaité.

Pour ajouter une colonne, cliquez sur le bouton
+ COLONNE. Une nouveau encart gris à compléter apparaît.

Onglet « Filtre »

Filtre par défaut

Si on souhaite visualiser des éléments précis, on peut filtrer en sélectionnant le ou les attributs de filtrage d’une colonne. Il est tout à fait possible de filtrer sur plusieurs colonnes.

On peut supprimer un attribut en cliquant sur la croix à sa gauche (sur l’attribut même)(par exemple pour supprimer l’attribut AEA Formation, cliquez sur la croix à sa gauche).

Le filtre sur une colonne en particulier peut-être mis en place en non. Pour exclure un filtre sur une colonne, cliquez sur le bouton suivant:

La case de la colonne est alors entourée en rouge

Pour vider un filtre de tous ses attributs, cliquez sur l’icône du balai à droite dans la champ filtré.

Pour le type de contenu calendrier, on peut filtrer sur les colonnes:

Équipement
Variable
Catégorie.

En plus de réaliser un filtrage sur les colonnes, on peut filtrer les évènement sur une période précise dans la partie « Date ».

Quatre choix de période s’offre à nous:

« Aucune période définie »: toutes les alarmes vont être affichées.
« Période statique »: on doit choisir la date de début et de fin délimitant la période. En cliquant sur le champ « Date de début » ou « Date de fin », on la possibilité de rentrer la date en l’écrivant au format jj-mm-aaaa hh:mm (jour/mois/année heure:minute) ou bien en la sélectionnant grâce au sélectionneur de date qui s’affiche.

Capture d’écran de la partie « Période statique » de l’onglet « Filtre » de la fenêtre *popup* du widget Événement

« Période calendaire »: définit un intervalle de temps d’affichage par rapport à la date actuelle ou à la date précédente. On peut choisir d’afficher les événements de l’heure, du jour, de la semaine, du mois ou de l’année précédente ou actuelle en sélectionnant dans le menu déroulant la période souhaitée ainsi que le décalage. Par défaut la période est celle de la journée actuelle.

Capture d’écran de la partie « Période calendaire » de l’onglet « Filtre » de la fenêtre *popup* du widget Événement

« Période glissante »: définit un intervalle de temps des dernier(e)(s) heure(s)/ jour(s)/ semaine(s)/ mois jusqu’à la date actuelle. Pour cela, il suffit de renseigner une durée et un type de période dans le menu déroulant. Par défaut, la période s’étend de hier à aujourd’hui.

Capture d’écran de la partie « Période glissante » de l’onglet « Filtre » de la fenêtre *popup* du widget Événement

Information
Il est à noter que les événements sont triés par ordre chronologique.

Capture d’écran de l’onglet « Filtre » de la fenêtre *popup* de création/modification du widget Événement

Navigation sur le widget

Une fois le widget créé, si on a coché « Activer le filtre depuis le widget » alors on peut directement sur le widget filtrer les événement en cliquant sur « Filtre ». On peut filtrer sur les colonnes Équipement, Variable et/ou Catégorie.

Si on recherche un ou des événement(s) précis alors on peut écrire un de leur mot-clé dans le champ « Rechercher » pour que seuls les évènements concernés par ce mot-clé s’affichent.

La période peut aussi être modifiée dans la partie « Date ». Les mêmes champs que précédemment sont disponibles.

Une fois le filtrage réalisé, cliquez sur « Appliquer ».

Si on veut ré-initialiser les champs (pour qu’ils soient tous vierges à nouveau), cliquez sur « Ré-initialisé les champs ».

Capture d’écran du filtrage des événements depuis le widget Évènement

2.6 Catégorie de widgets : Pilotage

2.6.1 Widget Bouton

Ce widget permet de créer un bouton qui tant qu’il est actif va modifier la valeur d’une variable.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

Un bouton est lié à une variable. Choisissez ainsi l’équipement dans le menu déroulant des « Équipements » et le nom de la variable souhaitée dans le menu déroulant « Variable ».

Quand le bouton sera activé, la variable va prendre une nouvelle valeur. Cette nouvelle valeur est à écrire dans le champ du même nom. Seules les variables autorisées à être forcées sont sélectionnables.

On a la possibilité d’ajouter un nom au bouton. Ce nouvel intitulé est à écrire dans le champ « Libellé » mais cette démarche est optionnelle. Ce nouveau nom se placera à droite sur le bouton.

A sa gauche, le bouton est marqué d’une icône. Par défaut, l’icône affiché sera celle d’un fichier.
On peut modifier cette icône, en en sélectionnant une autre en cliquant sur le champ « Icône ». Cette démarche est optionnelle.

La couleur de fond du bouton par défaut est bleu (#01a49e). On peut la changer facilement en cliquant sur le champ « Couleur du fond ». Un sélectionneur de couleur apparaît. Cette démarche est optionnelle.

On peut aussi changer la couleur du texte en cliquant sur le champ « Couleur du texte ». Un sélectionneur de couleur apparaît alors permettant de faire notre choix parmi un grand nombre de couleurs.

Information
Il est à noter que la couleur en hexadécimal peut-être écrite dans les cases de couleurs.

La taille de l’affichage du bouton est réglable:

le bouton sera petit si vous cochez « Petite »
le bouton sera de taille normale si vous cochez « Moyenne »
le bouton sera de grande taille si vous cochez « Grande »

Par défaut la taille est cochée à moyenne.

Capture d’écran de la fenêtre *popup* de création/modification du widget Bouton

2.6.2 Widget Interrupteur

Ce widget permet de créer un interrupteur qui lorsqu’il est allumé (état ON) modifie la valeur d’une variable. Lorsque le bouton est éteint, la variable aura la valeur de son état OFF.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

Un interrupteur est lié à une variable. Choisissez ainsi l’équipement dans le menu déroulant des « Équipements » et le nom de la variable souhaitée dans le menu déroulant « Variable ».

Quand l’interrupteur est éteint (état OFF), la variable prendra une valeur par défaut. Cette nouvelle valeur est à écrire dans le champ « Valeur de l’état OFF ». Seules les variables autorisées à être forcées sont sélectionnables.
On a la possibilité de donner un intitulé à cet état. Cet intitulé est à écrire dans le champs « Libellé de l’état OFF » mais cette démarche est optionnelle.
De plus, pour être plus visible, il est possible de colorer le bouton lorsqu’il est dans cet état en choisissant une couleur dans le sélectionneur de couleurs du champs « Couleur de l’état OFF ». La couleur de fond du bouton par défaut est gris (#f1f1f1). Cette démarche est optionnelle aussi.

Quand l’interrupteur est allumé (état ON), la variable prendra une valeur par défaut. Cette nouvelle valeur est à inscrire dans le champ « Valeur de l’état ON ». Seules les variables autorisées à être forcées sont sélectionnables.
On a la possibilité de donner un intitulé à cet état. Cet intitulé est à écrire dans le champs « Libellé de l’état ON » mais cette démarche est optionnelle.
De plus, pour être plus visible, il est possible de colorer le bouton lorsqu’il est dans cet état en choisissant une couleur dans le sélectionneur de couleurs du champs « Couleur de l’état ON ». La couleur de fond du bouton par défaut est bleu (#01a49e). Cette démarche est optionnelle aussi.

Information
Il est à noter que la couleur en hexadécimal peut-être écrite dans les cases de couleurs.

La taille de l’affichage du bouton est réglable:

le bouton sera petit si vous cochez « Petite »
le bouton sera de taille normale si vous cochez « Moyenne »
le bouton sera de grande taille si vous cochez « Grande »

Par défaut la taille est cochée à moyenne.

interrupteur configuration — Capture d’écran de la fenêtre *popup* de création/modification du widget Interrupteur

2.6.3 Widget Calendrier

Ce widget sert à afficher un calendrier sur une journée, sur une semaine ou sur un mois.
A l’aide du calendrier, on va pouvoir déclarer des événements.

La largeur du widget est par défaut à 1/1 – Pleine largeur (100 %). Il est possible de la diminuer en sélectionnant une autre largeur parmi la liste suivante:

¼ – Quart de largeur (25%)
⅓ – Tiers de largeur (33%)
½ – Demi largeur (50%)
⅔ – Tiers de largeur (67%)
¾ – Trois quarts de largeur (75%)

On peut ajouter un Titre au calendrier et un commentaire en remplissant les deux formulaires optionnels.

Un événement appartient à une catégorie. Pour créer une catégorie sur le calendrier, il suffit de renseigner le code de la catégorie voulu dans « Code_catégorie » dans la partie « Catégories d’évènements ». Chaque catégorie sera dans un cadre gris.
On peut renommer ce code par un autre nom dans la case « Renommer(optionnel) ». Tous les événements appartenant à cette catégorie seront représentées par une couleur. Cette dernière est modifiable en cliquant sur le champ « Couleur des événements ». Par défaut elle est bleue (#276cb8).
Si on veut rajouter une nouvelle catégorie, cliquez sur + CATEGORIE. Un nouveau cadre gris apparaît. Il est à remplir comme le précédent.

Capture d’écran de l’onglet « Apparence » de la fenêtre *popup* de création/modification du widget Calendrier

Navigation sur le widget

En mode visualisation, plusieurs fonctionnalités s’offrent à nous.

Programmation d’un événement

Pour programmer un nouvel événement, cliquez sur le bouton « Programmer » en haut à droite. La fenêtre popup suivante s’ouvre:

L’événement que l’on va créer peut appartenir à une catégorie. Remplissez alors le champ « Catégorie » avec le nom de la catégorie voulu ou bien sélectionnez la catégorie parmi celles proposées. Tous les événements de la même catégorie auront ainsi la même couleur. Il faut savoir que si on ne remplit pas cette case alors l’événement sera classé dans aucune catégorie mais sera colorié tout de même par une couleur. Tous les événements n’ayant pas de catégorie auront la même couleur.

Un événement est levé sur une variable. Choisissez donc l’équipement dans le menu déroulant des « Équipements » et le nom de la variable souhaitée dans le menu déroulant « Variable ».

Lorsqu’un événement se produit, la variable va avoir une nouvelle valeur. Par exemple, 1 pour signifier l’allumage de l’éclairage. Cette valeur sera écrite dans le champ Valeur de début. Il est à noter que si la valeur est une chaîne de caractères alors elle est à mettre entre guillemets (“….”).

Lorsque l’événement est terminé, on peut choisir d’affecter une nouvelle valeur à la variable. Cette valeur sera renseignée dans le champ « Valeur de retour ». Elle est optionnelle et si on laisse cette case vide alors la valeur de la variable sera la même que celle avant l’événement.

Un événement sera levé pendant une période de temps définie ayant une date de début et une date de fin. La date de début est à renseignée dans le champ « Date de début » sous la format jj/mm/aaaa hh:mm (jour/mois/année heure:minute). En cliquant sur ce champ, on a la possibilité de choisir une date grâce à un sélectionneur de date.
En cochant la case « Toute la journée », l’événement sera levé la journée entière de la date de début rentrée.
Pour que l’événement se termine, rentrez une date de fin dans le champ « Date de fin » sous le format jj/mm/aaaa hh:mm (jour/mois/année heure:minute). En cliquant sur ce champ, on a la possibilité de choisir une date grâce à un sélectionneur de date. Le remplissage de cette case est optionnel. Si on n’indique aucune valeur de date de fin alors l’événement sera levé de la date de début jusqu’à une durée indéterminée.

Par défaut, l’événement apparaîtra une seule fois. Mais si vous souhaitez rendre cet événement récurrent, dans le champ « Occurrence » sélectionnez une nouvelle occurrence parmi:

chaque jour
chaque semaine
chaque mois
chaque année

Enfin, l’événement peut-être estampillé d’un commentaire écrit dans le champ « Commentaire ».

Enfin, pour créer la programmation de l’événement cliquer sur le bouton « Enregistrer »

Modification de la programmation d’un événement

Une autre fonctionnalité du calendrier est la modification d’événement. Pour modifier la programmation d’un événement, cliquez sur l’événement voulu sur le calendrier. Une fenêtre popup nommé « Modifier une programmation » s’ouvre. Les mêmes champs que pour la création d’un événement sont affichés. Pour modifier l’événement, il suffit de changer les champs voulus (vous référez à la partie « Programmation d’un événement » pour les informations de ces champs).

Dans cette fenêtre, il est possible de supprimer l’événement, en cochant « Supprimer la programmation ». Cette action est irréversible. Une fois cochée, on peut indiquer quelle programmation on souhaite supprimer:

soit uniquement l’événement que l’on a sélectionné
soit cet événement et les suivants c’est à dire que si l’événement est un événement récurrent alors les suivants ainsi que celui ci vont être supprimés
soit tous les événements passés et futurs ainsi que celui-ci vont être supprimés

Capture d’écran de la partie suppression d’un événement de la fenêtre *popup* de modification d’un événement du widget Calendrier

Cliquer à nouveau sur le bouton « Enregistrer » pour sauvegarder les modifications.

Information
Si l’événement modifié est un événement récurrent alors la modification sera affectée sur tous les autres événements.

Filtrage de événements

Une autre fonctionnalité du calendrier est le filtrage des événements. En haut à droite, on peut faire apparaître/disparaître une catégorie d’événements en cliquant sur le nom de la catégorie. On peut faire apparaître/disparaître autant de catégories que l’on veut.

Visualisation jour, semaine ou mois

Trois types de visualisation des événements sont possibles.

La vue par défaut est la vue par semaine.

Capture d’écran d’une vue semaine sur le widget Calendrier

Pour visualiser plus précisément, les événements d’une journée, cliquez sur le date voulue (par exemple, Mar. 30/08).

Capture d’écran d’une vue jour sur le widget Calendrier

Pour repasser, sur une visualisation à la semaine depuis une visualisation à la journée, cliquez sur le numéro de la semaine au dessus de la date (par exemple ici 35).

Pour visualiser les événements sur un mois entier, il faut d’abord avoir une vue par semaine, puis cliquez sur le mois au dessus des dates(par exemple sur notre capture d’écran Août 2022).

Capture d’écran d’une vue mois sur le widget Calendrier

Pour revenir sur une vue semaine, il suffit de cliquer sur le numéro de la semaine que l’on souhaite sur la gauche (sur la capture d’écran ci-dessus, les numéro de semaines disponibles sont 31, 32, 33, 34 et 35).

On peut passer d’une journée à une autre, d’une semaine à une autre ou d’un mois à un autre en cliquant sur les flèches vertes en haut à gauche et à droite.

3. Présentation de l’API

3.1 Généralités

Ce document détaille les requêtes HTTP permettant à l’utilisateur d’interagir avec MicroSERVER au travers de fonctions, fournissant ainsi une interface de communication entre le serveur Web et d’autres services externes.

Information
La documentation n'informe que sur les tables "devices" et "variables" et sur la lecture des données historisées. Cependant, le même raisonnement s'applique aux autres tables de la base de données.

3.2 Fonctions

3.2.1 Headers

Tout d’abord, chaque requête aura un paramètre ‘headers’. Afin de bien s’authentifier sur l’API, on a besoin d’une clé API (api_key). Cette clé sera par la suite utilisée dans la requête en l’appelant de cette manière:

headers={'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)}

3.2.2 Méthode GET

Grace à l’API de MicroSERVER, il est possible d’obtenir des informations sur les tables:

les variables (variables)
les équipements (devices)

Il est aussi possible d’obtenir des informations sur des données historisées:

les événements (events)
les alarmes (alarms)
les valeurs historisées (plot-values)
les compteurs historisés (diff-values)
les données historiques brutes (log-entries)

Information
Les données sont remontées sous format JSON. Les exemples ont été réalisés en Python mais on peut utiliser d'autres langages pour envoyer des requêtes à l'API.

3.2.2.1 Variables

Pour obtenir la liste des variables, la requête HTTP sera:

/variables

Cette requête peut recevoir plusieurs paramètres supplémentaires afin d’avoir des informations plus précises. Les paramètres qui ne prendront qu’une valeur seront identifiés par param=VALUE et les paramètres qui peuvent prendre une liste de valeurs seront identifiés par param[]=VALUES:

Paramètre	Description
limit=VALUE	Nombre d’éléments (VALUE) à renvoyer au maximum
sort=VALUE(,asc/desc) ou sort[]=VALUES(,asc/desc)	Tri sur VALUE de manière ascendante (,asc) ou descendante (,desc). Il est possible de trier sur plusieurs champs VALUES
field=VALUE ou field[]=VALUES	Filtrage sur le champs VALUE ou les champs VALUES voulus
search=VALUE	Renvoie uniquement les éléments dont n’importe quel champ contient le texte VALUE
search~x=VALUE	Renvoie uniquement les éléments dont n’importe quel champ ne contient pas le texte VALUE
cursor=VALUE	Valeur du champ ‘cursor’ renvoyé lors de la dernière requête avec le paramètre limit=VALUE défini afin d’obtenir la suite des éléments
champ=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur égale à la valeur VALUE spécifiée.
champ~x=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur égale à la valeur VALUE spécifiée.
champ~s=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur contenant la valeur VALUE spécifiée.
champ~sx=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur contenant la valeur VALUE spécifiée.
champ~i=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur se situant dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.
champ~ix=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur ne se situant pas dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.

Tableau sur les paramètres d’une requête GET variables

Pour les variables, la liste des champs possibles est:

Nom du champs	Description
id	Identifiant de la variable
deviceId	Identifiant de l’équipement
device	Nom de l’équipement
displayLabel	Valeur de le la représentation de la variable
address	Adresse de la variable
type	Type de la variable
intRegister	Adresse de la variable
priority	Priorité de la variable
mnemonic	Mnémonique de la variable
label	Libellé de la variable
comment	Commentaire
isInternal	Booléen indiquant si la variable est interne ou pas
isPublic	Booléen indiquant si la variable est publique ou pas
isWriteable	Booléen indiquant si la variable peut être écrite ou pas
minWriteValue	Valeur minimale que peut prendre la variable
maxWriteValue	Valeur maximale que peut prendre la variable
categories	Catégories dont fait partie la variable
format	Format de la variable
log	Booléen indiquant si le changement de valeur historise l’ancienne valeur
floatPrecision	Entier indiquant le nombre de chiffre significatif après la virgule. 0 si la variable n’est pas un décimale.
unit	Unité de la variable. Si aucune unité alors » est retourné.
minRemoteScaleValue	Valeur minimale brute
maxRemoteScaleValue	Valeur maximale brute
minLocalScaleValue	Valeur minimale lors de la mise à l’échelle
maxLocalScaleValue	Valeur maximale lors de la mise à l’échelle
inhibitionUser	Utilisateur ayant inhibé l’alarme
inhibitionStartTime	Date de début de l’inhibition
inhibitionStopTime	Date de fin de l’inhibition
hasAlarm	Booléen autorisant la gestion des alarmes
alarmLabel	Libellé de l’alarme
alarmCondition	Condition de l’alarme
hasEvent	Booléen autorisant la gestion des événements
eventLabel	Libellé de l’événement
eventCondition	Condition de l’événement
hasPlot	Booléen autorisant l’historisation des valeurs
plotIsAveraged	Booléen autorisant de moyenner la courbe
plotMinDelay	Délai entre deux points en secondes sur la courbe
plotMinDiff	Hystérésis de la variable
snmpOID	Adresse SNMP de la variable
snmpType	Type SNMP de la variable
rawValue	Valeur actuelle de la variable
displayValue	Valeur formatée de la variable

Tableau sur les champs disponibles pour une variable

Par défaut, toutes les valeurs seront retournées avec tous les champs dont le tri sera par ordre chronologique de création de variables.

Un exemple de requête HTTP est:

https://192.168.1.223/variables?limit=2&field[]=id&field[]=mnemonic

Le code écrit en python sera le suivant:

query = 'variables'
query = {'limit': 2, 'field[]': ['id', 'mnemonic']}
req = requests.get(SERVER_URI + query, params=param, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
if req.status_code == 200:
    print('OK')
    data = req.json()
    print(data)
else:
    print('ERR:', req.json())

La réponse à cette requête est:

{'items': [{'id': '6', 'mnemonic': 'ALM_COM@1'}, {'id': '7', 'mnemonic': 'BUSY_COM@1'}], 'cursor': '{"field":["id","mnemonic"],"lastValues":["7"]}'}

Information
Dans la réponse à la requête on s'aperçoit qu'il y a une clé 'cursor' en plus des items renvoyés. Cette clé signifie qu'il y a d'autres données en plus de celle renvoyé dans la réponse et que la dernière valeur renvoyée a l'id 7 ("lastValues":["7"]) et que la réponse contient les champs 'id' et 'mnemonic' ("field":["id","mnemonic"]).

3.2.2.2 Équipements

Pour obtenir la liste des équipements, la requête HTTP sera:

/devices

Paramètre	Description
limit=VALUE	Nombre d’éléments (VALUE) à renvoyer au maximum
sort=VALUE(,asc/desc) ou sort[]=VALUES(,asc/desc)	Tri sur VALUE de manière ascendante (,asc) ou descendante (,desc). Il est possible de trier sur plusieurs champs VALUES
field=VALUE ou field[]=VALUES	Filtrage sur le champs VALUE ou les champs VALUES voulus
search=VALUE	Renvoie uniquement les éléments dont n’importe quel champ contient le texte VALUE
search~x=VALUE	Renvoie uniquement les éléments dont n’importe quel champ ne contient pas le texte VALUE
cursor=VALUE	Valeur du champ ‘cursor’ renvoyé lors de la dernière requête avec le paramètre limit=VALUE défini afin d’obtenir la suite des éléments
champ=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur égale à la valeur VALUE spécifiée.
champ~x=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur égale à la valeur VALUE spécifiée.
champ~s=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur contenant la valeur VALUE spécifiée.
champ~sx=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur contenant la valeur VALUE spécifiée.
champ~i=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur se situant dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.
champ~ix=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur ne se situant pas dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.

Tableau sur les paramètres d’une requête GET devices

Pour les équipements, la liste des champs possibles est:

Nom du champs	Description
id	Identifiant de l’équipement
isActive	Booléen indiquant si l’équipement est actif (1) ou en erreur (0)
type	Type de l’équipement
name	Nom de l’équipement
comment	Commentaire
displayLabel	Valeur de le la représentation de l’équipement
zones	Zone(s) de l’équipement
purgeDelay	Délai de purge des historiques (en jours)
timeout	Timeout (en secondes)
refreshDelay	Délai de rafraîchissement (en secondes)
comProtocol	Protocole de communication utilisé
comPort	Port de communication utilisé
slaveNumber	Numéro d’esclave. None pour aucun.
password	Mot de passe de l’équipement
comState	État de la communication
alarms	Nombre d’alarmes actives
isEditable	Booléen indiquant si l’équipement est modifiable par un utilisateur

Tableau sur les champs disponibles pour un équipement

Par défaut, toutes les valeurs seront retournées avec tous les champs dont le tri sera par ordre chronologique de création d’équipements.

Un exemple de requête HTTP est:

https://192.168.1.223/devices?limit=2&field[]=id&field[]=isActive&field[]=type

Le code écrit en python sera le suivant:


query = 'devices'
param = {'limit': 2, 'field[]': ['id', 'isActive', 'type']}
req = requests.get(SERVER_URI + query, params=param, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
if req.status_code == 200:
    print('OK')
    data = req.json()
    print(data)
else:
    print('ERR:', req.json())

La réponse à cette requête est:

{'items': [{'id': '1', 'isActive': True, 'type': 'AEH10000'}, {'id': '2', 'isActive': True, 'type': 'Surveillance poulailler'}], 'cursor': '{"field":["id","isActive","type"],"lastValues":["2"]}'}

3.2.2.3 Alarmes

Pour obtenir la liste des alarmes, la requête HTTP sera:

/alarms

Paramètre	Description
limit=VALUE	Nombre d’éléments (VALUE) à renvoyer au maximum
sort=VALUE(,asc/desc) ou sort[]=VALUES(,asc/desc)	Tri sur VALUE de manière ascendante (,asc) ou descendante (,desc). Il est possible de trier sur plusieurs champs VALUES
field=VALUE ou field[]=VALUES	Filtrage sur le champs VALUE ou les champs VALUES voulus
search=VALUE	Renvoie uniquement les éléments dont n’importe quel champ contient le texte VALUE
search~x=VALUE	Renvoie uniquement les éléments dont n’importe quel champ ne contient pas le texte VALUE
cursor=VALUE	Valeur du champ ‘cursor’ renvoyé lors de la dernière requête avec le paramètre limit=VALUE défini afin d’obtenir la suite des éléments
champ=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur égale à la valeur VALUE spécifiée.
champ~x=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur égale à la valeur VALUE spécifiée.
champ~s=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur contenant la valeur VALUE spécifiée.
champ~sx=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur contenant la valeur VALUE spécifiée.
champ~i=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur se situant dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.
champ~ix=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur ne se situant pas dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.

Tableau sur les paramètres d’une requête GET alarms

Nom du champs	Description
id	Identifiant de l’alarme
time	Timestamp auquel l’alarme s’est levée
variableId	Identifiant de la variable
variable	Nom de la variable
variableCategories	Catégories de la variable
deviceId	Identifiant de l’équipement
device	Nom de l’équipement
label	Libellé de l’alarme
isAck	Booléen indiquant si l’alarme a été acquittée ou non
ackTime	Timestamp auquel l’alarme a été acquittée
ackUser	Nom de l’utilisateur qui a acquitté l’alarme
ackComment	Commentaire laissé lors de l’acquittement de l’alarme

Tableau sur les champs disponibles pour une alarme

Par défaut, toutes les valeurs seront retournées avec tous les champs dont le tri sera par ordre chronologique d’apparition d’alarmes.

Un exemple de requête HTTP est:

https://192.168.1.223/alarms?limit=2&sort=time,desc&field[]=id&field[]=time

Le code écrit en python sera le suivant:


query = 'alarms'
param = {'sort': 'time,desc', 'limit': 2, 'isActive': True, 'field[]': ['id', 'time']}
req = requests.get(SERVER_URI + query, params=param, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
if req.status_code == 200:
    print('OK')
    data = req.json()
    print(data)
else:
    print('ERR:', req.json())

La réponse à cette requête est:

{'items': [{'id': '270953256', 'time': 1660202056.43676}, {'id': '270953231', 'time': 1660202054.86892}], 'cursor': '{"sort":"time,desc","isActive":"True","field":["id","time"],"lastValues":[1660202054.86892,"270953231"]}'}

3.2.2.4 Événements

Pour obtenir la liste des événements, la requête HTTP sera:

/events

Paramètre	Description
limit=VALUE	Nombre d’éléments (VALUE) à renvoyer au maximum
sort=VALUE(,asc/desc) ou sort[]=VALUES(,asc/desc)	Tri sur VALUE de manière ascendante (,asc) ou descendante (,desc). Il est possible de trier sur plusieurs champs VALUES
field=VALUE ou field[]=VALUES	Filtrage sur le champs VALUE ou les champs VALUES voulus
search=VALUE	Renvoie uniquement les éléments dont n’importe quel champ contient le texte VALUE
search~x=VALUE	Renvoie uniquement les éléments dont n’importe quel champ ne contient pas le texte VALUE
cursor=VALUE	Valeur du champ ‘cursor’ renvoyé lors de la dernière requête avec le paramètre limit=VALUE défini afin d’obtenir la suite des éléments
champ=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur égale à la valeur VALUE spécifiée.
champ~x=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur égale à la valeur VALUE spécifiée.
champ~s=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur contenant la valeur VALUE spécifiée.
champ~sx=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur contenant la valeur VALUE spécifiée.
champ~i=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur se situant dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.
champ~ix=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur ne se situant pas dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.

Tableau sur les paramètres d’une requête GET events

Nom du champs	Description
time	Timestamp d’apparition de l’évènement
deviceId	Identifiant de l’équipement
device	Nom de l’équipement
variableId	Identifiant de la variable
variable	Nom de la variable
variableCategories	Catégories de la variable
label	Libellé de l’événement
action	Action de l’événement (passage de telle valeur à telle valeur)

Tableau sur les champs disponibles pour un événement

Par défaut, toutes les valeurs seront retournées avec tous les champs dont le tri sera par ordre chronologique d’apparition d’événements.

Un exemple de requête HTTP est:

https://192.168.1.223/events?limit=2&field[]=variableId&field[]=time

Le code écrit en python sera le suivant:


query = 'events'
param = {'limit': 2, 'field[]': ['variableId', 'time']}
req = requests.get(SERVER_URI + query, params=param, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
if req.status_code == 200:
    print('OK')
    data = req.json()
    print(data)
else:
    print('ERR:', req.json())

La réponse à cette requête est:

{'items': [{'variableId': '62238', 'time': -1755053102}, {'variableId': '62268', 'time': -1755053102}], 'cursor': '{"field":["variableId","time"],"lastValues":[-1755053102,"62268"]}'}

3.2.2.5 Valeurs historisées

Pour obtenir la liste des valeurs historisées, la requête HTTP sera:

/plot-values

Paramètre	Description
limit=VALUE	Nombre d’éléments (VALUE) à renvoyer au maximum
sort=VALUE(,asc ou sort[]=VALUES	Tri sur VALUE de manière ascendante (,asc) ou descendante (,desc). Il est possible de trier sur plusieurs champs VALUES
field=VALUE ou field[]=VALUES	Filtrage sur le champs VALUE ou les champs VALUES voulus
search=VALUE	Renvoie uniquement les éléments dont n’importe quel champ contient le texte VALUE
search~x=VALUE	Renvoie uniquement les éléments dont n’importe quel champ ne contient pas le texte VALUE
cursor=VALUE	Valeur du champ ‘cursor’ renvoyé lors de la dernière requête avec le paramètre limit=VALUE défini afin d’obtenir la suite des éléments
avgValues=VALUE	Renvoie des valeurs moyennée (VALUE=1) ou pas (VALUE=0). Par défaut, les valeurs ne sont pas moyennées.
nbValues=VALUE	Renvoie VALUE valeurs avec un pas de temps égal entre les valeurs
champ=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur égale à la valeur VALUE spécifiée.
champ~x=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur égale à la valeur VALUE spécifiée.
champ~s=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur contenant la valeur VALUE spécifiée.
champ~sx=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur contenant la valeur VALUE spécifiée.
champ~i=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur se situant dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.
champ~ix=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur ne se situant pas dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.

Tableau sur les paramètres d’une requête GET plot-values

Note
Il est important de savoir qu'il est indispensable de mettre le paramètre variableId=VALUE, 'time~i'=[...;...] et nbValues=VALUE (ou variableId=VALUE et 'time': [..., ...,...]) pour obtenir des valeurs historisées. Si on ne met pas un de ces paramètre alors aucune valeur historisée ne va être renvoyée.
Il est à noter aussi que l'on ne peut réaliser une requête plot-values que sur une variable.

Nom du champs	Description
time	Timestamp de stockage de la valeur
rawValue	Valeur brute de la variable
displayValue	Valeur tronquée de la variable

Tableau sur les champs disponibles pour une valeur historisée

Un exemple de requête HTTP est:

https://192.168.1.223/plot-values?variableID=19212&time~i=[1634680800; 1653516000[&nbValues=10&avgValues=1&sort=time,asc

Le code écrit en python sera le suivant:


query = 'plot-values'
param = {'variableId': 19212, 'time~i': '[1634680800; 1653516000[', 'nbValues': 10, 'avgValues': 1, 'sort': 'time,asc', 'limit': 5, 'displayValue~x':'2.099'}
req = requests.get(SERVER_URI + query, params=param, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
if req.status_code == 200:
    print('OK')
    data = req.json()
    print(data)
else:
    print('ERR:', req.json())

La réponse à cette requête est:

{"items":[{"time":1638447840,"rawValue":2823.39497961264,"displayValue":"2823.395"},{"time":1640331360,"rawValue":4458.263155687225,"displayValue":"4458.263"},{"time":1642214880,"rawValue":2.2232299099558275,"displayValue":"2.223"},{"time":1644098400,"rawValue":12454.150091318386,"displayValue":"12454.15"},{"time":1645981920,"rawValue":6610.666512168708,"displayValue":"6610.667"}],
"cursor":"{\"variableId\":\"19212\",\"time~i\":\"[1634680800; 1653516000[\",\"nbValues\":\"10\",\"avgValues\":\"1\",\"sort\":\"time,asc\",\"displayValue~x\":\"2.099\",\"lastValues\":[1645981920]}"}

3.2.2.6 Compteurs historisés

Pour obtenir la liste des compteurs historisés, la requête HTTP sera:

/diff-values

Cette requête peut recevoir plusieurs paramètres supplémentaires afin d’avoir des informations plus précises. Les paramètres qui ne prendront qu’une valeur seront identifié par param=VALUE et les paramètres qui peuvent prendre une liste de valeurs seront identifiés par param[]=VALUES:

limit=VALUE	Nombre d’éléments (VALUE) à renvoyer au maximum
sort=VALUE(,asc/desc) ou sort[]=VALUES(,asc/desc)	Tri sur VALUE de manière ascendante (,asc) ou descendante (,desc). Il est possible de trier sur plusieurs champs VALUES
field=VALUE ou field[]=VALUES	Filtrage sur le champs VALUE ou les champs VALUES voulus
search=VALUE	Renvoie uniquement les éléments dont n’importe quel champ contient le texte VALUE
search~x=VALUE	Renvoie uniquement les éléments dont n’importe quel champ ne contient pas le texte VALUE
cursor=VALUE	Valeur du champ ‘cursor’ renvoyé lors de la dernière requête avec le paramètre limit=VALUE défini afin d’obtenir la suite des éléments
avgValues=VALUE	Renvoie des valeurs moyennée (VALUE=1) ou pas (VALUE=0). Par défaut, les valeurs ne sont pas moyennées.
nbValues=VALUE	Renvoie VALUE valeurs avec un pas de temps égal entre les valeurs
champ=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur égale à la valeur VALUE spécifiée.
champ~x=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur égale à la valeur VALUE spécifiée.
champ~s=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur contenant la valeur VALUEspécifiée.
champ~sx=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur contenant la valeur VALUE spécifiée.
champ~i=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur se situant dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.
champ~ix=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur ne se situant pas dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.

Tableau sur les paramètres d’une requête GET diff-values

Note 
Il est important de savoir qu'il est indispensable de mettre le paramètre variableId=VALUE, time~i=[...;...] et nbValues=VALUE pour obtenir des valeurs historisées. Si on ne met pas un de ces paramètre alors aucune valeur historisée ne va être renvoyée.

Nom du champs	Description
time	Timestamp de stockage de la valeur
rawValue	Valeur brute de la variable
displayValue	Valeur tronquée de la variable

Tableau sur les champs disponibles pour un compteur historisé

Un exemple de requête HTTP est:

https://192.168.1.223/diff-values?variableId=19212&nbValues=4&time~i=[1634680800; 1653516000[

Le code écrit en python sera le suivant:


query = 'diff-values'
param= {'variableId': 19212, 'time~i': '[1634680800; 1653516000[', 'nbValues': 4}
req = requests.get(SERVER_URI + query, params=param, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
if req.status_code == 200:
    print('OK')
    data = req.json()
    print(data)
else:
    print('ERR:', req.json())

La réponse à cette requête est:

{'items': [{'time': 1640959200, 'rawValue': 545510, 'displayValue': '545510'}, {'time': 1647237600, 'rawValue': 1035737, 'displayValue': '1035737'}, {'time': 1653516000, 'rawValue': 109394, 'displayValue': '109394'}]}

3.2.2.7 Données historiques brutes

Pour obtenir la liste des historiques brutes, la requête HTTP sera:

/log-entries

Avertissement
Cette requête est à utiliser avec précaution car elle permet notamment d'envoyer les données brutes vers un autre serveur.

limit=VALUE	Nombre d’éléments (VALUE) à renvoyer au maximum
sort=VALUE(,asc/desc) ou sort[]=VALUES(,asc/desc)	Tri sur VALUE de manière ascendante (,asc) ou descendante (,desc). Il est possible de trier sur plusieurs champs VALUES
field=VALUE ou field[]=VALUES	Filtrage sur le champs VALUE ou les champs VALUES voulus
search=VALUE	Renvoie uniquement les éléments dont n’importe quel champ contient le texte VALUE
search~x=VALUE	Renvoie uniquement les éléments dont n’importe quel champ ne contient pas le texte VALUE
cursor=VALUE	Valeur du champ ‘cursor’ renvoyé lors de la dernière requête avec le paramètre limit=VALUE défini afin d’obtenir la suite des éléments
champ=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur égale à la valeur VALUE spécifiée.
champ~x=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur égale à la valeur VALUE spécifiée.
champ~s=VALUE	Renvoie uniquement les éléments dont les champs spécifiés ont une valeur contenant la valeur VALUE spécifiée.
champ~sx=VALUE	Renvoie uniquement les éléments dont les champs spécifiés n’ont pas une valeur contenant la valeur VALUE spécifiée.
champ~i=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur se situant dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.
champ~ix=VALUE	Renvoie uniquement les éléments dont les champs spécifiés contiennent une valeur ne se situant pas dans l’intervalle spécifié sous la forme ‘[‘ ou ‘]’ suivi de {valeur-min}, puis ‘;’, puis {valeur-max}, puis ‘]’ ou ‘[‘.

Tableau sur les paramètres d’une requête GET log_entries

Nom du champs	Description
id	Identifiant de la valeur stockée
time	Timestamp de stockage de la valeur
variableId	Identifiant de la variable
variable	Nom de la variable
deviceId	Identifiant de l’équipement
device	Nom de l’équipement
type	Type de la valeur stockée
value	Valeur de la variable à ce timestamp

Tableau sur les champs disponibles pour une donnée historique brute

Un exemple de requête HTTP est:

https://192.168.1.223/log-entries?variableId=19212&time~i=[1634680800; 1653516000[&limit=2

Le code écrit en python sera le suivant:


query = 'log-entries'
param= {'variableId': 19212, 'time~i': '[1634680800; 1653516000[', 'limit':2}
req = requests.get(SERVER_URI + query, params=param, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
if req.status_code == 200:
    print('OK')
    data = req.json()
    print(data)
else:
    print('ERR:', req.json())

La réponse à cette requête est:

{'items': [{'id': '35441586', 'time': 1634710517, 'variableId': '19212', 'variable': 'test', 'deviceId': '17280001', 'device': 'Courtois', 'type': 'plot-value', 'value': 1}, {'id': '35498207', 'time': 1634749884, 'variableId': '19212', 'variable': 'test', 'deviceId': '17280001', 'device': 'Courtois', 'type': 'plot-value', 'value': 3}], 'cursor': '{"variableId":"19212","time~i":"[1634680800; 1653516000[","lastValues":["35498207"]}'}

3.2.3 Méthode POST

Cette méthode est utilisée pour créer une nouvelle entrée dans une table. Pour cela, il faut choisir la table que l’on veut modifier puis ensuite définir les paires clés/valeurs de l’élément que l’on veut créer.

3.2.3.1 Variables

Pour créer une nouvelle variable, la requête HTTP sera:

/variables

Cette requête sera suivie d’un dictionaire dont la clé ‘item’ contient elle -même un dictionnaire contenant les clés/valeurs de certains champs de la variable:

{'item': {'deviceId': ..., 'device': ..., 'displayLabel': ..., ...}

Ainsi, on peut renseigner avec des valeurs les clés suivantes:

Nom du champs	Description
deviceId	Identifiant de l’équipement
device	Nom de l’équipement
displayLabel	Valeur de le la représentation de la variable
address	Adresse de la variable
type	Type de la variable
intRegister	Adresse de la variable
priority	Priorité de la variable
mnemonic	Mnémonique de la variable
label	Libellé de la variable
comment	Commentaire
isInternal	Booléen indiquant si la variable est interne ou pas
isPublic	Booléen indiquant si la variable est publique ou pas
isWriteable	Booléen indiquant si la variable peut être écrite ou pas
minWriteValue	Valeur minimale que peut prendre la variable
maxWriteValue	Valeur maximale que peut prendre la variable
categories	Catégories dont fait partie la variable
format	Format de la variable
floatPrecision	Entier indiquant le nombre de chiffre significatif après la virgule. 0 si la variable n’est pas un décimale.
unit	Unité de la variable. Si aucune unité alors » est retourné.
minRemoteScaleValue	Valeur minimale brute
maxRemoteScaleValue	Valeur maximale brute
minLocalScaleValue	Valeur minimale lors de la mise à l’échelle
maxLocalScaleValue	Valeur maximale lors de la mise à l’échelle
inhibitionUser	Utilisateur ayant inhibé l’alarme
inhibitionStartTime	Date de début de l’inhibition
inhibitionStopTime	Date de fin de l’inhibition
hasAlarm	Booléen autorisant la gestion des alarmes
alarmLabel	Libellé de l’alarme
alarmCondition	Condition de l’alarme
hasEvent	Booléen autorisant la gestion des événements
eventLabel	Libellé de l’événement
eventCondition	Condition de l’événement
hasPlot	Booléen autorisant l’historisation des valeurs
plotIsAveraged	Booléen autorisant de moyenner la courbe
plotMinDelay	Délai entre deux points en secondes sur la courbe
plotMinDiff	Hystérésis de la variable
snmpOID	Adresse SNMP de la variable
snmpType	Type SNMP de la variable
rawValue	Valeur actuelle de la variable
displayValue	Valeur formatée de la variable

Tableau sur les champs disponibles pour une variable

Information
Rien de nous oblige à remplir tous les champs pour créer une variable et il n'y a aucun champs obligatoire à renseigner mais plus il y a de champs renseignés, plus les informations sur la variable seront précises.

Un exemple de requête HTTP est:

https://192.168.1.223/mserver/ui/api/v1/variables

avec comme paramètres:

{'item': {'label': 'temperature', 'deviceId': 2}

Le code écrit en python sera le suivant:

query = 'variables'
data = {'item' : json.dumps(
    {
        'label': 'temperature',
        'deviceId': 2}, sort_keys=True)}
req = requests.post(SERVER_URI + query, data=data, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
print(req.json())

La variable une fois créée, la sortie (req.json()) affiche l’identifiant de la variable dans la base de données (champ id).

3.2.3.2 Equipements

Pour créer une nouveau équipement, la requête HTTP sera:

/devices

Cette requête sera suivie d’un dictionaire dont la clé ‘item’ contient elle -même un dictionnaire contenant les clés/valeurs de certains champs de la variable:

{'item': {'isActive': ..., 'type': ..., 'name': ..., ...}

Ainsi, on peut renseigner avec des valeurs les clés suivantes:

Nom du champs	Description
isActive	Booléen indiquant si l’équipement est actif (1) ou en erreur (0)
type	Type de l’équipement
name	Nom de l’équipement
comment	Commentaire
displayLabel	Valeur de le la représentation de l’équipement
zones	Zone(s) de l’équipement
purgeDelay	Délai de purge des historiques (en jours)
timeout	Timeout (en secondes)
refreshDelay	Délai de rafraîchissement (en secondes)
comProtocol	Protocole de communication utilisé
comPort	Port de communication utilisé
slaveNumber	Numéro d’esclave. None pour aucun.
password	Mot de passe de l’équipement
comState	État de la communication
alarms	Nombre d’alarmes actives
isEditable	Booléen indiquant si l’équipement est modifiable par un utilisateur

Tableau sur les champs disponibles pour un équipement

Information
Rien de nous oblige à remplir tous les champs pour créer un équipement et il n'y a aucun champs obligatoire à renseigner mais plus il y a de champs renseignés, plus les informations sur l'équipement seront précises.

Un exemple de requête HTTP est:

https://192.168.1.223/mserver/ui/api/v1/variables

avec comme paramètres:

{'item': {'label': 'temperature', 'deviceId': 2}

Le code écrit en python sera le suivant:

query = 'devices'
data =  {'item' : json.dumps(
    {
        'name': 'Equipement_test',
        'comment': 'Ceci est un test'}, sort_keys=True)}
req = requests.post(SERVER_URI + query, data=data, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
print(req.json())

L’équipement une fois créé, la sortie (req.json()) affiche l’identifiant de l’équipement dans la base de données (champ id).

3.2.4 Méthode PATCH

Cette méthode est utilisée pour modifier un élément dans une table.

3.2.4.1 Variables

Pour modifier une variable, la requête HTTP sera:

/variables/{id}

Avec ‘id’ correspondant à l’index de la variable dans la base de données. Cette requête sera suivie d’un dictionaire dont la clé ‘item’ contient elle -même un dictionnaire contenant les clés/valeurs de certains champs de la variable:

'item={'deviceId': ..., 'device': ..., 'displayLabel': ..., ...}'

Ainsi, on peut renseigner ou modifier avec des valeurs les clés suivantes:

Nom du champs	Description
deviceId	Identifiant de l’équipement
device	Nom de l’équipement
displayLabel	Valeur de le la représentation de la variable
address	Adresse de la variable
type	Type de la variable
intRegister	Adresse de la variable
priority	Priorité de la variable
mnemonic	Mnémonique de la variable
label	Libellé de la variable
comment	Commentaire
log	Booléen indiquant si la modification de la variable lève un évènement ou non
isInternal	Booléen indiquant si la variable est interne ou pas
isPublic	Booléen indiquant si la variable est publique ou pas
isWriteable	Booléen indiquant si la variable peut être écrite ou pas
minWriteValue	Valeur minimale que peut prendre la variable
maxWriteValue	Valeur maximale que peut prendre la variable
categories	Catégories dont fait partie la variable
format	Format de la variable
floatPrecision	Entier indiquant le nombre de chiffre significatif après la virgule. 0 si la variable n’est pas un décimale.
unit	Unité de la variable. Si aucune unité alors » est retourné.
minRemoteScaleValue	Valeur minimale brute
maxRemoteScaleValue	Valeur maximale brute
minLocalScaleValue	Valeur minimale lors de la mise à l’échelle
maxLocalScaleValue	Valeur maximale lors de la mise à l’échelle
inhibitionUser	Utilisateur ayant inhibé l’alarme
inhibitionStartTime	Date de début de l’inhibition
inhibitionStopTime	Date de fin de l’inhibition
hasAlarm	Booléen autorisant la gestion des alarmes
alarmLabel	Libellé de l’alarme
alarmCondition	Condition de l’alarme
hasEvent	Booléen autorisant la gestion des événements
eventLabel	Libellé de l’événement
eventCondition	Condition de l’événement
hasPlot	Booléen autorisant l’historisation des valeurs
plotIsAveraged	Booléen autorisant de moyenner la courbe
plotMinDelay	Délai entre deux points en secondes sur la courbe
plotMinDiff	Hystérésis de la variable
snmpOID	Adresse SNMP de la variable
snmpType	Type SNMP de la variable
rawValue	Valeur actuelle de la variable
displayValue	Valeur formatée de la variable

Tableau sur les champs disponibles pour une variable

Un exemple de requête HTTP est:

https://192.168.1.223/mserver/ui/api/v1/variables

avec comme paramètres:

'item={'label': 'temperature', 'deviceId': 2}'

Le code écrit en python sera le suivant:

query = 'variables'
data =  {'item' : json.dumps(
    {
        'label': 'temperature',
        'deviceId': 2}, sort_keys=True)}
req = requests.patch(SERVER_URI + query, data=data, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
print(req.json())

La variable une fois modifiée, la sortie (req.json()) affiche None.

Information
Pour les variables de type chaîne de caractères (MS), il est indispensable d'encoder la valeur contenu dans le champs rawValue dans un JSON grâce à la fonction json.dumps().
Par exemple:
data = {'item' : json.dumps(
    {
        'label': 'url',
        'rawValue': json.dumps('https://test.fr')}, sort_keys=True)}

3.2.4.2 Equipements

Pour modifier un équipement, la requête HTTP sera:

/devices/{id}

Avec ‘id’ correspondant à l’index de l’équipement dans la base de données. Cette requête sera suivie d’un dictionaire dont la clé ‘item’ contient elle -même un dictionnaire contenant les clés/valeurs de certains champs de la variable:

'item={'isActive': ..., 'type': ..., 'name': ..., ...}'

Ainsi, on peut renseigner avec des valeurs les clés suivantes:

Nom du champs	Description
isActive	Booléen indiquant si l’équipement est actif (1) ou en erreur (0)
type	Type de l’équipement
name	Nom de l’équipement
comment	Commentaire
displayLabel	Valeur de le la représentation de l’équipement
zones	Zone(s) de l’équipement
purgeDelay	Délai de purge des historiques (en jours)
timeout	Timeout (en secondes)
refreshDelay	Délai de rafraîchissement (en secondes)
comProtocol	Protocole de communication utilisé
comPort	Port de communication utilisé
slaveNumber	Numéro d’esclave. None pour aucun.
password	Mot de passe de l’équipement
comState	État de la communication
alarms	Nombre d’alarmes actives
isEditable	Booléen indiquant si l’équipement est modifiable par un utilisateur

Tableau sur les champs disponibles pour un équipement

Un exemple de requête HTTP est:

https://192.168.1.223/mserver/ui/api/v1/variables

avec comme paramètres:

'item={'label': 'temperature', 'deviceId': 2}'

Le code écrit en python sera le suivant:

query = 'devices'
data = {'item' : json.dumps(
    {
        'name': 'Equipement_test',
        'comment': 'Ceci est un test'}, sort_keys=True)}
req = requests.patch(SERVER_URI + query, data=data, headers={
        'Authorization': 'Bearer {api_key}'.format(api_key=API_KEY)
    })
print(req.json())

L’équipement une fois modifié, la sortie (req.json()) affiche None.

3.2.5 Méthode DELETE

Cette méthode est utilisée pour supprimer un élément d’une table.

3.2.5.1 Variables

Pour supprimer une variable d’une table, la requête HTTP sera:

/variables/{id}

Avec ‘id’ correspondant à l’index de la variable dans la base de données. Il n’y a besoin d’aucun paramètre.

3.2.5.1 Equipements

Pour supprimer une variable d’une table, la requête HTTP sera:

/devices/{id}

Avec ‘id’ correspondant à l’index de la variable dans la base de données. Il n’y a besoin d’aucun paramètre.

Capteur Sinafis

Dernière modification le 09/09/2022 00:19

1. Introduction
- 1.1 Garantie
- 1.2 Couverture du réseau Sigfox
2. Principe de fonctionnement
- 2.1 Présentation du système
- 2.2. Le fonctionnement
3. Présentation du transmetteur
4. Présentation de la sonde Sol SHT
5. Présentation de la sonde d’humidité de feuille SHFT
6. Raccordement d’une sonde
7. Installation du transmetteur
8. Installation de la sonde SHT
9. Installation de la sonde SHFT
10. Programmation du transmetteur

1. Introduction

Merci de lire attentivement et entièrement ce manuel avant toute installation.

Ce manuel a pour but de vous aider à comprendre le fonctionnement du transmetteur ATH11XX et de ses sondes, la façon de le paramétrer et de l’installer.

Il est possible de contacter le support de Sinafis en envoyant un email à : support.sinasens@sinafis.com

Merci de préciser dans votre email votre nom et vos coordonnées de contact ainsi que le numéro de série du transmetteur concerné.

1.1 Garantie

Ce produit vous a été fournit dans le cadre d’un contrat de location. La société Sinafis garantit le fonctionnement du produit pendant toute la durée du contrat pour tous les défauts de fabrication du produit. La garantie ne couvre pas les détériorations liées à l’installation et / ou à l’utilisation que ne respecterait pas les informations du présent manuel. Les sondes dont le câble est coupé ou arraché, dont le corps est endommagé, dont le raccordement électrique n’est pas conforme, ne sont pas couvertes par la garantie. Une antenne perdue, tordue ou cassée n’est pas couverte par la garantie. L’introduction d’eau suite à une mauvaise remise en place du couvercle ou du joint du transmetteur n’est pas couverte par la garantie.

1.2 Couverture du réseau Sigfox

Le réseau Sigfox couvre 80% du territoire français. Il est nécessaire de vérifier auprès de Sinafis si le lieu d’implantation des sondes est couvert par le réseau (dans l’idéal, fournir les coordonnées GPS du lieu). Il suffit parfois de déplacer le transmetteur de quelques dizaines de mètres pour obtenir une meilleure transmission. Pour de plus amples informations, envoyer un email à support.sinasens@sinafis.com ou contact@sinafis.com.

2. Principe de fonctionnement

2.1 Présentation du système

L’ATH11XXS est un transmetteur de la température et de l’humidité du sol et de l’air. Il est destiné aux petites et grandes exploitations Agricoles (viticulteurs, maraîchers, fruitiers, céréaliers, …). Il peut également recevoir une sonde de feuille afin de communiquer la quantité d’eau présente à la surface.

L’ATH11XXS utilise la technologie radio Sigfox® et est alimenté par une pile lithium de 3v6 permettant une grande autonomie pouvant atteindre plusieurs années suivant la fréquence de transmission des mesures.

Schéma du principe de fonctionnement Sinasens

2.2. Le fonctionnement

Etape 1

Le transmetteur ATH11XXS se réveille à intervalles réguliers – généralement toutes les 2 heures – pour effectuer les différentes mesures.

Etape 2

L’ATH11XXS transmet par radio sur le réseau Sigfox le résultat des mesures qui est stocké dans le cloud dans la base de données Sinasens. Si des seuils d’alerte ont été définis, les notifications email sont envoyées aux destinataires désignés.

Etape 3

L’utilisateur peut se connecter à l’application web par l’intermédiaire d’un ordinateur fixe ou portable, d’une tablette ou d’un smartphone au site www.sinasens.com pour accéder aux informations de tous les transmetteurs qu’il possède. Il peut visualiser la position GPS de chacun ainsi que les dernières mesures réalisées. Des relevés graphiques permettent observer l’évolution au cours du temps.

3. Présentation du transmetteur

Antenne orientable
Event microporeux
Pile 3.6V
Presse étoupe pour les câbles de sonde
GPS
Voyant LED de contrôle
Bouton reset
Bouton de configuration
Borniers de raccordement des sondes

4. Présentation de la sonde Sol SHT

Câble de raccordement à brancher sur le transmetteur
Capteur de température intégré au corps de la sonde
Sonde capacitive à haute fréquence

La sonde SHT permet la mesure de l’humidité et de la température du sol. Elle est composée d’un capteur d’humidité capacitif à haute fréquence (80 MHz) et d’un capteur de température intégré dans le boitier.

La sonde SHT ne doit être raccordée que sur un transmetteur de la famille Sinasens (type ATH11XXS). Elle ne nécessite pas d’être calibrée avant utilisation. La calibration a déjà été effectuée en usine lors de la production.

La sonde est totalement étanche et ne nécessite aucun entretien particulier. La sonde capacitive étant prise en sandwich dans l’époxy il n’y a pas d’oxydation susceptible de l’endommager.

Information
Toutes les sondes livrées sont des sondes appelées « sonde 1 » (pour première sonde de sol). Il existe également des sondes appelées « sonde 2 » (pour deuxième sonde de sol). Les sondes de type 2 sont reconnaissables grâce à une bague de couleur sur le câble ou un marquage spécifique. Il est possible de raccorder une « sonde 1 » et une « sonde 2 » sur un même transmetteur mais jamais 2 sondes de même type sur un même transmetteur !

Avertissement
Afin que la sonde SHT donne les meilleurs résultats, il est nécessaire de bien respecter la procédure de mise en place dans le sol (voir le chapitre concerné).

5. Présentation de la sonde d’humidité de feuille SHFT

Câble de raccordement à brancher sur le transmetteur
Sonde d’humidité capacitive à moyenne fréquence

La sonde SHFT permet simuler une feuille et de mesurer l’humidité présente sur celle-ci. Elle est composée d’un capteur d’humidité capacitif à moyenne fréquence dont la surface est en forme de feuille. La sonde SHFT ne doit être raccordée que sur un transmetteur de la famille SinaSens (type ATH11XXS).

Elle ne nécessite pas d’être calibrée avant utilisation. La calibration a déjà été effectuée en usine lors de la production. La sonde est totalement étanche et ne nécessite aucun entretien particulier. La sonde capacitive étant prise en sandwich dans l’époxy il n’y a pas d’oxydation susceptible de l’endommager.

Information
Il n’est possible de raccorder qu’une seule sonde SHF sur un transmetteur Sinasens.

Avertissement
Afin que la sonde SHFT donne les meilleurs résultats, il est nécessaire de bien respecter la procédure de mise en place (voir le chapitre concerné).

6. Raccordement d’une sonde

Ouvrir le boitier et localiser les borniers de raccordement. Il y a 3 emplacements possibles pour raccorder une sonde (SHT ou SHFT). Il n’y a pas d’ordre de placement. Il est possible de choisir indifféremment la position 1, 2 ou 3 sans conséquence pour le fonctionnement du produit.

Desserrer le presse-étoupe par lequel doit passer le câble de la sonde.
Faire passer le câble dans le presse-étoupe.

Raccorder la sonde indifféremment sur l’emplacement d’un bornier de votre choix en respectant le câblage suivant :

Blanc-> borne +
Noir -> borne –
Vert -> borne D
Marron -> borne C

Serrer modérément le presse-étoupe pour garantir l’étanchéité.
Vérifier que l’antenne est fermement vissée sur le boitier.

7. Installation du transmetteur

Le transmetteur utilise le réseau Sigfox et comme tout système radio il est nécessaire de respecter quelques règles simples pour obtenir les meilleures performances :

Une bonne méthode consiste à utiliser un piquet solidement ancré au sol et à placer le transmetteur à son extrémité supérieure. Vérifier que la hauteur de fixation permette la mise en place de la sonde dans le sol.
Placer le transmetteur et orienter l’antenne de sorte qu’elle soit placée verticalement.
S’assurer que l’antenne est dégagée au maximum. Idéalement, il ne devrait y avoir aucun obstacle dans un rayon de 30cm autour de l’antenne.
Si le transmetteur est fixé verticalement, les presse-étoupes pour le passage du câble des sondes doivent se situer sur la partie inférieure.
Si le transmetteur est placé horizontalement, il faut orienter l’antenne verticalement.
Il faut toujours s’assurer que l’antenne est fermement vissée. Dans le cas contraire, il est possible qu’en cas d’exposition à des vents violents, celle-ci se dévisse et s’envole.

8. Installation de la sonde SHT

Sonde sous le pralin — Sonde sur le pralin

Pour obtenir les meilleurs résultats pour la mesure de l’humidité, il est impératif que la partie sensible 3 soit entièrement en contact (face supérieure et inférieure) avec le sol. La solution la plus efficace est la suivante :

Faire un trou dans le sol jusqu’à la profondeur de mesure souhaitée.
Réaliser un pralin en mélangeant de la terre en provenance du trou avec un peu d’eau.
Placer un peu de pralin au fond du trou.
Placer la sonde horizontalement sur ce pralin.
Recouvrir la sonde avec le reste du pralin.
Reboucher le trou en tassant au fur et à mesure.
Les premières mesures seront surtout le reflet de l’humidité du pralin. Après quelques heures, voir quelques jours suivant le volume du pralin, les mesures correspondront à l’humidité du sol.

Pour la mesure de la température du sol, il faut se rappeler que le capteur de température 2 est situé sur le corps de la sonde. Il est donc nécessaire que le corps de la sonde soit lui aussi placé dans le sol.

Le simple fait de planter verticalement la sonde dans le sol en laissant le corps à l’extérieur ne permet pas de mesurer la température du sol mais seulement la celle du corps exposé à l’air libre et aux rayons du soleil.

En conclusion : pour une bonne mesure de l’humidité et de la température du sol, il faut que la sonde soit intégralement dans le sol avec un parfait contact de la partie sensible 3 avec la terre.

9. Installation de la sonde SHFT

Pour obtenir les meilleurs résultats pour la mesure de l’humidité de feuille , il faut s’assurer qu’après l’installation la partie sensible 2 soit totalement dégagée. Tout élément en contact avec la partie sensible (support, branche,…) modifiera la valeur lue.

La solution d’installation la plus efficace est la suivante :

Utiliser un support en forme de L en fer ou en aluminium ou encore un morceau de fer à béton.
Fixer la partie verticale du support sur un piquet ou un poteau (celui du transmetteur par exemple).
Fixer le corps de la sonde tout au bout horizontal du support en s’assurant que la partie sensible est bien dégagée. Il est possible d’utiliser des colliers serre-fils ou de la gaine creuse pour maintenir la sonde sur le support.
Tordre éventuellement le support pour donner l’inclinaison souhaitée à la feuille SHFT.

Il est préférable de positionner la sonde SHFT à l’extérieur du feuillage plutôt qu’à l’intérieur. Les mesures seront plus pertinentes pour détecter aussi bien la pluie, la rosée, la neige ou encore la glace. On évite de plus le contact avec des éléments extérieurs qui pourraient perturber les mesures.

10. Programmation du transmetteur

10.1. Les différents modes

Le transmetteur possède 8 modes d’émission paramétrables toutes les :

15 minutes
30 minutes
1 heure
2 heures
4 heures
8 heures
12 heures
24 heures

Un mode de test réservé pour les mesures en laboratoire et un mode de sommeil.

Chacun des 8 modes de transmission est identifiable par des flashes sur le voyant led rouge intégré au produit.

Les différents modes sont identifiés de la façon suivante :

1 flash pour le mode 1
2 flashes pour le mode 2
etc ..

Le mode test est identifiable par l’émission de flashes très rapides sur le voyant led.

Avertissement
Ne pas utiliser le mode test.

Le mode sommeil est indentifiable par l’émission d’une slave de flashes rapides et lent.

10.2. Exemple :

Activer le Mode 4 pour une émission toutes les 2 heures :

Ouvrir le boitier en dévissant les 4 vis imperdables du couvercle.
Appuyer et maintenir appuyé le bouton BP.
Appuyer puis relâcher le bouton RESET. Au bout de quelques secondes, le transmetteur va afficher sur le voyant led les différents modes consécutifs.
Relâcher le bouton BP lorsque le transmetteur affiche le mode 4 (émission d’une série de 4 flashes rapides).
Après une dizaine de secondes, le SinaSens confirme être en mode 4 (émission d’une série de 4 flashes). Replacer le couvercle sur le boitier en vérifiant que le joint d’étanchéité est bien en place.

10.3 Remarque sur les modes

Lors de la configuration, les modes changent de façon cyclique comme indiqué sur la figure suivante tant que le bouton poussoir BP n’a pas été relâché. Si le mode désiré a été dépassé, il suffit de maintenir le BP appuyé jusqu’à l’apparition du mode souhaité ou de reprendre la procédure précédente à l’étape 2.

10.4 Remarque sur la position GPS

Le transmetteur fait une première recherche de sa position GPS après un reset (bref appui sur le bouton poussoir RESET), et ensuite toutes les 24h environ. La recherche de la position GPS dure au maximum 2mm afin de ne pas épuiser la pile.

La position GPS ne peut être déterminée que si le SinaSens possède une vue dégagée sur le ciel. Il sera pratiquement impossible d’obtenir la position dans un hangar, dans un bâtiment, dans un sous-sol,…

La mise en place du SinaSens sous un abris en bois ou sous une serre ne pose généralement pas de problème pour la réception des signaux GPS.

La présence d’un environnement en béton, en pierre, en tôle,… est généralement nuisible à la bonne transmission ou réception des ondes radio tant pour le réseau Sigfox que pour le GPS.

Sinasens

Dernière modification le 20/10/2022 21:24

1. Introduction
- 1.1 Lecteurs ciblés
2. Présentation de l’application
3. API

1. Introduction

1.1 Lecteurs ciblés

Cette documentation est à destination des utilisateurs de l’application Sinasens, permettant de la visualisation de données collectées par les sondes Sinafis.

2. Présentation de l’application

A venir …

3. API

3.1 Obsolescence

L’API v1 est devenue obsolète le 31 octobre 2019. Si vous utilisiez l’API v1, il est impératif que vous effectuez une migration afin de continuer à utiliser les services de Sinasens.

3.2 Généralités

La plupart des données présentes sur le site de SinaSens SmartAgri sont accessibles par un webservice API par programmation. Les requêtes d’API permettent de s’interfacer avec divers logiciels et langages de programmation. Cette API utilise le protocole HTTPS.

Certaines fonctions de l’API retournent les données soit au format JSON, soit au format CSV suivant l’option choisie.

Les fonctions de l’API sont susceptibles d’évoluer. Dans la mesure du possible la compatibilité avec les fonctions précédentes sera conservée. De la même façon, de nouvelles fonctions peuvent être créées pour enrichir les fonctionnalités de l’API.

L’adresse de base pour l’accès à l’API v2 est :

https://www.sinasens.com/api/v2/

3.3 Conditions d’utilisation

L’API peut être utilisée pour récupérer de façon ponctuelle des données accessibles par le site sinasens.com.

Elle ne doit en aucun cas être utilisée pour récupérer des évènements en mode « polling » à une fréquence trop élevée (supérieure à une fois par heure). Le risque est alors d’obtenir en retour un code 429 « trop de requêtes ».

3.4 Authentification et sécurité

L’API est pour l’instant uniquement accessible via le protocole HTTPS. Toutes les requêtes nécessitent l’utilisation d’une clé d’API constituée d’un identifiant (login) et d’un mot de passe (password). Ces informations sont confidentielles. Elles peuvent être transmises par Email en vous connectant à votre compte sur https://www.sinasens.com en sélectionnant « Mon compte -> Obtenir ma clé d’API ».

Cette clé est unique. Vous en êtes le seul propriétaire et vous devez apporter toute l’attention nécessaire à sa confidentialité. Si vous souhaitez obtenir une nouvelle clé vous devez en faire la demande en envoyant un mail à support.sinasens@sinafis.com à partir de votre compte e-mail identifié sur sinasens.com. Il sera prochainement possible de générer cette clé à partir de votre compte Sinasens. En cas de génération d’une nouvelle clé, l’ancienne est irrémédiablement détruite et ne peut plus être utilisée.

3.5 Codes de retour HTTP

L’API SinaSens ne retourne qu’un nombre limité de codes HTTP :

200 : la requête a été correctement exécutée.
400 : erreur de requête. Un paramètre est manquant ou invalide.
401 : clé d’api manquante ou invalide (login et/ou password).
403 : accès refusé ou requête non autorisée.
404 : la ressource pour la requête demandée n’a pas été trouvée.
429 : trop de requêtes. Fréquence de requêtes trop élevée.
500 : erreur inconnue.

3.6 Nom du fichier en sortie CSV

Le format du nom de sortie du fichier CSV à la suite d’une requête est composé du numéro d’identification du device, du nom de la requête, de la date et de l’heure de la génération du fichier :

<id du device>_<requête>_<année>_<mois>_<jour>_<heures>_<minutes>_<secondes>.csv

Par exemple :

36F9EE_HISTORY_2019_09_8_14_04_23.csv

36F9EE_GPS_2019_09_8_16_23_18.csv

3.7 Fonctions de l’API

3.7.1 Historique d’un device

Requête

history.php

Structure

https://www.sinasens.com/api/v2/history.php?login=LOGIN&password=PASSWORD&devic
e=DEVICE&fromDate=FROMDATE&toDate=TODATE&max=MAX&
gps=GPS&mode=MODE

Paramètres

Paramètre	Commentaires
LOGIN	Requis. Identifiant de la clé d’API (ex: c428g2730739in2i23fk23tk).
PASSWORD	Requis. Mot de passe de la clé d’API (ex: ms7mg0bry06gf7i1hnyf8e9mym6jx58t).
DEVICE	Requis. Numéro de série du transmetteur Sinafis dont on souhaite récupérer l’historique (ex. 36E975).
FROMDATE	Optionnel. Date et heure du début de recherche dans l’historique. Le format est AAAA-MM-JJ HH:MM:SS où AAAA représente l’année, MM le mois, JJ le jour, HH l’heure en format 24h, MM les minutes, SS les secondes. Si le paramètre « fromDate » est omis, la recherche commencera sur le premier événement trouvé dans l’historique.
TODATE	Optionnel. Date et heure de la fin de recherche dans l’historique. Le format est AAAA-MM-JJ HH:MM:SS où AAAA représente l’année, MM le mois, JJ le jour, HH l’heure en format 24h, MM les minutes, SS les secondes. Si le paramètre « toDate » est omis, la recherche finira sur le dernier événement trouvé dans l’historique.
MAX	Optionnel. Nombre maximum d’événements à retourner. Si le paramètre « max » est omis ou si « max=0 », tous les événements trouvés dans la période de recherche seront retournés.
GPS	Optionnel. Option de retour des informations de position GPS du device. 1 -> les positions GPS seront retournées dans l’historique, 0 -> les positions GPS ne seront pas retournées dans l’historique. Si le paramètre « gps » est omis, les positions GPS ne seront pas retournées dans l’historique.
MODE	Optionnel. Format sous lequel les données sont retournées. Il y a 2 formats possibles : JSON ou CSV. Si le paramètre « mode » est omis, le format de sortie est CSV.

Paramètres de sortie de requête (CSV ou JSON)

Paramètre CSV	Paramètre JSON	Commentaires
DATE_UNIX	dateUnix	Date de l’événement exprimée en nombre de secondes depuis le premier janvier 1970 minuit UTC.
DATE	date	Date de l’événement sous la forme jj/mm/aaaa UTC.
HEURE	heure	Heure de l’événement sous la forme hh:mm:ss.
ID	device	Numéro du transmetteur Sinasens.
LATITUDE	latitude	Latitude en degré décimaux (valeur positive pour Nord et négative pour Sud). Null si l’évènement n’est pas lié à une trame GPS.
LONGITUDE	longitude	Longitude en degré décimaux (valeur positive pour Est et négative pour Ouest). Null si l’évènement n’est pas lié à une trame GPS.
TEMP1	temp1	Température de la sonde 1 en degrés Celsius (-120°C à +12°C). Null si la sonde n’existe pas ou si aucune valeur n’est mesurée.
HUM1	hum1	Humidité de la sonde 1 en % (0 à 100%). Null si la sonde n’existe pas ou si aucune valeur n’est mesurée.
TEMP2	temp2	Température de la sonde 2 en degrés Celsius (-120°C à +12°C). Null si la sonde n’existe pas ou si aucune valeur n’est mesurée.
HUM2	hum2	Humidité de la sonde 2 en % (0 à 100%). Null si la sonde n’existe pas ou si aucune valeur n’est mesurée.
TEMP3	temp3	Température de la sonde 3 en degrés Celsius (-120°C à +12°C). Null si la sonde n’existe pas ou si aucune valeur n’est mesurée
HUM3	hum3	Humidité de la sonde 3 en % (0 à 100%). Null si la sonde n’existe pas ou si aucune valeur n’est mesurée
TEMP4	temp4	Température de la sonde 4 en degrés Celsius (-120°C à +12°C). Null si la sonde n’existe pas ou si aucune valeur n’est mesurée.
HUM4	hum4	Humidité de la sonde 4 en % (0 à 100%). Null si la sonde n’existe pas ou si aucune valeur n’est mesurée.
TENSION	tension	Tension de la pile au moment de la transmission en volt.
SIGNAL	signal	Qualité du signal radio de la trame transmise (0 à 4) 0=limite, 1=moyen, 2=bon, 3=très bon, 4=excellent

Exemple de requête au format JSON

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&gps=1&max=5&mode=json

Exemple de réponse au format JSON

[
 {
  "dateUnix":"1608585027",
  "date":"21\/12\/2020",
  "heure":"22:10:27",
  "device":"36E975",
  "latitude":null,
  "longitude":null,
  "temp1":"21.4",
  "hum1":"51",
  "temp2":null,
  "hum2":null,
  "temp3":null,
  "hum3":null,
  "temp4":null,
  "hum4":"100",
  "tension":"3.5",
  "signal":"1"
 },
 {
  "dateUnix":"1608584997",
  "date":"21\/12\/2020",
  "heure":"22:09:57",
  "device":"36E975",
  "latitude":"43.584362030029",
  "longitude":"1.8461133241653",
  "temp1":null,
  "hum1":null,
  "temp2":null,
  "hum2":null,
  "temp3":null,
  "hum3":null,
  "temp4":null,
  "hum4":null,
  "tension":"3.3",
  "signal":"1"
 },
 {
  "dateUnix":"1608582702",
  "date":"21\/12\/2020",
  "heure":"21:31:42",
  "device":"36E975",
  "latitude":null,
  "longitude":null,
  "temp1":"21.9",
  "hum1":"51",
  "temp2":null,
  "hum2":null,
  "temp3":null,
  "hum3":null,
  "temp4":null,
  "hum4":"55",
  "tension":"3.5",
  "signal":"1"
 },
 {
  "dateUnix":"1608582673",
  "date":"21\/12\/2020",
  "heure":"21:31:13",
  "device":"36E975",
  "latitude":"43.584609985352",
  "longitude":"1.8463567495346",
  "temp1":null,
  "hum1":null,
  "temp2":null,
  "hum2":null,
  "temp3":null,
  "hum3":null,
  "temp4":null,
  "hum4":null,
  "tension":"3.3",
  "signal":"1"
 },
 {
  "dateUnix":"1583140366",
  "date":"2\/03\/2020",
  "heure":"10:12:46",
  "device":"36E975",
  "latitude":null,
  "longitude":null,
  "temp1":"22.3",
  "hum1":"54",
  "temp2":null,
  "hum2":null,
  "temp3":null,
  "hum3":null,
  "temp4":null,
  "hum4":null,
  "tension":"3.5",
  "signal":"4"
 }
]

Exemple de requête au format CSV

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&gps=1&max=5&mode=csv

Exemple de réponse au format CSV

DATE_UNIX;DATE;HEURE;ID;LATITUDE;LONGITUDE;TEMP1;HUM1;TEMP2;HUM2;TEMP3;HUM3;TEMP4;HUM4;TENSION;SIGNAL
1608585027;21/12/2020;22:10:27;36E975;;;21.4;51;;;;;;100;3.5;1
1608584997;21/12/2020;22:09:57;36E975;43.584362030029;1.8461133241653;;;;;;;;;3.3;1
1608582702;21/12/2020;21:31:42;36E975;;;21.9;51;;;;;;55;3.5;1
1608582673;21/12/2020;21:31:13;36E975;43.584609985352;1.8463567495346;;;;;;;;;3.3;1
1583140366;2/03/2020;10:12:46;36E975;;;22.3;54;;;;;;;3.5;4

Exemples de demandes d’historique

Les 15 derniers événements du device 36E975 sans le GPS

En CSV :

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&max=15

En JSON :

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&max=15&mode=json

Tous les événements du device 36E975 du 1 mai 2019 au 2 mai 2021

En CSV :

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&fromDate='2019-05-01'&toDate='2021-05-02'&gps=1

En JSON :

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&fromDate='2019-05-01'&toDate='2021-05-02'&gps=1&mode=json

Les 36 derniers événements du device 36E975 le 12 août 2019 entre 8h04 et 14h22m18s sans le GPS :

En CSV :

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&fromDate='2019-08-12 08:04:00'&toDate='2019-08-12 14:22:18'

En JSON :

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&fromDate='2019-08-12 08:04:00'&toDate='2019-08-12 14:22:18'&mode=json

Tous les événements du device 36E975 du mois de juin 2019 avec le GPS

En CSV :

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&fromDate=’2019-06’&toDate=’2019-07’&gps=1

En JSON :

https://www.sinasens.com/api/v2/history.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&fromDate=’2019-06’&toDate=’2019-07’&gps=1&mode=json

3.7.2 Position GPS d’un device

Requête

gps.php

Structure

https://www.sinasens.com/api/v2/gps.php?login=LOGIN&password=PASSWORD&device=
DEVICE&max=MAX&mode=MODE

Paramètres

Paramètre	Commentaires
LOGIN	Requis. Identifiant de la clé d’API (ex. c428g2730739in2i23fk23ts).
PASSWORD	Requis. Mot de passe de la clé d’API (ex. ms7mg0bry06gf7i1hnyf8e9mym6jx58a).
DEVICE	Requis. Numéro de série du transmetteur Sinasens dont on souhaite récupérer l’historique (ex. F6F2F).
MAX	Optionnel. Nombre maximum d’événements à retourner. Si le paramètre « max » est omis ou si « max=0 », tous les événements trouvés dans la période de recherche seront retournés.
MODE	Optionnel. Format sous lequel les données sont retournées. Il y a 2 formats possibles : JSON ou CSV. Si le paramètre « mode » est omis, le format de sortie est CSV.

Paramètres de sortie de requête (CSV ou JSON)

Paramètre CSV	Paramètre JSON	Commentaires
DATE_UNIX	dateUnix	Date de l’événement exprimée en nombre de secondes depuis le premier janvier 1970 minuit UTC.
DATE	date	Date de l’événement sous la forme jj/mm/aaaa UTC.
HEURE	heure	Heure de l’événement sous la forme hh:mm:ss.
ID	device	Numéro du transmetteur Sinasens.
LATITUDE	latitude	Latitude en degré décimaux (valeur positive pour Nord et négative pour Sud). Null si l’évènement n’est pas lié à une trame gps.
LONGITUDE	longitude	Longitude en degré décimaux (valeur positive pour Est et négative pour Ouest). Null si l’évènement n’est pas lié à une trame gps.

Exemple de requête au format JSON

https://www.sinasens.com/api/v2/gps.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&max=2&mode=json

Exemple de réponse au format JSON

[
 {"dateUnix":"1608584997",
  "date":"21\/12\/2020",
  "heure":"22:09:57",
  "device":"36E975",
  "latitude":"43.584362030029",
  "longitude":"1.8461133241653"
 },
 {
  "dateUnix":"1608582673",
  "date":"21\/12\/2020",
  "heure":"21:31:13",
  "device":"36E975",
  "latitude":"43.584609985352",
  "longitude":"1.8463567495346"
 }
]

Exemple de requête au format CSV

https://www.sinasens.com/api/v2/gps.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&max=5&mode=csv

Exemple de réponse au format CSV

DATE_UNIX;DATE;HEURE;ID;LATITUDE;LONGITUDE
1608584997;21/12/2020;22:09:57;36E975;43.584362030029;1.8461133241653
1608582673;21/12/2020;21:31:13;36E975;43.584609985352;1.8463567495346
1561559348;26/06/2019;16:29:08;36E975;43.58406829834;1.8466166257858

Exemples de demandes de position GPS

La dernière position GPS connue du device 36E975

En CSV :

https://www.sinasens.com/api/v2/gps.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&max=1

En JSON :

https://www.sinasens.com/api/v2/gps.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&max=1&mode=json

Les 5 dernières positions GPS connues du device 36E975

En CSV :

https://www.sinasens.com/api/v2/gps.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&max=5

En JSON :

https://www.sinasens.com/api/v2/gps.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&max=5&mode=json

Toutes les positions GPS connues du device 36E975

En CSV :

https://www.sinasens.com/api/v2/gps.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t

En JSON :

https://www.sinasens.com/api/v2/gps.php?device=36E975&login=c428g2730739in2i23fk23tk&password=ms7mg0bry06gf7i1hnyf8e9mym6jx58t&mode=json