eWON General Reference Guide

General Reference Guide Export Block Descriptors

8.3 Data Types description and syntax

A Data type defines what is exported from the eWON. The data type is defined by the $dt field followed by 2 uppercase letters. The $dt field is mandatory for each "Export Block Descriptor" and usually the $ft (Format) field will also be present to define the output format of your data

(although a default format is defined for each data type).

For each Data type, a set of other fields must be provided (some are mandatory and others are optional).

Note:

If you specify an unused field (neither mandatory nor optional), it will then be ignored.

This section will describe the syntax for each data type with the specific features for each of them.

8.3.1

$dtHL [Historical Logging]

8.3.1.1

Export content

The Historical logging outputs the data from the File system for ONE or ALL the fields. The output format can be TEXT, HTML Table or BINARY.

The GRAPH format is also available IF only ONE Tag is specified.

A time range can also be specified for this export.

8.3.1.2

Detailed Example

$dtHL $ftT $st_h4 $et_m0 $tnA1

$dtHL

$ftT

$st_h4

$et_0

$tnA1

data type historical logging output format requested is CSV start time is current time – 4 hours end time is current time – 0 minutes Ù NOW

Tagname “A1” history to output

Table 161: $dtHL detailed example

8.3.1.3

Used Fields

Fields Value if not specified

Mandatory

$dt

$fl

$ut

$fn

$ct

$ft

$st

$et

$tn

Optional

Binary

01/01/1970

31/12/2030

All tags

All tags groups

No time update

Export block descriptor

Compression type

Table 162: $dt - used fields

8.3.1.4

Special parameters and fields

$st $et

If Last time is specified: ($stL or $etL): there is a last time logged for each Tag plus a last time logged for all Tags. If you specify a given Tag, its own last time will be used. If a specific Tag is not requested, the export is performed for Tags concerned by historical logging and another last time memory is used.

If the output format is graph: $et_0 should be used instead of default value, otherwise the graph would span up to 31/12/2030. For binary or text output, the default value can be kept.

RG-001-1-EN rev. 2.1

eWON® - 29/11/2013 - ©eWON sa Page 199

General Reference Guide Export Block Descriptors

$ft

Binary Text

Acceptable values

HTML Graph

Table 163: [$dtHL] $ft acceptable values

The Graph format is only allowed if a Tag has been specified.

The Text format will output a comma-separated file. The separator is ’;’ to avoid any confusion with decimal point. If all the Tags are output they will be output in a chronological order in the file.

$ut

If only one Tag is specified, the time of the last point for that Tag will be memorized. All the Tags can be output individually and last time is saved for each point. Another memory is available if $ut is requested for ALL the Tags.

$tn

If this Tag is not specified, ALL the Tags will be selected for export. Otherwise, the Tag with the given name will be selected.

$fl

The group selection is only available with binary, text and HTML formats (not allowed for Graphic format $ftG).

8.3.1.5

examples

$dtHL

$dtHL $ftT

$dtHL $ftT $tnTemp

$dtHL $ftB $flAB

$dtHL $ftT $tnTemp $st_h1 $et_s0

$dtHL $ftT $flCD $st_h1 $et_s0

export all the Tags records in binary format export all the Tags records in ($ftT) Text format (like CSV file) export all the values of the ($tnTemp) Tag named “Temp” in ($ftT) Text format export all the values of ($flAB) tags belonging to group A and B in ($ftB)

Binary format export the values ($st_h1) from 1 hour to ($et_s0) now of ($tnTemp) Tag named “Temp” in ($ftT) Text format export the values ($st_h1) from 1 hour to ($et_s0) now of ($flCB) Tags belonging to group C and D in ($ftT) Text format

Table 164: [$dtHL] examples

RG-001-1-EN rev. 2.1

eWON® - 29/11/2013 - ©eWON sa Page 200