05.01.2013 Views

eWON General Reference Guide - eWON wiki

eWON General Reference Guide - eWON wiki

eWON General Reference Guide - eWON wiki

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

8 Export Block Descriptor<br />

Exports are used to export <strong>eWON</strong> data.<br />

Export block can be used in the following situations:<br />

• Attach the <strong>eWON</strong> data to an email<br />

• Include <strong>eWON</strong> data into an eMail content<br />

• Make an FTP PUT of <strong>eWON</strong> data from the <strong>eWON</strong> to a FTP server<br />

• Make an FTP GET from a FTP client out of the <strong>eWON</strong> FTP server<br />

• Include data in an <strong>eWON</strong> HTML custom page.<br />

• Access data in Basic with OPEN "exp:....."<br />

In all these cases, an Export Block Descriptor will be used to describe the data to export.<br />

8.1 Export block descriptor<br />

<strong>General</strong> <strong>Reference</strong> <strong>Guide</strong> Export Block Descriptors<br />

An Export Block Descriptor is a string of characters describing the <strong>eWON</strong> data to export with a precise syntax.<br />

Typically, the Export Block Descriptor will answer the following questions:<br />

• What <strong>eWON</strong> data to export (Event log, Historical logging, etc.)?<br />

• How to format the data to export (Binary, Text, Html table, Graphic)?<br />

• From what time?<br />

• To what time?<br />

• What Tag is concerned?<br />

• …?<br />

This list is NOT complete, and this information is not required for each type of data to export, but it gives an idea of what is described in an Export<br />

block descriptor.<br />

Example of Export blocks descriptor:<br />

$dtHL $ftT $st_m10 $et_0 $tnMyTag $fnData.csv<br />

The export syntax is composed of a sequence of fields followed by its value. A field is a 3 characters identifier starting with $ and followed by 2<br />

lower cap letters (case sensitive).<br />

• The first letter of the parameter value follows immediately the second letter of the field.<br />

• The parameter is considered up to the first space found or until a $ or a [ is detected.<br />

• The parameter can also be placed between quotes ("). In that case the parameter value is the value between the quotes.<br />

The following fields are defined:<br />

Fields Description<br />

$dt Data type<br />

$ft Export format<br />

$st Start time<br />

$et End time<br />

$tn Tag name<br />

$ut Update last time<br />

$ct Compression type<br />

$fl Group filter<br />

$fn File name<br />

Table 155: Export Block Descriptor fields description<br />

RG-001-0-EN ver 1.14 <strong>eWON</strong>® - 02/05/2012 - ©<strong>eWON</strong> sa Page 184

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!