Versions Compared

Old Version 1

changes.mady.by.user Magali Cougnenc

Saved on

compared with

New Version Current

changes.mady.by.user Magali Cougnenc

Saved on

Key

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

Overview

The Element360 importer allows access to sensor data 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 API 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 and external parameter have the same value, corresponding to the sensor id.

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_Element360.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>Element360</importType>
            <serverUrl>https://cs-074-exchange.onerain.com/OneRain/DataAPI</serverUrl>
            <relativeViewPeriod unit="day" start="-1" end="0"/>
            <idMapId>IdImportElement360</idMapId>
            <unitConversionsId>ImportUnitConversions</unitConversionsId>
        </general>
        <properties>
            <string key="systemKey" value="

f1c57fb7-ad34-4613-b19d-1b916d8e39ab

to_add"></string>
        </properties>
 
        <timeSeriesSet>
            <moduleInstanceId>Import_Element360</moduleInstanceId>
            <valueType>scalar</valueType>
            <parameterId>Gate-02</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 of IdImportElement360.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="Gate-02" externalLocation="100T13C_02" externalParameter="100T13C_02"/>
</idMap>