...
Please note: this information provider has very strict security rules, and data can only be accessed whileusing VPN and google authenticate.
This import can download data from two different SOAP endpoints: PrecipitacaoObservada and Grandezas Hidrologicas. Both the request bodies and responses are very similar, but there are some differences, detailed bellow.
...
Grandeza --> timeseries parameter, filled in by FEWS automatically, using the external parameter ID from the configured time series. The following parameters are supported: "VMD","AFL","DFL","TUR","VER","VTR","VOE","NIV","NJS","VNA","VNM","VNS","VIA". In one request only one parameter can be used, but FEWS will loop through all parameters one by one automatically.
Request body examples:
Headers:
...
Code Block | ||||
---|---|---|---|---|
| ||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://ons.org.br/Hidrologia/v1"> <soapenv:Header/> <soapenv:Body> <v1:GrandezasHidrologicas> <v1:Pagina>1</v1:Pagina> <v1:Quantidade>1000</v1:Quantidade> <v1:IdPostoReservatorio> <v1:string>TOUHSA</v1:string> <v1:string>AAFGO</v1:string> </v1:IdPostoReservatorio> <v1:Grandeza>AFL</v1:Grandeza> <v1:DataInicioMedicao>01/01/2020</v1:DataInicioMedicao> <v1:DataFimMedicao>26/10/2020</v1:DataFimMedicao> <v1:QualidadeDado> <v1:string>CON</v1:string> </v1:QualidadeDado> <v1:AgregacaoTemporal>DI</v1:AgregacaoTemporal> </v1:GrandezasHidrologicas> </soapenv:Body> </soapenv:Envelope> |
Config example:
Username and password are not used.
...
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?> <!-- edited with XMLSpy v2006 rel. 3 sp1 (http://www.altova.com) by Computer Services (WL | Delft Hydraulics) --> <timeSeriesImportRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd"> <import> <general> <importType>ONSSoap</importType> <serverUrl>http://tst-appdmz-113.ons.org.br/hidrologia/hidrologia.asmx</serverUrl> <!-- this field is not used, but it is necessary to be able to configure connection timout--> <backupServerUrl>http://tst-appdmz-113.ons.org.br/hidrologia/hidrologia.asmx</backupServerUrl> <!-- if this field is not configured, it will be set at 2000 automatically. --> <connectionTimeOutMillis>100000</connectionTimeOutMillis> <user>user<<user>dummy_username</user> <password>password<<password>dummy_password</password> <relativeViewPeriod unit="day" start="-3" end="0" startOverrulable="true" endOverrulable="true"/> <idMapId>ONSSoapMap</idMapId> </general> <properties> <string key="QD" value="CON"></string> <!-- This determined if we are importing PrecipitacaoObservada (false), or Grandezas Hidrologicas(true). Default is true--> <bool key="addParamToRequest" value="true"></bool> </properties> <timeSeriesSet> <moduleInstanceId>ONSSoap</moduleInstanceId> <valueType>scalar</valueType> <parameterId>param1</parameterId> <locationId>LocB</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep unit="hour" multiplier="24"/> <readWriteMode>add originals</readWriteMode> </timeSeriesSet> <timeSeriesSet> <moduleInstanceId>ONSSoap</moduleInstanceId> <valueType>scalar</valueType> <parameterId>param1</parameterId> <locationId>LocA</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep unit="hour" multiplier="24"/> <readWriteMode>add originals</readWriteMode> </timeSeriesSet> </import> <import> <general> <importType>ONSSoap</importType> <serverUrl>http://tst-appdmz-113.ons.org.br/hidrologia/hidrologia.asmx</serverUrl> <!-- this field is not used, but it is necessary to be able to configure connection timout--> <backupServerUrl>http://tst-appdmz-113.ons.org.br/hidrologia/hidrologia.asmx</backupServerUrl> <!-- if this field is not configured, it will be set at 2000 automatically. --> <connectionTimeOutMillis>100000</connectionTimeOutMillis> <user>user<<user>dummy_username</user> <password>password<<password>dummy_password</password> <relativeViewPeriod unit="day" start="-100" end="0" startOverrulable="true" endOverrulable="true"/> <idMapId>ONSSoapMap</idMapId> </general> <properties> <string key="QD" value="CD"></string> <!-- This determined if we are importing PrecipitacaoObservada (false), or Grandezas Hidrologicas(true). Default is true--> <bool key="addParamToRequest" value="false"></bool> <string key="furoTemporal" value="N"></string> </properties> <timeSeriesSet> <moduleInstanceId>ONSSoap</moduleInstanceId> <valueType>scalar</valueType> <parameterId>param2</parameterId> <locationId>LocC</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep id="day12"/> <readWriteMode>add originals</readWriteMode> </timeSeriesSet> </import> </timeSeriesImportRun> |
...