Xml-dienste, Information zu einer oder mehreren variablen, Informationen zu allen variablen – CIRCUTOR EDS-3G Series Benutzerhandbuch
Seite 4: Momentaner wert einer oder mehrerer variablen, Momentaner wert aller variablen
EDS-3G
M98240601-06-13B
34
Falscher Comm
66
Falsches Gerät
4.3.- XML-Dienste
Die Anforderungen müssen dem Standard URI (RFC 2396)
entsprechen. Dies muss der Benutzer dieser Anforderungen
bei dieser Art Abruf berücksichtigen (besonders wenn der
Name eines Gerätes andere Zeichen als ASCII-Zeichen
enthält). Außerdem muss berücksichtigt werden, dass die
Länge der Anforderung in keinem Fall 4000 Zeichen
überschreiten darf.
4.3.1.- Anforderung konfigurierter Geräte
Mit dieser Anforderung meldet der XML-Dienst die Liste der
Geräte, die an die Energieeffizienz-Steuereinheit EDS-3G
angeschlossen sind.
<devices>
<id> ... </id>
<devices>
-
devices: dieses Feld identifiziert den XML als Antwort auf
die Anforderung der Geräte
-
id: Name der einzelnen Geräte
4.3.2.- Informationen über das Gerät
Mit dieser Anforderung meldet der XML-Dienst die
Informationen über die Geräte. Die einzelnen Geräte, von
denen Informationen erhalten werden sollen, müssen in der
Anfrage als ?id=Gerät1?id=Gerät2… enthalten sein.
d=dispositivo?
http://nombre_dhcp/services/user/deviceInfo.xml?id=dispo
sitivo?
<devices>
<device>
<id> ... <id>
<description> ... </description>
<type> ... </type>
<typeDescription> ... </typeDescription>
<var> ... </var>
...
</device>
...
<devices>
-
description: Beschreibung des Gerätes
-
type: Art des Gerätes
-
typeDescription: detaillierte Beschreibung des Gerätes
-
var: Name der einzelnen Variablen des Gerätes; Angabe
als name.variable
4.3.3.- Information zur Variable
Der Benutzer kann detaillierte Informationen einer oder
mehrerer Variablen eines Gerätes anfordern und sogar in
einer einzigen Anforderung die Informationen aller im Gerät
verfügbaren Variablen anfordern.
4.3.3.1.- Information zu einer oder mehreren Variablen
Anforderung der detaillierten Informationen einer oder
mehrerer Variablen des Gerätes (wenn die Informationen
mehrerer Variablen erforderlich sind, die restlichen
Anforderungen anschließend mit var=gerät.variable?
verketten):
http://x.x.x.x/services/user/varInfo.xml?var=dispositivo.variabl
e?
http://nombre_dhcp/services/user/varInfo.xml?var=dispositivo.
variable?
4.3.3.2.- Informationen zu allen Variablen
Anforderung der detaillierten Informationen zu allen Variablen
des Gerätes (wenn die Informationen mehrerer Geräte
erforderlich sind, die restlichen Anforderungen anschließend
mit id=gerät? verketten):
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: Name der Variablen mit Format gerät.variable.
-
title: Kurzbeschreibung der Variablen
-
hasValue: Anzeige, ob die Abfrage des momentanen Werts
der Variablen möglich ist (True / False)
-
hasLogger: Anzeige, ob eine Abfrage der Wertehistorie
der Variablen möglich ist (True / False)
-
sampleMode: Variablentyp und verwendeter Modus für die
Wertegruppierung
-
measureUnits: Einheit der Variablen
-
unitsFactor: Hoch 10, Angabe des Multiplikationsfaktors in
der Datei historischer Daten
-
decimals: Dezimalwerte der Variablen
4.3.4.- Momentaner Wert der Variablen
Der Benutzer kann die momentanen Werte einer oder
mehrerer Variablen und sogar die Informationen aller
momentanen Werte in einer einzigen Anforderung abfragen.
4.3.4.1.- Momentaner Wert einer oder mehrerer
Variablen
Anforderung des momentanen Werts einer oder mehrerer
Variablen des Gerätes (wenn die Informationen mehrerer
Variablen erforderlich sind, die restlichen Anforderungen
anschließend mit var=gerät.variable? verketten):
?
http://nombre_dhcp/services/user/
v
alues.xml?var=dispositivo.
variable?
4.3.4.2.- Momentaner Wert aller Variablen
Anforderung des momentanen Werts aller Variablen des
Geräts (wenn die Informationen mehrerer Geräte erforderlich
sind, die restlichen Anforderungen anschließend mit id=gerät?
verketten):
http://x.x.x.x/services/user/values.xml?id=dispositivo?
http://nombre_dhcp/services/user/
v
alues.xml?id=dispositivo?
<values>
<variable>
<id> ... <id>
<value> ... </value>
</variable>
...
</values>
-
id: Kennung der Variablen
-
value: Wert der Variablen zum Zeitpunkt der Anforderung
4.3.5.- Historische Daten
Anforderung des Registers mit historischen Daten zu einer
inkrementalen Variablen. Als Antwort erhält man die
registrierten Informationen einer oder mehrerer Variablen
zwischen dem Datum „begin” (Anfang) und „end” (Ende). Die
einzelnen Variablen, über die Informationen abgefragt
werden, müssen in der Anforderung als ?var=gerät.variable
enthalten sein.
Wenn nur das Datum angegeben werden soll, ist das Format
TTMMJJJJ; wenn Datum und Uhrzeit angegeben werden
sollen, ist das Format TTMMJJJJSSMMSS. Sowohl Datum
als auch Uhrzeit müssen in UTC (Universal Coordinated
Time, Weltzeit) angegeben werden.
Die Gruppierungsperiode (period) kann nach verschiedenen
Kriterien definiert werden:
-
Wert in Sekunden (z. B. 900): Wert in Sekunden, in denen
die Daten gruppiert werden
-
ALL: die Daten werden in einem einzigen Wert gruppiert
-
AUTO: die Gruppierung erfolgt automatisch mit den
vordefinierten Intervallen gemäß „begin” und „end”
-
FILE: die Daten werden nicht gruppiert. Die Daten werden
so gemeldet, wie sie in der Datenbank registriert sind
-
wenn der Parameter period in der Anforderung nicht
enthalten ist, wird er als Wert 0 betrachtet und die Daten
werden nicht gruppiert
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: Feld, mit dem der XML als Antwort auf die
Anforderung von Variablenregistern gekennzeichnet wird
-
period: Registerzeitraum; Zeitraum zwischen Registern
-
record: Kennzeichnung der einzelnen Register (dateTime:
Datum und Uhrzeit der Ablesung
-
field: Register Standardwert (sonstige siehe PS-Handbuch)
-
value: Wert der Variablen zum Zeitpunkt der Anforderung
4.3.6.- Ereignishistorie
Wie in diesem Benutzerhandbuch beschrieben, können
mittels der Anwendung Editor PowerStudio / Scada
Ereignisse bzw. Alarme im EDS-3G-Gerät konfiguriert
werden, um diese im internen Speicher zu speichern.
Mit der folgenden Anforderung kann der Benutzer die
Ereignishistorie zwischen zwei definierten Daten abfragen.
Jedes Ereignis, das mit einer Anforderung der Ereignishistorie
abgefragt wird, ist als ?id=name_ereignis definiert.
Wenn nur das Datum angegeben werden soll, ist das Format
TTMMJJJJ; wenn Datum und Uhrzeit angegeben werden
sollen, ist das Format TTMMJJJJSSMMSS. Sowohl Datum
als auch Uhrzeit müssen in UTC (Universal Coordinated
Time, Weltzeit) angegeben werden.
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: Feld, das den XML als Anforderung definiert
-
recordGroup: Feld, in dem die Eintragungen eines
Ereignisses gruppiert sind
-
id: Kennung des Ereignisses
-
record: Kennzeichnung der einzelnen Register
-
date: Datum und Uhrzeit des Ereignisses
-
eventId: Kennung des Ereignisses
-
annotation: Notierung des Ereignisses
-
value: Wert des Ereignisses
ON: Ereignis aktiv
OFF: Ereignis inaktiv
ACK: Ereignis quittiert
4.3.7.- Ereignis eines Geräts
Meldet die registrierten Ereignisse eines oder mehrerer
Geräte zwischen den Zeitpunkten „begin” (Anfang) und „end”
(Ende). Die einzelnen Geräte, von denen Informationen
erhalten werden sollen, müssen als ?id=gerät enthalten sein.
ecordsEve.xml?begin=010320110
00000?end=31032011000000?id=dispositivo?
cordsEve.xml?begin=010
32011000000?end=31032011000000?id=dispositivo?
Wenn nur das Datum angegeben werden soll, ist das Format
TTMMJJJJ; wenn Datum und Uhrzeit angegeben werden
sollen, ist das Format TTMMJJJJSSMMSS. Sowohl Datum
als auch Uhrzeit müssen in UTC (Universal Coordinated
Time, Weltzeit) angegeben werden.
<main>
<recordGroup>
<device> ... </device>
<record>
<dateTime> … </dateTime>
<field>
<id> … </id>
<value> … </value>
</field>
…
</record>
...
</recordGroup >
…