Customizing the Look of the Form

There are two ways you can customize the look of your form:

•   Using the Form Properties window.

•   Editing the HTML directly.

Click the Form Properties button to display the Form Properties window, or click a parameter name to open the window. The Form Properties window is used to customize the look of a parameter using different options provided within that window.

Form Properties Window

Clicking the Form Properties button displays a Form Properties window with the options that you can set. These are listed in the following table.

Table 86: Form Properties Options

Form Properties Options

Default Option

Explanation

Form Title

None

Type the title you want to appear at the top of the HTML form.

Parameterized Report/Chart/crosstabcr.ctr

Name of the parameterized report file

For your reference only. This field cannot be changed.

Background Template

None

Choose a template from the scroll-down list.

Show Border

False

Choose or type true to show a border surrounding each widget.

Show Form Date

True

Choose or type false if you do not want the date to appear on the form.

Show Description

True

Choose or type false if you do not want the description of the form written in the Description field to appear on the form.

Form Description

None

Write the description of the form that you would like to appear on the form in this window (enabled only if Show Description has been turned on).

Submit Button Caption

Submit

Change this caption as required.

Clear Button Caption

Clear

Change this caption as required.

Parameter Widget Properties Window

The HTML Customizer allows you to customize the appearance of the widgets to input parameter values through the Parameter Properties window. In order to choose the display properties of parameter widgets in the HTML form, double-click a parameter in the left window of the HTML Customizer window. The options in the Parameter Properties window are described in the following table.

Table 87: Parameter Properties Options

Form Properties Options

Default Option

Explanation

Parameter Name

Name given to the parameter in the definition file

Name that the designer of the report definition file gave the parameter on the Report tab in the Report Designer.

Description

Description given in the definition file

Description of the parameter that the designer of the report definition file gave on the Report tab in the Report Designer.

Widget Type

AS_DROPDOWN

The following choices are available: AS_DROPDOWN, AS_TEXT, AS_CHECKBOX. If the parameter allows multiple values, you must choose a widget which allows multiple values to be selected (drop-down lists cannot be used for multiple values).

Size

1

Number of rows shown in the drop-down list.

Width/Elements Per Row

1

Applicable only in cases where parameters have multiple values. Determines how many widget elements (parameter values) appear per row. Type or choose any number between 1 and 5.

Height

None

Height adjustment of the widget.

Checked

None

Option value is checked initially.

Caption Alignment

LEFT

Determine where the caption appears with respect to the parameter widget it describes. The following are the options: LEFT, RIGHT, TOP, BOTTOM.

Data Type

None

For reference only. The data type of the column as defined in the database.

Allow Multi-select

true, false

For reference only. The value is decided on by the designer of the report definition file when creating the parameterized report definition within the Report Designer.

Allow Manual Enter

true, false

For reference only. The value is specified by the designer of the parameterized report definition.

Cannot Get from DB

true, false

For reference only. The list of potential values cannot be retrieved from the database.

Need Quote

true, false

For reference only. Whether true or false depends on the Data Type of the column. If the column is of the CHAR or VARCHAR type, then the value is true. Otherwise, it is false.

Table Column

None

For reference only. This is the database table column name.

Editing the HTML Form File

You can directly edit the HTML file using the Edit Form window. Select the menu option ActionÆEdit Form. A text editor is displayed containing the HTML file source.