Creating an HTML Form

You can create an HTML form interface for your parameterized tabular report, chart or crosstab.

To create an HTML form:

1.   Open the Report Designer page by clicking the Report Designer link in the navigation panel.

2.   Click the HTML Customizer link. The Micromuse HTML Customizer Quick Start window is displayed, as shown below.

 

   Figure 246: Micromuse HTML Customizer Quick Start Window

3.   To create a new HTML form click the New Form button.

4.   If you have more than one data source available you must choose the datasource to use in the Data Source window, as shown below.

 

   Figure 247: Data Source Window

5.   When you create a new HTML form you must first select a parameterized report, chart or crosstab. The Open Report/Chart/Crosstab window is displayed, as shown below.

 

   Figure 248: Open Report/Chart/Crosstab Window

6.   Select the report type from the File type drop-down list. The types are:

•   Parameterized Report

•   Parameterized Chart

•   Parameterized Cube

•   Parameterized Crosstab

•   Parameterized Easy Report

•   Parameterized Easy Chart

•   Parameterized Easy Crosstab

•   All File Type(s) Above

7.   Navigate through the folders to the parameterized report you wish to use. Select the file and click the Open button.

8.   The HTML Customizer window is displayed. For information on this window, see Working in the HTML Customizer Window on page 400.

Viewing the Details of a Parameterized File

Click the Details button to see the file description of a particular parameterized report definition file. Choose the file for which you want to create an HTML form front end by double-clicking the name of the file.

Finding a Specific Definition File

You can search for a specific file name in the Open Report/Chart window. Choose a particular file type then click the Find button. The Find window is displayed. Type either a file name or part of a file name. Click the Find button to search for a match.

Working in the HTML Customizer Window

The following pages illustrate the process in detail for a parameterized report file. The process of creating an HTML form front end to a chart or crosstab definition file is exactly the same.

Choosing a particular parameterized report file launches the HTML Customizer window, with the name of the file that you chose and the list of the parameters in your file shown with green arrows before them.

 

   Figure 249: HTML Customizer Window

Adding Parameters to the Layout Map

To add the first parameter to the HTML form, click a parameter name in order to highlight it and then click the Add New Row button in the middle to add that parameter to the form.

To add any parameter to the HTML report after the first one, click either the Add to Row or Add New Row button after highlighting the parameter name.

Before the reports are run, the user must select the parameters. The Parameter Selection window can contain checkboxes, drop-down lists, and text. This section refers to the items on this page as widgets.

If you click the Add to Row button, the widget to input the new parameter value appears next to the widget for the first parameter value in one row in the HTML form. If you click Add New Row, then the two widgets for the two parameters appear in two different rows on the HTML form.

The two figures below show HTML forms with the two options.

 

   Figure 250: Parameters on a Single Row of the HTML Form

 

   Figure 251: Parameters on Two Separate Rows of the HTML Form

Previewing the HTML Form with Default Settings

Once you have chosen the layout map for the parameters on the HTML form, click the Preview button to view the default appearance of your HTML form. You can still change the appearance of both the parameter input widgets as well as of the overall form.