Beschreibung des Protokolls (PDF)
Beschreibung des Protokolls (PDF)
Beschreibung des Protokolls (PDF)
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
aqua plan
Inhaltsverzeichnis<br />
1 Motivation 4<br />
2 Einleitung 4<br />
3 starten und einrichten 5<br />
<br />
<br />
<br />
4 Funktionsbeschreibung 9<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
5 Format der Anfrage 20<br />
<br />
<br />
<br />
<br />
6 XML-Format 22
7 Binärformat 25
1 Motivation<br />
<br />
aqua plan <br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
2 Einleitung<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
– Niederschlag Abfluss <br />
– <br />
– <br />
– <br />
– <br />
–
– <br />
– <br />
<br />
– <br />
– <br />
– <br />
– <br />
– <br />
<br />
PV <br />
<br />
<br />
1.11.1991 1.11.2001 <br />
MaxFocus <br />
3 starten und einrichten<br />
3.1 Starten und beenden<br />
<br />
tstpd [option] [&]<br />
& <br />
<br />
<br />
<br />
>tstpd &<br />
[1] 30272<br />
===============================================<br />
tcp/tstp: unknown service, using 8030<br />
using port 8030, Authentication on<br />
29.04.2008 16:26:45 Release: 1 started.<br />
29.04.2008 16:26:45 36 items in cache.<br />
>
30272 <br />
<br />
8030 <br />
<br />
<br />
Authentication on<br />
36 <br />
<br />
<br />
kill<br />
ps -edalf <br />
<br />
>ps -edalf<br />
F S UID PID [...] CMD<br />
[...]<br />
0 S fgon 30902 [...] tstpd<br />
[...]<br />
>kill 30902<br />
[1] Exitcode 15 tstpd<br />
><br />
killall<br />
<br />
>killall tstpd<br />
[1] Exitcode 15 tstpd<br />
><br />
tstpd -d <br />
<br />
3.2 Optionen<br />
<br />
tstpd
usage: tstpd [OPTION]<br />
options:<br />
-noauth : disable authentication<br />
-p : use port rather than 8030<br />
-nowrite : disable all write access<br />
-pubonly : just serve published time series<br />
-timeonly : time series only, no real series<br />
-minbs : only send data with at least<br />
-action : call after PUT<br />
-verbose : be more verbose on init<br />
-enumids : use enumerated (dynamic) ids<br />
<br />
-noauth <br />
<br />
<br />
-p <br />
8030 <br />
<br />
<br />
-nowrite <br />
<br />
-pubonly <br />
PUBLIZIERT <br />
<br />
-timeonly <br />
<br />
<br />
-minbs <br />
1 5 <br />
<br />
<br />
-minbs
-action <br />
<br />
<br />
<br />
-verbose <br />
<br />
<br />
<br />
<br />
<br />
<br />
-enumids <br />
<br />
<br />
<br />
<br />
<br />
1 <br />
<br />
<br />
3.2.1 Aktion nach PUT<br />
-action <br />
<br />
<br />
<br />
<br />
<br />
&<br />
<br />
ZRID
URL <br />
von <br />
bis <br />
4 Funktionsbeschreibung<br />
QUERY GET PUT<br />
SETATTR INSPECT QNUM CREATE DELETE DELETEQUAL GETDVAL <br />
<br />
<br />
<br />
<br />
<br />
<br />
PUT<br />
<br />
<br />
<br />
4.1 QUERY
ZRID <br />
<br />
<br />
http://www.tstp.net:8030/?Cmd=Query&Parameter=Wasserstand&Ort=2400*<br />
&DefArt=K<br />
<br />
<br />
GET ?Cmd=Query&Parameter=Wasserstand&Ort=2400*&DefArt=K HTTP/1.0\n<br />
Host: tstp.aquaplan.de\n<br />
Authorization: Basic \n<br />
Connection: Close\n\n<br />
<br />
Wasserstand <br />
Kontinuierlich 2400 * <br />
<br />
2400 <br />
QUERY <br />
Parameter<br />
Ort<br />
SubOrt<br />
DefArt<br />
Aussage<br />
XDistanz<br />
XFaktor<br />
Herkunft<br />
Reihenart<br />
Version
Quelle<br />
<br />
<br />
<br />
<br />
http://www.tstp.net:8030/?Cmd=Query&PV=BW001SO90T56<br />
TSQ <br />
TSATTR <br />
<br />
Wert <br />
<br />
<br />
<br />
<br />
<br />
PK8n4XrPPUfYpndH6GLH6A<br />
1960-05-06T12:02:00Z<br />
2001-08-01T00:00:00Z<br />
1<br />
Wasserstand<br />
24004501<br />
K<br />
<br />
E<br />
1<br />
O<br />
Z<br />
0<br />
2526320<br />
5640320<br />
<br />
<br />
cm<br />
0.0000
1.0000<br />
0.0000<br />
<br />
<br />
83<br />
<br />
<br />
<br />
F<br />
1990-05-29T11:33:00Z<br />
1995-06<br />
<br />
<br />
J7v2xiGggfJNPSCJNaTtFw<br />
1950-05-29T11:33:00Z<br />
1999-06<br />
3<br />
Wasserstand<br />
24006008<br />
K<br />
<br />
E<br />
1<br />
O<br />
Z<br />
0<br />
2519320<br />
5649600<br />
<br />
<br />
cm<br />
0.0000<br />
0.0500<br />
0.0000<br />
<br />
<br />
57<br />
<br />
T<br />
1990-05-29T11:33:00Z<br />
1995-06<br />
<br />
<br />
<br />
<br />
<br />
http://www.tstp.net:8030/?Cmd=Query&ZRID=pYMb9a2wMHkKtNf7ElfwOg<br />
<br />
4.2 GET<br />
ZRID <br />
Von= Bis= <br />
Qual=[0..47] <br />
<br />
DEF DefArt<br />
<br />
Einheit <br />
Reihenart <br />
<br />
Typ=Asc <br />
<br />
http://www.tstp.net:8030/?Cmd=Get&ZRID=1234&Von=2003.08.11T12:35:21Z<br />
&Bis=2003.08.31T11:55:01Z&Qual=1<br />
ANZ <br />
LEN <br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
]]><br />
<br />
<br />
<br />
zzzzzzzz ffff <br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
4.3 PUT<br />
ZRID
POST /?Cmd=PUT&ZRID=123&QUAL=2 HTTP/1.0\n<br />
Host: www.tstp.net:8030\n<br />
Authorization: Basic \n<br />
Content-Length: \n<br />
Connection: Close\n\n<br />
<br />
<br />
<br />
<br />
]]><br />
<br />
<br />
<br />
confirm<br />
<br />
<br />
<br />
Spezialfall Niederschlag<br />
<br />
<br />
<br />
<br />
MESAUS DEF <br />
SUMLIN <br />
<br />
SUML0
DELTA <br />
INTENS <br />
Alle <br />
<br />
<br />
<br />
<br />
]]><br />
<br />
4.4 Arbeitsweise der Zeitreihen-Datenbank beim Einfügen<br />
<br />
+Infty -Infty <br />
Luecke <br />
<br />
<br />
<br />
immer <br />
<br />
<br />
alle
4.5 SETATTR<br />
ZRID <br />
nicht <br />
INFO LEBENSLAUF<br />
<br />
http://www.tstp.net:8030/?Cmd=SetAttr&ZRID=1234&Attr=Kommentar<br />
&Wert=ABCDEF<br />
<br />
confirm<br />
<br />
<br />
<br />
4.6 CREATE<br />
<br />
ZRID <br />
ZRID 0 <br />
<br />
http://www.tstp.net:8030/?Cmd=Create&Parameter=Niederschlag<br />
&Ort=24003123&SubOrt=0&DefArt=K&Aussage=Sum&Herkunft=O<br />
&Reihenart=Z&Version=0&Quelle=S<br />
ZRID <br />
ZRID=1234
ZRID=0<br />
<br />
4.7 DELETE<br />
ZRID <br />
<br />
http://www.tstp.net:8030/?Cmd=Delete&ZRID=1234<br />
<br />
confirm<br />
<br />
<br />
<br />
4.8 DELETEQUAL<br />
ZRID <br />
<br />
<br />
http://www.tstp.net:8030/?Cmd=DeleteQual&ZRID=1234<br />
&Von=2003.02.01T11:14:00Z&Bis=2003.23.22T12:31:00Z&Qual=2<br />
<br />
confirm<br />
<br />
<br />
<br />
4.9 INSPECT<br />
ZRID
http://www.tstp.net:8030/?Cmd=Inspect&ZRID=1234<br />
&Von=2003.01.01T00:00:00Z&Bis=2004.01.01T00:00:00Z<br />
<br />
<br />
2<br />
2<br />
<br />
<br />
2009.11.10T20:03:23Z<br />
<br />
<br />
<br />
<br />
4.10 QNUM<br />
ZRID <br />
<br />
<br />
<br />
http://www.tstp.net:8030/?Cmd=QNUM&ZRID=1234<br />
&Von=2003.01.01T00:00:00Z&Bis=2004.01.01T00:00:00Z<br />
<br />
<br />
2654<br />
<br />
<br />
<br />
4.11 GETDVAL<br />
ZRID Von= <br />
Bis= IB= <br />
Aussage= Mit <br />
Qual=[0..50]<br />
<br />
http://www.tstp.net:8030/?Cmd=GetDVal&ZRID=1234&Von=2003.02.01T11:15:00Z<br />
&Bis=2003.03.22T12:30:00Z&IB=5Min&Aussage=MIT<br />
<br />
GET <br />
IB XFaktor XDistanz <br />
<br />
4.12 UPDATE<br />
ZRID <br />
MaxFocus <br />
<br />
<br />
http://www.tstp.net:8030/?Cmd=Update&ZRID=1234<br />
<br />
confirm<br />
<br />
<br />
ZRID <br />
<br />
5 Format der Anfrage<br />
5.1 Authentifizierung<br />
<br />
Authorization: Basic username:password <br />
username:password
GET ?Cmd=Query&Parameter=Wasserstand&Ort=2400*&DefArt=K HTTP/1.0<br />
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
5.2 URL-Format<br />
<br />
<br />
<br />
http://www.tstp.net:8030/?<br />
<br />
Cmd=Query|Get|Put|SetAttr|Create|Delete|DeleteQual|GetDVal<br />
<br />
http://www.tstp.net:8030/?Cmd=Create<br />
<br />
= Ort=24003100 <br />
& <br />
<br />
http://www.tstp.net:8030/?Cmd=Query&Ort=2400*<br />
DefArt Aussage XDistanz Herkunft Reihenart<br />
Quelle
5.3 Zeitpunkt<br />
<br />
<br />
<br />
YYYY-MM-DDThh:mm:ssZ 1997-07-16T19:20:30Z<br />
<br />
<br />
<br />
<br />
T <br />
<br />
<br />
<br />
Z Z<br />
<br />
<br />
..[_:[:]]<br />
<br />
<br />
5.4 Zeitintervall<br />
Von= <br />
Bis= <br />
6 XML-Format<br />
<br />
<br />
<br />
HTTP/1.0 200 OK<br />
Date: Tue, 28 Oct 2003 13:49:10 GMT<br />
Server: TSTPD/1.0 (UNIX)<br />
Last-Modified: Tue, 28 Oct 2003 13:49:10 GMT
Expires: Tue, 28 Oct 2003 13:49:10 GMT<br />
Cache-Control: max-age=0<br />
Connection: close<br />
Content-Length: 6733<br />
Content-Type: text/plain; charset=ISO-8859-1<br />
<br />
<br />
...<br />
<br />
<br />
6.1 Attributliste<br />
<br />
<br />
<br />
<br />
<br />
<br />
dN28eSEVIMADyNScIH5BRA<br />
1964-06-01T00:00:00Z<br />
2005-11-01T00:00:00Z<br />
0<br />
Abflusskurven<br />
24004002<br />
..<br />
<br />
<br />
PBtPWnBsFZb9jawtmc61bg<br />
..<br />
<br />
6.2 Massendaten<br />
<br />
RELEASE="" <br />
<br />
<br />
<br />
REIHENART="" Z<br />
TEXT="Nein"<br />
DEFART="" K,I,M<br />
EINHEIT="" m^3/s <br />
LEN=""<br />
<br />
<br />
YYYY.MM.DDThh:mm:ssZ <br />
<br />
. <br />
<br />
<br />
<br />
<br />
<br />
<br />
7 Binärformat<br />
7.1 Massendaten<br />
<br />
LEN <br />
ANZ <br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
XY X Y <br />
4E+37 <br />
C2 BD F0 7D <br />
<br />
0 1 2
Binärformat Zeit-/Realpunkt<br />
<br />
<br />
<br />
0: <br />
Zeitpunkt <br />
<br />
1: <br />
Realpunkt <br />
<br />
2: <br />
Zeitpunkt
Anhang A<br />
DefArt<br />
Erlaubter Wert Bedeutung URL-Kodierung<br />
K Kontinuierlich DefArt=K<br />
I Intervall DefArt=I<br />
M Momentan DefArt=M
Aussage<br />
Erlaubter Wert Bedeutung URL-Kodierung<br />
Mes (Hand-)Messungen Aussage=Mes<br />
Sum Summen Aussage=Sum<br />
Mit Mittelwerte Aussage=Mit<br />
Max Maxima Aussage=Max<br />
Min Minima Aussage=Min<br />
DMax Maxima-Zeitpunkte Aussage=DMax<br />
DMin Minima-Zeitpunkte Aussage=DMin<br />
Abl Ableitungen Aussage=Abl<br />
Int Integral Aussage=Int<br />
Dau Dauerlinie Aussage=Dau<br />
<strong>PDF</strong> Wahrscheinlichkeits-Dichte Aussage=<strong>PDF</strong><br />
VF Verteilungsfunktion Aussage=VF<br />
Lck LückenReihe Aussage=Lck<br />
Ant Lückenanteile Aussage=Ant<br />
OS Obere Schranke Aussage=OS<br />
US Untere Schranke Aussage=US<br />
pSe Partielle Serie Aussage=pSe<br />
jSe Jährliche Serie Aussage=jSe<br />
pVP Partielle Verteilungspar. Aussage=pVP<br />
jVP Jährliche Verteilungspar. Aussage=jVP<br />
ERG Ereignisse Aussage=ERG<br />
NER NEreignisse Aussage=NER<br />
jSN J. Ser. N. Aussage=jSN<br />
pSN Part. Ser. N. Aussage=pSN<br />
Kon Kontrollwerte Aussage=Kon<br />
XSy X-Synchropunkte Aussage=XSy<br />
YSy Y-Synchropunkte Aussage=YSy<br />
DMin DMax <br />
<br />
<br />
Herkunft<br />
Erlaubter Wert Bedeutung URL-Kodierung<br />
O original Herkunft=O<br />
T transformiert Herkunft=T<br />
S simuliert Herkunft=S<br />
A abgeleitet Herkunft=A<br />
M temporär Herkunft=M<br />
B trendbereinigt Herkunft=B<br />
F ZRFolge Herkunft=F<br />
P periodisch Herkunft=P
Reihenart<br />
Erlaubter Wert Bedeutung URL-Kodierung<br />
Z Zeitreihe Reihenart=Z<br />
R Realreihe Reihenart=R<br />
<br />
Quelle<br />
Erlaubter Wert Bedeutung URL-Kodierung<br />
L Datenlogger Quelle=L<br />
S Schreibstreifen Quelle=S<br />
H Handeingabe Quelle=H<br />
P Produktion Quelle=P<br />
T Testversion Quelle=T<br />
(leer) Quelle=
Change language