User guide

ExtremeWare EPICenter Software Installation and User Guide 16-23

Creating New Reports

<extr>ShowDeviceSummaryList</extr>

</body>

</html>

The device_summary.html fileis justlike a standard HTML file with one exception:it has

a new pair of tags,

<extr> ... </extr> which are specific to theEPICenter report server.

The EPICenter report server treats everything defined between these tags as Tcl code. The

report server executes this code dynamically when it generates the report (upon a user

request through the browser).

You canuse anystandardTcl constructsbetweenthesetags, andyoucan also use methods

defined in the “extr” package (

extr.tcl). extr.tcl defines a set of methods to obtain

information from the EPICenter software database. Appendix C “EPICenter Database

Views,” definesa numberofdatabaseviewsthat containinformationthatmaybeusefulin

creating reports.

In addition, you can define new methods in any Tcl file in the

<epicenter_install_dir>/user/reports/tcl directory, and use those methods inside

the HTML file within the

<extr> and </extr> tags.

A number of reports have been defined for use as examples. Look at the various HTML

files to understand how

<extr> tags are used within HTML files.

Look at the methods defined in the file

user/reports/tcl/examples.tcl for details on

using these methods to generate the data that will become a part of the generated report.

Some utility methods have been provided in

commands.tcl to help parse the result that

comes back from the EPICenter software API.

In general, the Tcl methods defined here will generate well-formatted HTML. Everything

between the

<extr> and </extr> tags is replaced by HTML code generated by the

embedded Tcl code. Using this method, you can generate lots of new reports quickly, and

without disrupting the EPICenter software server.