XHydro
Trennungslinie

WSDL

and associated schema files with the definition of data types



This WSDL defines a "WS-I Basic Profile" - compatible, SOAP - based web service as an interface to obtain as well as to send XHydro - time series.

Data sources, such as data collectors or servers, can provide time series for retrieval via this interface.
The service can also be used for the delivery of time series, e.g. data collectors can send their latest measured values for the purpose of archiving to a server.

Structurally, the XHydro - Web Service WSDL is geared to the Sensor Observation Service (SOS) of the Open Geospatial Consortium (OGC).
This is reflected by the following features:
  • All operation names are based on the names in the SOS WSDL:
    • GetObservation
      • Provides time series with measured data from the requested period
    • GetLastObservation
      • Returns the most recent measurement data of the requested time series
        (This operation is not present in SOS.)
    • InsertObservation
      • Stores a time series with its measurement data

  • Modeling of the operations with request and response types:
    • Even if the response contains only a functional element, such as the "TimeSeriesListType" - element in XHydro, it is packaged in a response type.
      Thus, the interface meets the "Request - Response" - paradigm and remains consistent with the SOS.
  • Each operation and its associated data types are stored in a separate schema file, referenced by the WSDL.
  • Operations use different PortTypes, namely the "ObservationRetrievalInterface" for read access, and the "ObservationInsertionInterface" for write access.
  • Soap Faults and their associated messages, in both cases, have the suffix "Exception".


Interface description for obtaining and sending time series
11.2015
Request- and response-types for GetObservation
11.2015
Request- and response types for GetLastObservation
11.2015
Request- and response types for InsertObservation
11.2015
Exception-type for error messages
11.2015