User guide

eWON 500-2001-4001-4002 User Guide - User defined Web site
eWON 500®2001®4001®4002® Version 4_3_0 - User Guide - 10/5/05 - ©ACT'L sa - Page 179
10 User defined Web Site
10.1 Introduction
The eWON can host a web site containing user define web pages. The hosting management can be done like for common web site using the
eWON FTP server.
When connecting to the eWON FTP server, the root directory contains a /usr directory. The pages from the custom Web site can be located in
that directory or in subdirectories of /usr.
A file /usr/index.htm
Will be accessed using http://10.0.0.53/usr/index.htm
(If 10.0.0.53 is the eWON IP address)
Static web pages stored in the eWON have a limited interest. That is why the eWON provides 3 ways to make its web content dynamic:
• Build /usr files using BASIC at regular intervals or upon context change.
• Use the SSI (server side include) syntax.
• Use bASP (Basic Active Server Page).
The SSI Stands for Server Side Include; this method is used for creating web sites in which the server updates parts of the HTML page before
sending the page to the client.
• The eWON uses that technique to allow dynamic update of the pages. The following type of data can be dynamically replaced by
the eWON in the user page:
• Tag Value.
• Creation of HTML table for different types of data (historical, event, etc.).
• Creation of Graphs containing Real time values or Historical values.
• Script expression.
• …
The bASP consists in putting BASIC program block in your web pages saved on the server, when the page is delivered to the WEB client. The
BASIC block is executed. The BASIC block can access parameters passed to the page and it can output HTML content directly to the page
delivered to the client.
The eWON also provides 3 types of FORMS to perform the following actions in user-defined pages:
• Modify Tag values
• Acknowledge alarm
• Execute script action
10.2 SSI Syntax
10.2.1 HTML Page extension
The normal processing for an SSI page is the following:
• The user requests a page from the server by entering the page address, example: http://myewon/usr/index.shtm (there are many
other ways to request a page of course).
• The server (eWON) checks that the given page is available in the file system.
• The server checks the page extension (here .shtm), if this extension is NOT .shtm the page is transferred as-is to the client. This
applies to .htm files for example, but also .jpg, .gif, etc.
• If the page’s extension is .shtm, then server will parse the page and replace all the special HTML Tags (see below) by there current
value.
So the SSI extension for the pages in the eWON is .shtm (case sensitive). This extension is recognized by most HTML editors.
10.2.2 Special eWON SSI Tags
There are 4 special HTML Tags defined to provide SSI functionality in the eWON:
<%#TagSSI, YYYYY%>
<%#ParamSSI, XXXXXX%>
<%#VarSSI,YYYYY%>
<%#ExeSSI,XXXXXX%>
•
These 4 special HTML Tags follow a generic syntax for SSI Tags, i.e. they start by <% and end by %>. The consequence of this is that HTML
editor will not check the syntax inside these Tag and they will be completely ignored by the editors.