TSM Time Series Configuration
The TimeSeries section configures the default values that apply to time series, such as the time zone in which time series without an assigned time zone are returned and the start of time. Default values are already set but can be changed using these configuration settings.
Configuration Path
Section titled “Configuration Path”HAKOM:TSM:TimeSeriesConfiguration Structure
Section titled “Configuration Structure”TimeSeries└─ Defaults ├─ PreserveDuplicatedValues ├─ TimeZone └─ StartOfTimeQuick Start
Section titled “Quick Start”Return time series that have no time zone assigned in W. Europe Standard Time:
<HAKOM> <TSM> <TimeSeries> <Defaults> <TimeZone>W. Europe Standard Time</TimeZone> </Defaults> </TimeSeries> </TSM></HAKOM>Configuration Elements
Section titled “Configuration Elements”PreserveDuplicatedValues
Section titled “PreserveDuplicatedValues”Path: HAKOM:TSM:TimeSeries:Defaults:PreserveDuplicatedValues
Has no influence on 4.x time series, exists solely to ensure backward compatibility.
TimeZone
Section titled “TimeZone”Configures the time zone in which time series that have no time zone assigned (null) are returned. The default for this is UTC but can be changed to any time zone string supported by Windows (e.g., W. Europe Standard Time, UTC).
Path: HAKOM:TSM:TimeSeries:Defaults:TimeZone
Effect of TimeZone configuration on data responses
Section titled “ Effect of TimeZone configuration on data responses”Setting
<HAKOM> <TSM> <TimeSeries> <Defaults> <TimeZone>W. Europe Standard Time</TimeZone> </Defaults> </TimeSeries> </TSM></HAKOM>Request
GET /repositories/TSM_ORACLE/timeSeries/test12/data?from=2024-12-19&to=2024-12-22The response below is shortened.
Response
{ "unit": { "identifier": "°C", "storageInformation": { "repositoryName": "TSM_ORACLE" } }, "interval": { "type": 3, "multiplier": 1 }, "cyclic": true, "function": 1, "timeZone": "W. Europe Standard Time", "data": [ { "time": "2024-12-19T00:00:00+01:00", "value": 0, "flag": 19 } ]}StartOfTime
Section titled “StartOfTime”Changes the default start of time value from 1970-01-01T00:00:00 to any ISO 8601 date/time string YYYY-MM-DDTHH:mm:ss±HH:MM.
Path: HAKOM:TSM:TimeSeries:Defaults:StartOfTime