Overview

The Element360Metadata importer allows access to sensor metadata from the Element360 (previously Contrail) data exchange APIs. 

The import feature is available since October 2024, from Delft-FEWS version 2024.02 onwards.

Authentication

The Element360 APIs allows access by a system key. This system key needs to be specified in the properties of the import configuration.

Configuration (Example)

A complete import module configuration consists of an ID Mapping file and a Import Module Instance file. In the id mapping, the external location is equal to the sensor id, the external parameter can be any xml tags with scalar values in the GetSensorData response. For example "valid", "active", and "normal" are accepted values.

To convert the values to a chosen parameter unit, it is also required to configure a Unit Conversion file.

ModuleConfigFiles

The following example of an Import Module Instance will import the Element360 sensor data for sensor with id 100T13C_02 for the past day.
Import_Element360Metadata.xml

<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>Element360Metadata</importType>
            <serverUrl>https://cs-074-exchange.onerain.com/OneRain/DataAPI</serverUrl>
            <relativeViewPeriod unit="day" start="-1" end="0"/>
            <idMapId>IdImportElement360Metadata</idMapId>
            <unitConversionsId>ImportUnitConversions</unitConversionsId>
        </general>
        <properties>
            <string key="systemKey" value="to_add"></string>
        </properties>
 
        <timeSeriesSet>
            <moduleInstanceId>Import_Element360</moduleInstanceId>
            <valueType>scalar</valueType>
            <parameterId>active</parameterId>
            <locationId>100011A</locationId>
            <timeSeriesType>external historical</timeSeriesType>
            <timeStep unit="nonequidistant"/>
            <readWriteMode>read only</readWriteMode>
        </timeSeriesSet>
    </import>
</timeSeriesImportRun>

IdMapFiles

Defines the ID mapping of the parameters.
sample ofIdImportElement360Metadata.xml

<idMap 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/idMap.xsd" version="1.1">
    <map internalLocation="100011A" internalParameter="active" externalLocation="100011A_WL" externalParameter="active"/>
</idMap>


  • No labels

Disclaimer