SetNewEqptCounterValue
Met à jour la valeur du compteur d'un équipement.
Syntaxe
procedure SetNewEqptCounterValue(unitName: String; eqptGPAOID: String; counterValue: Float; estimateEqpts: TStrings; date: Float)
unitName: Nom de l'unité qui va donner son nom au compteur (il s'agit du nom de l'unité associée, en respectant la casse)
eqptGPAOID: GPAOID de l'équipement pour lequel le compteur unitName vaut la valeur counterValue
counterValue: Nouvelle valeur du compteur.
estimateEqpts: Liste des GPAOID des équipements pour lesquels on souhaite incrémenter la valeur du compteur d'une valeur estimée.
date: Date de lecture du compteur.
Remarques
La fonction sert aussi à estimer la valeur de ce même compteur pour une liste d'équipements indiqués, ce qui peut servir notamment quand on a des sous-équipements amovibles, pour lesquels on souhaite suivre ce même compteur.
- La mise à jour d'un compteur est impossible si ce compteur n'a jamais été réinitialisé par la fonction ResetEqptCounter.
- La date de lecture du compteur doit être supérieure à la date de la dernière lecture/reset.
- La nouvelle valeur lue sur le compteur doit être supérieure à la dernière valeur lue.
- Pour chacun des équipements de la liste estimateEqpts :
- le compteur unitName devra déjà avoir été réinitialisé par la fonction ResetEqptCounter
- la date date doit être supérieure à la date de dernière mise à jour (lue ou estimée)
- La nouvelle valeur estimée du compteur sera calculée de la façon suivante :
- Qubes va calculer le taux d'accroissement temporel de la valeur du compteur de eqptGPAOID, i.e. (counterValue - dernière valeur connue) / (date - date dernière valeur)
- Puis, pour l'équipement estimé, Qubes détermine le delta de temps écoulé entre date et la dernière date de mise à jour du compteur unitName de l'équipement estimé.
- Qubes peut alors calculer l'augmentation du compteur de l'équipement estimé en multipliant ce delta de temps par le taux d'accroissement du compteur de référence
- Enfin, il ajoute cette augmentation à la dernière valeur connue du compteur de l'équipement estimé.
- Si on ne souhaite pas estimer la valeur des compteurs d'autres équipements à partir de cette lecture de compteur, on peut utiliser nil comme valeur pour le paramètre.
Exemples
ResetEqptCounter('kilomètre', 'Peugeot 207 REF1', 0, 8000, now); // Réinitialisation du compteur.
SetNewEqptCounterValue('kilomètre', 'Peugeot 207 REF1', 8001, nil, now); // Définition de la nouvelle valeur du compteur.
SetNewEqptCounterValue('kilomètre', 'Peugeot 207 REF1', 8001, nil, now); // Définition de la nouvelle valeur du compteur.