XHydro
 Home
 Warum XHydro
 Schema-Dokumentation
 UML-Modell
 Schema-Dateien
 WSDL
   WSDL-flat
 Downloads
 Beispiele
 Impressum
 
Trennungslinie

WSDL

und zugehörige Schema-Dateien mit Definition der Datentypen



Die vorliegende WSDL definiert eine "WS-I Basic Profile" - kompatible, SOAP-basierte Web Service - Schnittstelle zum Abruf, sowie zum auch Versenden von XHydro-Zeitreihen.

Datenquellen, wie Datensammler oder Server, können über diese Schnittstelle Zeitreihen zum Abruf bereitstellen.
Der Service lässt sich auch zum Versand von Zeitreihen nutzen, z.B. indem Datensammler ihre jeweils aktuell erfassten Messwerte zur Archivierung an einen Server versenden.

Strukturell lehnt sich der XHydro - WebService - WSDL an den Sensor Observation Service (SOS) des Open Geospatial Consortium (OGC) an.
Dies spiegelt sich in folgenden Eigenschaften wider:
  • Alle Operation-Namen orientieren sich an den Namen in der SOS-WSDL:
    • GetObservation
      • Liefert Zeitreihen mit Messdaten aus dem angefragten Zeitraum
    • GetLastObservation
      • Liefert die jeweils aktuellsten Messdaten der angefragten Zeitreihen
        (Diese Operation ist nicht namentlich in SOS vorhanden.)
    • InsertObservation
      • Speichert eine Zeitreihe mit Messdaten

  • Modellierung der Operationen mit Request- und Response-Typen:
    • Selbst wenn die Antwort nur ein fachliches Element wie z. B. das "TimeSeriesListType"-Element in XHydro enthält, ist dieses in einem Response-Typ verpackt.
      Dadurch erfüllt die Schnittstelle das "Request-Response" - Paradigma und bleibt konsistent zum SOS.
  • Jede Operation mit den dazugehörigen Typen liegt in einer eigenen Schema-Datei, die von der WSDL referenziert wird.
  • Operationen sind in die PortTypes "ObservationRetrievalInterface" für lesenden, und "ObservationInsertionInterface" für schreibenden Zugriff aufgeteilt.
  • Soap-Faults und die dazugehörigen Messages haben in beiden Fällen das Suffix "Exception".


WSDL u. Schema-Dateien    
Beschreibung
Version
XHydroObservationService.wsdl
Schnittstellendefinition zum Abruf und Versand
11.2015
GetObservation.xsd
Request- und Response-Typen für GetObservation
11.2015
GetLastObservation.xsd
Request- und Response-Typen für GetLastObservation
11.2015
InsertObservation.xsd
Request- und Response-Typen für InsertObservation
11.2015
WSCommon.xsd
Exception-Typ für Fehlerbenachrichtigungen
11.2015