...
The built-in
...
web
...
server
...
has
...
an
...
integral
...
reporting
...
extension
...
that allows you to produce a full report in HTML format and deliver it direct to a web browser. This reporting script is accessed using the standard CGI (Common Gateway Interface) protocol.
How it works
The parameters of the required report are being passed to the web server, including the ID number, the period (date and time), and any other required parameters, the report is being generated and then sent back to the web browser window.
The reporting script, is invoked by sending CGI variables to the
| Keywordmacro | ||
|---|---|---|
|
...
|
...
com is
...
the
...
host
...
name
...
of
...
the
...
machine
...
running
...
the
...
TIM
...
web
...
server.
...
The report parameters can be passed by the standard GET and POST methods. Using the GET method, the parameters can simply be passed to the RHDL.EXE object on the URL, as a hypertext link, or typed directly into the web browser's address bar. For example,
| Keywordmacro | ||
|---|---|---|
|
...
| theme | Eclipse |
|---|
...
|
Using the POST method requires an HTML form to be produced. An example of the same Call Geography report is described below:
| Code Block |
|---|
<html> <body> <form method="POST" action="http://tim.yourcompany.com/rhdl.exe"> <p>ID <input type="text" name="reportid" size="20" value="5"><br> Period <input type="text" name="period" size="20" value="lastmonth"></p> <p><input type="submit" value="Submit"></p> </form> </body> </html> |
| HTML |
In this
...
example,
...
the
...
user
...
is
...
allowed
...
to
...
enter
...
manually the
...
ID and
...
period
...
There are other scripts available for administering your extensions configuration remotely via a web browser, and in the standard installation you will be able to select this from the main menu. However, given the scope of this manual, this script is not described here.
Bar Graph
We have also provided a useful gadget for displaying a small bar graph image when passed a parameter between 0 and 100, which reflects a percentage. Try it using the following example:
http://tim.yourcompany.com/bar.jpg?percent=75
Restart Server
A script is also included which invokes a restart of the TIM server. Be aware that it is the whole application that is restarted - not just the web server. The script needs one parameter named sure to equal yes. Suggested use is as follows:
of the report, for maximum flexibility.
An array of SSI variables can be used in your HTML code to automatically insert a drop-down list of valid report periods. The variables are described in the Server-side includes section.
Further, there may be times when a drop-down list is needed in your HTML page that holds a list of all the extension groups that have been set up. Clearly, a static HTML page would not suffice here because the list of extension groups may change. In this case, you must use the server-side variable named #SSI_EXTNGROUP to do this for you.
The difference between actioning a report using the POST method instead of the GET method is that the parameters you send to the RHDL.EXE object are hidden from your web browser's address bar. This can sometimes be desirable from a security point of view.