Supplying WAP Content

On first connection, a welcome screen is presented to the client:

 

The content for this screen is generated by a WAP handler module and is formatted by the template file, WELCOME.WML.  This template file takes four parameters that will be substituted for the %s placeholders shown in the following code. 

 

<!-- Params: "Realm/GUID", VTS name, Copyright dates, Application name -->

<card newcontext="true" ontimer="%smenu.wml" title="Welcome to %s" >

  <timer value="25" />

  <p align='center'><img src='/resources/Tel700.jpg' width='175' height='29' alt='Trihedral' /></p>

  <p align='center'><img src='/resources/vts125.jpg' width='62' height='62'  alt='VTS logo' /></p>

  <p align='center'>©<small> %s<br />Trihedral Engineering Ltd</small></p>

  <p align='center'><b>%s</b></p>

</card>

The template is stored in C:\VTS\VTS\WAP\Welcome.wml.   You may customize the welcome screen for your own company. If you would like a different template for each of your applications, you should create a WAP directory within your application and copy the Welcome.wml file there before editing.

 

Note the use of the OnTimer event in the above code.  The welcome screen will remain visible for 2.5 seconds, following which it will be replaced by a menu:

 

 

If you are running a VTS-based application, the contents of this menu depend on the application’s page source code.  Any page found with a defined WAP handler will be listed here.   How to define WAP content for a page is described in the section Identifying WAP Content Modules.

 VTScada-based applications make use of a WAP menu file, WAPMenu.txt.  This file can be found in C:\VTS\VTSCADA\WAPMenu.txt.  You may add a WAPMenu.txt file to any application to create your own menu. This is advisable to do if you have created custom WAP pages.

 

Only those pages for which WAP content has been defined will be listed, but this can be over-ridden by the configuration variable, WAPShowAllMenuEntries.  Setting this variable to 1 in Config.ini will cause all the application’s pages to be listed in the menu.  Menu entries for which there is no WAP content will show as simple titles, rather than as clickable links.  (Note: this does not apply to applications that have a WAPMenu.txt file, such as all VTScada-based applications)

 

 

By default, WAP content has been defined for the alarms page of any VTS application.  As shown in the figure above, “Alarms” is available as a button in the menu.