...
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> |
...