eWON General Reference Guide - eWON wiki
eWON General Reference Guide - eWON wiki
eWON General Reference Guide - eWON wiki
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