Information d’une ou plusieurs variables, Information de toutes les variables, Valeur instantanée d’une ou plusieurs variables – CIRCUTOR EDS-3G Series Manuel d'utilisation
Page 4: Valeur instantanée de toutes les variables, Commandes de test, Registre d’un listener (auditeur)
EDS-3G
M98240601-02-13B
-
devices : champ qui identifie le XML comme réponse à
la demande de liste des dispositifs
-
id : nom de chacun des dispositifs
Information sur le dispositif
À travers cette demande, le service XML retourne une
information sur les dispositifs. Chacun des dispositifs dont on
souhaite obtenir une information, doit être inclus dans la
demande comme ?id=dispositif1?id=dispositif2…
id=dispositivo?
http://nombre_dhcp/services/user/deviceInfo.xml?id=disp
ositivo?
<devices>
<device>
<id> ... <id>
<description> ... </description>
<type> ... </type>
<typeDescription> ... </typeDescription>
<var> ... </var>
..
</device>
..
<devices>
-
description : description du dispositif
-
type : type de dispositif
-
typeDescription : description détaillée du dispositif
-
var : nom de chacune des variables du dispositif ; indiqué
comme nom.variable
Information de la variable
L’utilisateur peut demander une information détaillée d’une ou
plusieurs variables en provenance d’un dispositif et même
demander dans une seule demande, l’information de toutes
les variables disponibles dans le dispositif.
4.3.1.1.- Information d’une ou plusieurs variables
Demande pour solliciter une information détaillée d’une ou
plusieurs variables du dispositif (dans le cas d’avoir besoin
d’une information de plusieurs variables, enchaîner le reste
des demandes ci-après avec var=dispositif.variable?)
4.3.1.2.- Information de toutes les variables
Demande pour solliciter une information détaillée de toutes
les variables du dispositif (dans le cas d’avoir besoin
d’information sur plusieurs dispositifs, enchaîner le reste des
demandes ci-après avec id=dispositif?)
dispositivo?
dispositivo?
<varInfo>
<var>
<id> ... </id>
<title> ... </title>
<hasValue> T </hasValue>
<hasLogger> T </hasLogger>
<sampleMode> … </sampleMode>
<measureUnits> … </measureUnits>
<unitsFactor> … </unitsFactor>
<decimals> … </decimals>
</var>
…
<varInfo>
-
Id : nom de la variable sous format dispositif.variable
-
title : description brève de la variable
-
hasValue : indique s’il est possible de demander la valeur
instantanée de la variable (True / False)
-
hasLogger : indique s’il est possible de demander
l’historique de valeurs de la variable (True / False)
-
sampleMode : type de variable et mode utilisé pour grouper
les valeurs
-
measureUnits : unité des variables
-
unitsFactor : puissance de 10 indiquant le facteur
multiplicateur dans le fichier des historiques
-
decimals : décimales de la variable
Valeur instantanée de la variable
L’utilisateur peut demander les valeurs instantanées d’une ou
plusieurs variables, et même demander l’information de
toutes les valeurs instantanées dans une seule demande.
4.3.1.3.- Valeur instantanée d’une ou plusieurs
variables
Demande pour solliciter la valeur instantanée d’une ou
plusieurs variables du dispositif (dans le cas d’avoir besoin
d’information de plusieurs variables, enchaîner le reste de
demandes ci-après avec var=dispositif.variable?)
4.3.1.4.- Valeur instantanée de toutes les variables
Demande pour solliciter la valeur instantanée de toutes les
variables du dispositif (dans le cas d’avoir besoin
d’information de plusieurs dispositifs, enchaîner le reste des
demandes ci-après avec id=dispositif?)
<values>
<variable>
<id> ... <id>
<value> ... </value>
</variable>
..
</values>
-
id : identificateur de la variable
-
value : valeur de la variable lors de la demande
Données historiques
Demande pour solliciter le registre des données historiques
d’une variable incrémentale. Retourne l’information
enregistrée d’une ou plusieurs variables entre les dates
« begin » et « end ». Chacune des variables dont on souhaite
obtenir une information doit être incluse dans la demande
comme ?var=dispositif.variable
Lorsqu’on souhaite indiquer seulement la date, le format est
DDMMAAAA ; lorsqu’on veut spécifier la date et heure, c’est
DDMMAAAAHHMMSS. Tant la date que l’heure, doivent être
indiquées en UTC (Universal Coordinated Time).
La période de groupement (period) pourra être définie par les
différents critères :
-
valeur en secondes (p.ex. 900) : valeur en secondes où
sont groupées les données
-
ALL : les données sont groupées dans une valeur unique
-
AUTO : le groupement est réalisé automatiquement à des
intervalles prédéfinis selon « begin » et « end »
-
FILE : les données ne sont pas groupées. L’information est
retournée telle qu’enregistrée dans la base de données
-
si le paramètre period n’apparaît pas dans la demande, cela
sera considéré comme une valeur 0 et les données ne
seront pas groupées.
cords.xml?begin=010320110000
00?end=31032011000000?var=dispositivo.variable?period=9
00
cords.xml?begin=010320
11000000?end=31032011000000?var=dispositivo.variable?p
eriod=900
<recordGroup>
<period> … </period>
<record>
<dateTime> ... </ dateTime >
<field>
<id> ... </id>
<value> ... </value>
</field>
</record>
…
</recordGroup>
-
recordGroup : champ qui identifie le XML comme réponse
à la demande de registres de variables
-
period : période de registre ; temps entre registres
-
record : identifie chacun des enregistrements (dateTime:
date et heure de l’échantillon
-
field : enregistrement valeur standard (pour d’autres
valeurs, consulter le manuel PS)
-
value
: valeur de la variable lors de la demande
Historique des événements
Comme montré dans le présent manuel d’utilisateur, à travers
l’Éditeur PowerStudio / Scada, il est possible de configurer
des événements ou alarmes, dans le dispositif EDS-3G et de
les enregistrer dans sa mémoire interne.
Avec la demande suivante, l’utilisateur peut demander
l’historique d’événements entre deux dates définies. Chaque
événement que l’on veut demander avec une demande
d’historiques, sera défini comme ?id=nom_événement
Lorsqu’on souhaite indiquer seulement la date, le format est
DDMMAAAA ; lorsqu’on veut spécifier la date et heure, c’est
DDMMAAAAHHMMSS. Tant la date que l’heure, doivent être
indiquées en UTC (Universal Coordinated Time).
vents.xml?begin=0103201100000
0?end=31032011000000?id=nombre_suceso?
vents.xml?begin=0103201
1000000?end=31032011000000?id=nombre_suceso?
<main>
<recordGroup>
<id> ... </id>
<record>
<date> … </date>
<eventId> … </eventId>
<annotation> … </annotation>
<value> … </value>
</record>
..
</recordGroup >
…
<main>
-
main : champ qui identifie le XML comme demande
-
recordGroup : champ qui groupe les enregistrements d’un
événement
-
id : identificateur de l’événement
-
record : identifie chacun des champs
-
date : date et heure de l’événement
-
eventId : identificateur de l’événement
-
annotation : annotation de l’événement
-
value : valeur de l’événement
ON : événement actif
OFF : événement inactif
ACK : événement reconnu
Événements d’un dispositif
Retourne l’information des événements enregistrés d’un ou
plusieurs dispositifs entre les dates « begin » et « end ».
Chacun des dispositifs dont on souhaite obtenir une
information doit être incluse comme ?id=dispositif
cordsEve.xml?begin=010320110
00000?end=31032011000000?id=dispositivo?
cordsEve.xml?begin=010
32011000000?end=31032011000000?id=dispositivo?
Lorsqu’on souhaite indiquer seulement la date, le format est
DDMMAAAA ; lorsqu’on veut spécifier la date et heure, c’est
DDMMAAAAHHMMSS. Tant la date que l’heure, doivent être
indiquées en UTC (Universal Coordinated Time).
<main>
<recordGroup>
<device> ... </device>
<record>
<dateTime> … </dateTime>
<field>
<id> … </id>
<value> … </value>
</field>
…
</record>
..
</recordGroup >
…
</main>
-
main : champ qui identifie le XML comme demande
-
recordGroup : champ qui groupe les registres d’un
événement
-
device : dispositif auquel se réfèrent les registres
-
record : identifie chacun des champs
-
dateTime : date et heure de l’événement
-
field : identifie chacun des champs
-
id : identificateur
-
value : valeur de l’événement
Événements actifs
EDS-3G dispose d’un service XML d’événements actifs dont
l’objectif est qu’un agent ou un système d’intégration externe
peut être enregistré comme auditeur (listener) et enregistrer
les événements ou alarmes qui se succèdent dans
l’équipement.
L’équipement maintient une liste de diffusion avec des
utilisateurs actifs, auxquels il envoie les événements qui se
produisent sous une forme locale, à travers la création des
événements.
4.3.1.5.- Commandes de test
Avant de commencer la mise en oeuvre du système
d’événements actifs, et dans l’objet de vérifier la connectivité
entre les deux systèmes, il existe une série de demandes de
test type PUT entre le listener (auditeur) et producer (moteur
à distance) et vice-versa, dont l’objectif est de tester et
d’assurer la connectivité entre les deux systèmes.
Pour que le listener puisse vérifier la connectivité avec le
moteur à distance (producer), il peut envoyer cette demande
avec le corps suivant du message :
<listener>
<ip>
ip_listener
</ip>
<port>80</port>
</listener>
-
ip_listener : définit l’IP de l’auditeur, a laquelle le producer
envoie la demande de réponse
-
port : définit le port de l’auditeur, à travers lequel le
producer envoie la demande de réponse
Le producer (moteur à distance) en recevant la demande de
test de la part du listener, retourne la demande suivante :
http://ip_listener:port/services/user/testProducer.xml
Demande à laquelle l’auditeur doit répondre avec un « reçu »
(200).
4.3.1.6.- Registre d’un listener (auditeur)