Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Number: questions of type number will be stored as a fews parameter with the question name as parameter name. In this example the pH parameter is configured as a Number.

Image Modified

 

Option: questions of type Option will be stored as a fews qualifier with the question name followed by the option value. For example: colour_Red.

Image Modified

 

Caddisfly tests will be stored as parameter values.

Image Modified

 

Configuring the Import

An example of the Akvo import configuration will be given here. The importType is named Akvo which should be configured in the general section of the import. De URL to the rest service should be configured here as well.Time is assumed to be specified in GMT and data is assumed to be UTF-8 encoded.

For the import configuration 2 properties are required. The siteRegisrationSurveyId and the siteMonitoringSurveyId. The id's can be found in the akvo flow web interface. See the following screenshots: 

Image ModifiedImage Modified

In this example the site monitoring survey id = 170003 and the registration survey id = 1100001.

...

In the following configuration all locations are configured one by one for demonstration purposes. A locationSet would be more appropriated. The location id's can be found in the Akvo app. They are also logged by FEWS during the import.

An example of the Akvo import configuration is given here. The importType is named Akvo which should be configured in the general section of the import. De URL to the rest service should be configured here as well.Time is assumed to be specified in GMT and data is assumed to be UTF-8 encoded.

Code Block
xml
xml
<?xml version="1.0" encoding="UTF-8"?>
<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>Akvo</importType>
			<serverUrl>https://akvoflow-141.appspot.com/api/v1</serverUrl>
			<user>AKVO_ACCESS_KEY</user> <!-- akvo access key -->
			<password>AKVO_SECRET</password> <!-- akvo secret -->
			<relativeViewPeriod unit="day" start="-20" end="0" startOverrulable="true" endOverrulable="false"/> <!-- read all survey instances of the last 20 days -->
			<idMapId>idAkvo</idMapId>
		</general>
		<properties>
			<string value="1100001" key="siteRegistrationSurveyId"></string>
			<string value="170003" key="siteMonitoringSurveyId"></string>
		</properties>
		<timeSeriesSet>
			<moduleInstanceId>ImportAkvo</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>pH</parameterId>
			<locationId>b1b2-8xh1-pt21</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportAkvo</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>pH</parameterId>
			<locationId>4yes-fjqk-ceh5</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportAkvo</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>pH</parameterId>
			<locationId>ycwm-vu8j-2ts1</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
	</import>
</timeSeriesImportRun>

...