Skip to content

Latest commit

 

History

History
164 lines (152 loc) · 7.57 KB

File metadata and controls

164 lines (152 loc) · 7.57 KB
title Structure des données
weight 20

Voir un exemple de dump complet d'un module

{{% notice style="tip" title="Icones"%}} Les valeurs de paramètre correspondantes à des icones sont celles definies sur GoogleFonts
https://fonts.google.com/icons {{% /notice %}}

Modules

Un module est un ensemble de propriétés qui sont dédiées à une tache spécifique (focus/guidage/ ...) L'identifiant unique du module correspond à son libellé auquel on a supprimé les espaces.
Il dispose des paramètres suivants :

Paramètre Type Description
infos:label string Libellé du module
infos:name string Nom interne du module
infos:description string Description du module
errors array(datetime,string) Tableau des messages d'erreur
warnings array(datetime,string) Tableau des messages d'alerte
messages array(datetime,string) Tableau des messages d'information
globallovs array(string,type,array(type)) Liste de valeurs globale
state N/A N/A
properties string:property Propriétés du module

Propriétés

Une propriété est un ensemble d'éléments. Ces propriétés doivent être représentées hiérarchiquement les unes par rapport aux autres sur le module. Les valeurs de "level1" et "level2" permettent de déterminer cette hiérarchie.

Paramètre Type Description
badge bool Bouton oui/non pour ajouter ou enlever la propriété des favoris
elements string:element Elements de la propriété
enabled bool La propriété est active ou inactive
freevalue N/A Aucune idée de pourquoi j'ai eu besoin de ce truc
enabled bool La propriété est active ou inactive
hasGrid bool La propriété contient une table indexée des valeurs des éléments
grid array(N/A) Lignes de la table
gridLimits int Taille maximum de la table
gridHeaders array(string) Ordre des colonnes, selon l'identifiant des éléments qui la composent
hasGraph bool La propriété doit afficher un graphique selon les paramètres graph%
graphParams N/A Paramètres du graphique (voir section graphes)
graphType string : XY / DY / PHD Type de graphe - XY : simple graphe X-Y, DY : l'abscisse est un timestamp, PHD : graphe spécifique pour le guidage
hasprofile bool La propriété est sauvegardée dans le profile du module (inutile sur le frontend)
label string Libellé de la propriété
level1 string Niveau 1 hiérarchique d'affichage
level2 string Niveau 2 hiérarchique d'affichage
order string Ordre d'affichage à niveau égal
permission 0 / 1 / 2 Permissions sur les éléments de la propriété - 0 : Lecture seule, 1 : écriture seule, 2 : lecture-écriture
preicon1 string bouton à placer avant le libellé de la propriété (voir note icones ci-dessus)
preicon2 string bouton à placer avant le libellé de la propriété (voir note icones ci-dessus)
posticon1 string bouton à placer après le libellé de la propriété (voir note icones ci-dessus)
posticon2 string bouton à placer après le libellé de la propriété (voir note icones ci-dessus)
rule 0 / 1 / 2 Définit le comportement des éléments booléens associés à la propriété - 0:OneOfMany (un et un seul booléen vaut "true" = bouton radio) - 1:AtMostOne (au plus un booléen vaut "true") - 2:Any (aucune dépendance entre tous les booléens de la propriété)
showElts bool Afficher les valeurs actuelles des éléments
showGrid bool La liste de valeur de la grille sous forme de table
status 0 / 1 / 2 / 3 Statut de la propriété - 0:Standby - 1:OK (vert) - 2:Occupé (jaune)- 3:Erreur (rouge)

Elements

Un élément représente une valeur unique, c'est le niveau le plus bas.
11 types de valeurs sont possibles :

  • int : une valeur entière, qui peut être négative
  • float : une valeur décimale, qui peut être négative
  • bool : une valeur logique
  • string : une chaine de caractères
  • date : une date
  • time : une heures/minutes/secondes/millisecondes
  • img : une image
  • video : une vidéo
  • light : 4 valeurs possible : standby, ok, warning, erreur
  • prg : une barre de progression ou un camembert
  • message : un message avec horodatage

Paramètres systématiques

Ce jeu de paramètres est commun à tous les éléments :

Paramètre Type Description
autoupdate bool Ce paramètre n'a pas d'usage pour le frontend
badge bool Bouton oui/non pour ajouter ou enlever l'élément dans les favoris
directedit bool true : la valeur peut être mise à jour directement - false : la valeur doit être mise à jour en même temps que les autres éléments d'une même propriété
hint string Texte explicatif de l'élément, aide à la façon "infobulle"
label string Libellé de l'élément
order string Ordre d'affichage de l'élément dans la propriété
type string Type de valeur - voir liste des valeurs possible ci-dessus

Paramètres optionnels

Ce jeu de paramètres n'est pas défini systématiquement.

Paramètre Type Description
posticon string bouton à placer après le libellé de l'élément (voir note icones ci-dessus)
preicon string bouton à placer avant le libellé de l'élément (voir note icones ci-dessus)

Paramètres spécifiques - int

Paramètre Type Description
value int Valeur entière, qui peut être négative
format string format d'affichage
listOfValues array(int) Tableau des valeurs autorisées
globallov string Référence à une liste de valeurs autorisées globale
min int Valeur minimale autorisée
max int Valeur maximale autorisée
slider 0/1/2 0 : Pas de slider - 1 : Slider seulement - 2 : Slider et valeur
step int Pas du slider

Paramètres spécifiques - float

Paramètre Type Description
value float Valeur décimale, qui peut être négative
format string format d'affichage
listOfValues array(float) Tableau des valeurs autorisées
globallov string Référence à une liste de valeurs autorisées globale
min float Valeur minimale autorisée
max float Valeur maximale autorisée
slider 0/1/2 0 : Pas de slider - 1 : Slider seulement - 2 : Slider et valeur
step float Pas du slider

Paramètres spécifiques - bool

Paramètre Type Description
value bool Valeur logique true/false

Paramètres spécifiques - string

Paramètre Type Description
value string Valeur alphanumérique
listOfValues array(string) Tableau des valeurs autorisées
globallov string Référence à une liste de valeurs autorisées globale

Paramètres spécifiques - date

Paramètre Type Description
year int Année
month 1-12 Mois
day 1-31 Jour

Paramètres spécifiques - time

Paramètre Type Description
hh 0-23 Heures
mm 0-59 Minutes
ss 0-59 Secondes
ms 0-999 Millisecondes

Paramètres spécifiques - img

Paramètre Type Description
value bool A3

Paramètres spécifiques - video

Paramètre Type Description
value bool A3

Paramètres spécifiques - light

Paramètre Type Description
value bool A3

Paramètres spécifiques - prg

Paramètre Type Description
value bool A3

Paramètres spécifiques - message

Paramètre Type Description
value bool A3