Inserting Elements

This section describes information on adding major elements into freeform report templates, including inserting Text, Image, Chart, Table, and Form. Other elements such as spacing elements (newline, page break, space, and so on), headings and TOC are discussed in section Miscellaneous Features on page 474.

 

   Note:


    Although Freeform Report Designer supports both HTML and PDF as output types, some elements and features are not supported in both formats. See Table 88 for detailed information.


Inserting Text

Insert text into the template using one of the following options:

 

   Figure 268: Insert Text Button

The insert text option places a text entry box into the template and places the text entry cursor within the box. An example text box is shown below.

 

   Figure 269: Example Text Box

The font type, size and format for the text can be changed using the options on the text tool bar, as shown below, or using the Text Properties window.

 

   Figure 270: Text Formatting Tools

The buttons are identified in the following table.

Table 91: Text Format Button Descriptions

No.

Button

Description

1

Font

A drop-down list of available fonts. Note that the supported font styles are platform dependent. For example, "Microsoft Sans Serif" is a windows font, not unix font.

2

Size

A drop-down list of font sizes from 6pt to 72pt.

3

Bold

Applies the bold character style.

4

Italic

Applies the italic character style.

5

Underline

Applies the underline character style.

6

Left

Aligns the text to the left.

7

Center

Aligns the text to the center.

8

Right

Aligns the text to the right.

9

Fill

Sets the Alignment to justified.

10

Indent

Increases and decreases the text indent.

Text Properties Window

Open the Text Properties window by double-clicking the text box or right-clicking in the text box and selecting Properties from the popup menu. The Text Properties window has three tabs. The Attributes tab is shown below.

 

   Figure 271: Text Properties Window-Attribute Tab

You can change the name of the text element in the ID field.

Attribute Tab

The Attributes tab in the Text Properties window provides the ability to change the text alignment (horizontal and vertical), the font (including color, size, type, underline, strike through, and effects), justification, indentation, spacing, and so on.

The options are described in the following table.

Table 92: Attribute Tab Options

Option

Description

Alignment

Text alignment. Drop-down options are: Fill, Left, Center, and Right.

Vertical alignment

Vertical position. Drop-down options are: Baseline, Top, Center, and Bottom.

Font

This field displays the current font. Click the ... button to open the Select Font window, as described in Selecting Fonts within Property Windows on page 495.

Indent

Specifies the left hand indent in inches.

Justify

When selected, the text is fully justified. This overrides the Alignment setting.

Foreground

Sets the color of the text, as described in Selecting Colors within Property Windows on page 496.

Background

Sets the color of the background, as described in Selecting Colors within Property Windows on page 496.

Spacing

Sets the spacing between the current line and the next line. Enter values in point sizes.

Text Advance

Sets a space between the text box and the next element. Enter values in point sizes.

Widow/Orphan control

Specifies the minimum number of lines in a paragraph that can appear on either side of a page break. For information about page break, see Page Break Element on page 492.

Fixed Length Underline (PDF only)

Selects the checkbox and enters a value in the field to let the text shown with a underline of the length of the entered value. This overrides the underline selected in the Select Font dialog. This feature applies to PDF outputs only. For information on changing output format, see Previewing Templates on page 413.

Use Transparent Background

When checked, makes the background of the text box transparent, in addition, makes the Background drop-down list grayed out; when unselected, makes the Background drop-down list enabled for you to choose a background color for the text box.

Contents Tab

The Contents tab is shown in the following example screen:

 

   Figure 272: Text Properties Window-Contents Tab

The text box on the top displays the content of the text box, allowing you to edit the content as desired. The Available Parameter Items list displays the parameters currently used in the template.

To display a parameter name in the text box, select the Allow Parameter Items checkbox on the lower right corner of the window then double click a parameter in the Available Parameter Items list. The parameter is appended to the end of the text. When the template is run, the parameter name will be replaced with the actual parameter value. This feature allows a Text element to be used to display parameter values selected for a report or chart.

Tab Tab

The Tab tab in the Text Properties window provides the ability to modify the tab stops and tab fill. The Tab tab is shown below.

 

   Figure 273: Text Properties Window-Tab Tab

The default tabs are spaced every 0.5 inches. Either select a tab available in the list or enter a new value for the tab.

Select a tab fill style, if required, from the Fill drop-down list. Although all of the styles can be selected, only the single line fill style can be displayed in a freeform report using the HTML output. All styles are available for the PDF output.

Setting Hyperlinks (HTML Output Only)

When you right-click a Text or a Chart element, a popup menu appears with options including Copy, Cut, Paste, Properties, and Hyperlink. The Hyperlink option allows you to add a hyperlink to the Text or Chart element.

Note that hyperlinks work only when HTML is selected as the output type. For information on changing the output type, see Previewing Templates on page 413.

When Hyperlink is selected, the Hyperlink Properties window opens, as shown below:

 

   Figure 274: Hyperlink Properties Window-Web Link

The radio buttons of Web Link and Element Link allow you to create a hyperlink linking to either a common website or a Table or Chart element added in the current Freeform Report Designer template.

The Web Link option is selected by default, which is shown in the above figure. Enter desired website into the Link or Target fields. Difference of Link and Target is that when the template is run as HTML, clicking the hyperlink opens the linked website in the same preview window or in a new browser window.

When the Element Link option is selected, the properties window is refreshed to show additional information, as shown in the following screen:

 

   Figure 275: Hyperlink Properties Window-Element Link

Either enter an element name in the Target field, or select the Link to Data checkbox and select the desired template element to link to.

Inserting Images

The image icon is an element that is used to insert an image (for example, a picture, or company logo) into a template.

To insert an image into the template use one of the following options:

 

   Figure 276: Insert Image Button

The Image Properties window opens with the Image tab selected, as shown below.

 

   Figure 277: Image Properties Window Image Tab

Image Properties Window

The ID editing filed above the tabs in the Image Properties window allows you to change the name of the element.

Complete the configuration in each tab, as described in the following sections, and click OK to insert the image.

Image Tab

The Image tab allows you to specify where the image to be added to the template comes from. The tab is shown in Figure 277. Select either the URL or the Image radio button from the Source area.

For URLs, enter the location of the image in the blank field.

To select an image,

1.   Click the Browse button. The Select Image window is displayed.

2.   Select the type of file from the drop-down list. The options are: Graphics Interchange Format (GIF), JPEG Files, Portable Network Graphics (PNG), and Snapshot Images.

Snapshot Images are created by saving a snapshot of a Lightweight chart in the Report Designer.

3.   Browse the directories and select the image you require.

4.   Click the Open button.

Layout Tab

The Layout tab controls the image size, margins, wrapping, pagination, and anchor. The Image Properties window Layout tab is shown below.

 

   Figure 278: Image Properties Window Layout Tab

The options in the Layout tab are described in the following table.

Table 93: Layout Tab Option Descriptions

Options

Description

Size

Sets the width and height of the image (or chart). Enter values in pixels.

Margin

Sets the empty space around the image (or chart). Enter values in points.

Wrapping (PDF Only)

Sets the wrapping settings, as described in Text Wrapping on page 489.

Pagination (PDF Only)

Defines whether an image (or chart) can be broken across the page break. The options are:

Breakable - Part of the image (or chart) appears on one page and part on the next page.

Non Break - The image (or chart) is cropped at the bottom of the page.

Anchor

Changes the distance of the image (or chart) from the anchor, as described in Anchors on page 488.

Attributes Tab

The Attributes tab contains the following options:

See Table 92 Attribute Tab Options on page 437 for descriptions of these options.

Dynamic Images in Header/Footer

The Freeform Report Designer supports the use of dynamic images in the Header and Footer sections. Dynamic images are not supported in the Body section.

Dynamic images can be added in a header or footer by using the {u} (Header or Footer tag) tag in the Image editing field on the Image tab. The server dynamically fills in the name of the user running the report wherever the {u} tag is found in the line. In this case, it is expected that an image would exist in the Inbox with that name.

If the Image radio button is selected on the Image tab and you have {u}.gif as the name of the image then it must exist in your Inbox.

Alternatively, select the URL radio button and place a full URL with the {u} tag in the edit box. This allows you to separate images by username in a central Web directory.

For example, http://www.micromuse.com/images/companyname-user{u}.gif

The {u} tag is replaced with the username during runtime.

Inserting Charts

The Freeform Report Designer supports adding live chart definition files created from the Report Designer to templates. When a freeform report template file is run or scheduled, the charts included in the template are run at that time and the output is processed and placed into the presentation output, in either HTML or PDF format.

Not all types of chart styles within the Report Designer are supported by the Freeform Report Designer. Supported chart styles are listed below:

 

   Note:


   Report Designer combo charts are not supported by the Freeform Report Designer as combo charts do not support GIF output in definition files. If you do add a combo chart into a Freeform template, the combo chart will be displayed as a common 2D bar chart.


 

To insert an chart into the template, use one of the following options:

 

   Figure 279: Insert Chart Button

The Chart Properties window opens with the Chart tab selected, as shown below.

 

   Figure 280: Chart Properties Window Chart Tab

Once you complete the data source selection and other settings and click OK, the Properties window will be closed and a placeholder chart will appear on the template.

Chart Properties Window

Above the tabs in the Chart Properties window, you can change the name of the element in the ID field.

Complete the configuration in each tab, as described in the following sections, and click OK to insert the chart.

Chart Tab

The Chart tab is shown in Figure 280.

To specify a chart:

1.   Click the Select button in the Data Source area. The Select Data Source window is displayed.

2.   Select the type of chart from the drop-down list. The options are: LChart Files and Chart Files.

3.   Browse the directories and select the chart you require.

4.   Click the Open button.

The Parameter Group section is only activated when a parameterized chart is selected as the data source for the current chart element. This section controls how the Parameter Value Selector dialog displays parameters contained in the template. The dialog is displayed when a template with a parameterized chart(s) is run (previewed), which allows you to select values to run for parameters.

This grouping function is useful when multiple parameterized reports/charts are added into a single template, particularly when the parameters utilized in those reports and charts overlap. Properly grouping the parameters makes it much easier for you to select values for the parameters.

There are three grouping options, select one of the three radio buttons as listed below:

Auto Group is selected by default. This grouping type groups parameters by their names, with duplicate parameters displayed only once. For example, given a template containing two charts that both utilize the parameter named Deptno. When the two charts are set to Auto Group, the parameter Deptno will be listed in the Parameter Value Selector once, and the values selected for Deptno will be applied to both charts.

Group allows you to enter a custom group name and the current parameter will be displayed within that group. Similarly, duplicate parameters are displayed only once in that custom group.

No Group means that the parameter(s) contained in the current chart is to be simply listed on the Parameter Value Selector, preceded by the chart's ID name. This allows the chart to utilize its own parameters, which are not shared among other parameterized reports or charts.

The Style section allows you to specify a lightweight chart style file to apply to the chart selected in the Data Source section. Lightweight chart style files are created using the Lightweight Chart Property Designer, which is discussed in Lightweight Chart Property Designer on page 300.

To select an existing style file,

1.   Click the Select button in the Style area. The Select Chart Style window is displayed.

2.   Browse the directories and select the chart style you require.

3.   Click the Open button.

It is also possible to override some of the values in the selected chart style. Once a chart style has been selected, the Customize button is enabled. Click the Customize button to open the Customize Chart Style window, as shown below.

 

   Figure 281: Customize Chart Style Window

Specify new chart style settings as required. The ... button opens the Select Font window. For information on this window, see Selecting Fonts within Property Windows on page 495. information on this window, see Selecting Fonts within Property Windows on page 495.

   Note:


   The width and height values specified in the Customize window apply to HTML outputs only. For PDF outputs, these values are ignored and the size set in the Layout tab, as described in the next section, will be utilized. For HTML outputs, the chart image is generated with the width and height specified in the Customize window; while the entire Chart element is displayed with the size set in the Layout tab, and thus the image is scaled.


 

After making your setting, click OK to close this window.

To apply the customization, select the Overwrite properties in style file checkbox.

Layout Tab

The Layout tab controls the chart size, margins, text flow/wrapping, pagination, and anchor. This tab is identical to the Image Properties window Layout tab. For a description of the options on this tab, see Layout Tab on page 443.

Attributes Tab

The Attributes tab contains the following options:

For descriptions of these options, see Table 92 Attribute Tab Options on page 437.

Inserting Tables (Text and Reports)

The Table element can be used to insert an ordinary table or add a report created via the Report Designer to the template. Such reports can be live report definition files and report outputs. When a freeform report template file is run or scheduled, the reports included in the template are run at that time and the output is processed and placed into the presentation output, either HTML or PDF.

The Freeform Report Designer supports a subset of report styles that are generated within the Report Designer, as listed below:

 

   Figure 282: Insert Table Button

The table size popup window is displayed, as shown below.

 

   Figure 283: Table Size Popup Window

Use the cursor to select the number of rows and columns to create for the table. The size expands from the top left box. A placeholder table appears on the template.

 

   Note:


    When a table is used to display report data, it does not matter what size the Table element is. The actual size of the table is specified by the report at runtime.


The following figure shows an example of a report displayed in a table.

 

   Figure 284: Example Report within a Table

The same report, displayed within a form, is shown in Figure 292 on page 462.

Adding Text to an Ordinary Table

When a Table element is added as an ordinary table, adding content to the table is quite easy. To do this, switch the Freeform Report Designer mode to Text mode by clicking the text mode button, as shown in Figure 304, click any table cell and type in desired text directly. When a table cell is selected, the clicked cell changes to an editing field.

Another method of entering text to a table is via the Headers and Data tab in the Table Properties window, as discussed in Headers and Data Tab on page 453.

Table Properties Window

To set the properties of the table, right-click in the table and select Properties from the popup list. The Table Properties window is displayed with the Table tab selected, as shown below.

 

   Figure 285: Table Properties Window Table Tab

Above the tabs in the Table Properties window, you can change the name of the element in the ID field.

Complete the configuration in each tab, as described in the following sections, and click OK to apply the configuration changes to the table.

Table Tab

The Table tab is shown in Figure 285.

The Layout section is used to control the way the report content (data) and the table look and also how they relate to the page. The options are described in the following table.

Table 94: Layout Section Options

Options

Description

Fit Page

This radio button sets the table to the width of the page or page area. It also sets each column to a width proportional to the widest piece of data in the column.

Fit Content and Page

This radio button changes the width of each column to the same width as the widest piece of data in the column. However the last column is expended to the right edge of the page or page area.

Fit Content (Wrap One Table Region Per Page)

This radio button changes the width of each column to the same width as the widest piece of data in the column. If the total width of the table exceeds the page width or area width, columns are cut from the right side and pasted on the next page.

Fit Content

This radio button changes the width of each column to the same width as the widest piece of data in the column. If the total width of the table exceeds the page width or area width, columns are cut from the right side and pasted below the table.

Equal Width

This radio button sets the table to the width of the page or page area. It also sets each column to the same width within the table.

Embed Column Widths

When selected, this checkbox sets the width of each column to the same width embedded in the data source.

Trailing Advance:

Sets a space between the table and the next element. Enter values in point sizes.

Header Row Visible

When checked, makes the header row visible.

Header Column Visible

When checked, makes the header column visible.

Hide Break Column

When checked, does not show the break column(s) defined in the report.

Duplicate Break Column

When checked, shows the values of break columns in each row.

The Style section is described in Controlling Spacing with Spacing Elements on page 491.

The Cell Padding section is used to determine how much blank space, or padding, is between the data and the lines of the table cells. The values are entered in points.

Headers and Data Tab

The Headers and Data tab, as shown below, can be used to format and add text to a Table element when used as an ordinary table (that is, when the Table element is not going to be associated with a Netcool Reporter report in the Data Source tab).

 

   Figure 286: Table Properties Window Headers and Data Tab

The Table section is used to set the number of columns and rows for a table, and the number of header rows and header columns. Click the Set Dimension button to validate the changes, in the meantime, the table on the bottom changes accordingly.

To add contents to the table, click any cell of the table below the Set Dimension button and an editing box appears around the cell; then type the text directly.

Data Source Tab

The Data Source tab, shown below, is used to select a report to act as a data source.

 

   Figure 287: Table Properties Window Data Source Tab

To select a data source:

1.   Click the Select button in the data source section. The Select Data Source window is displayed.

2.   Select the type of report from the drop-down list. The options are: Report, Crosstab, and Data Source File.

3.   Browse the directories and select the data source you require.

4.   Click the Open button to return to the Table Properties window.

The Parameter Group section is only activated when a parameterized report is selected as the data source for the current table element. This section controls how the Parameter Value Selector dialog displays parameters contained in the template. That dialog is displayed when a template with a parameterized report(s) is run (previewed), which allows you to select values to run for parameters.

This grouping function is useful when multiple parameterized reports/charts are added into a single template, particularly when the parameters utilized in those reports and charts overlap. Properly grouping the parameters makes it much easier for you to select values for the parameters.

There are three grouping options, select one of the three radio buttons below:

Auto Group is selected by default. This grouping type groups parameters by their names, with duplicate parameters displayed only once. For example, given a template containing two reports that both utilize the parameter named Deptno. When the two reports are set to Auto Group, the parameter Deptno will be listed in the Parameter Value Selector once, and the values selected for Deptno will be applied to both reports.

Group allows you to enter a custom group name and the current parameter will be displayed within that group. Similarly, duplicate parameters are displayed only once in that custom group.

No Group means that the parameter(s) contained in the current report is to be simply listed on the Parameter Value Selector, preceded by the report's ID name. This allows the report to utilize its own parameters, which are not shared among other reports.

Hyperlink Tab

The Hyperlink tab, as shown below, is used to select a custom defined drill across definition file to apply to the report.

 

   Figure 288: Table Properties Window Hyperlink Tab

After a drill across file is selected, appropriate report data will be displayed as clickable links, which can be clicked to open the report that is linked to. This feature is useful as it allows drilling from one report to another one that usually contains richer reference information. For details of creating drill across definition files, refer to Defining Drill Across Definition Files on page 457.

Attributes Tab

The Attributes tab contains the following options:

See Table 92 Attribute Tab Options on page 437 for descriptions of these options.

Defining Drill Across Definition Files

A drill across definition file is a XML file, as described below:

<?xml version="1.0" encoding="UTF-8" ?>

 

<!ELEMENT DrillAcross (From*)>

<!ATTLIST DrillAcross

id CDATA #REQUIRED

>

<!ELEMENT From (To)>

<!ATTLIST From

type (1|2) #REQUIRED

location CDATA #REQUIRED

>

<!ELEMENT To (Parameter *)>

<!ATTLIST To

type (1|2|4) #REQUIRED

location CDATA #REQUIRED

>

<!ELEMENT Parameter (AParam*)>

<!ATTLIST Parameter

name CDATA #REQUIRED

>

<!ELEMENT AParam EMPTY>

<!ATTLIST AParam

type (0|1|2|3) #REQUIRED

value CDATA #REQUIRED

>

Syntax of file identification:

There are several ways of identifying a unique Netcool Reporter file: by file ID, by file owner and file name (only valid for SQL reports and snapshots), by absolute folder/channel path with file name.

To support the above identification methods and provide the flexibility and extensibility, drill across uses the following syntax to identify a file:

<protocol>:<location_value>

The following protocols are supported up to now:

That is, to identify a file by file ID. The location_value is file ID.

Example:   ID:1234

That is, to identify a file by file owner and file name. The syntax of location_value is:

<file_name>[@<file_owner>].

If file owner is not provided, current login user will be used as file owner by default. The Netcool Reporter system variable %CURR_USER% can be used as value of file owner representing current login user as file owner.

Example:   NAME:department.rpt@netcool

Note that this protocol is only valid to identify SQL report or snapshot since each user can have only one report or snapshot with the same name. For general Netcool Reporter documents, there may be multiple files with the same name in different folders or channels.

The values of id attribute in DrillAcross element and location attribute in To element are file identification.

Drilling From

From element identifies where the drilling links are generated, that is, from where drilling comes.

The following locations are supported:

type Attribute

Location

location Attribute

location Example

1

report snapshot table column

 

column index with index of first column starting from 0   

0

2

report snapshot table column

column header   

 Department No.

 

Drilling To

To element identifies where the drilling links point to, that is, to where drilling goes.

The following locations are supported:

type Attribute

Location

location Attribute

location Example

1

URL

 

URL location   

http://www.micromuse.com

 

2

Netcool Reporter report. The report will be run and snapshot displayed   

identification of report file   

NAME:department.rpt@micromuse

 

4

Netcool Reporter document. The document will be opened and content displayed   

identification of document file   

ID:1234

 

 

 

 

URL type location supports syntax %$column_index%; %$ is starting tag; % is ending tag; column_index is index of column whose value will replace %$column_index% at run time to dynamically generate URL.

Parameter Values

To support multiple parameter values, like combination of constant value and column value, Parameter and AParam sub-elements are used.

For each parameter, there may be values coming from different places. type attribute of AParam element is used to identify the parameter value types.

type Attribute

Parameter Value   

value Attribute

value Example

0

constants   

 

Constant value   

SALES

1

Netcool Reporter system variables   

Netcool Reporter system variable

%CURR_USER%

 

 

2

 

 

value of drilling report snapshot column data

column index with index of first column starting from 0

0

 

 

3

value of drilling report snapshot column data

column header

Department No.

 

 

An Example is provided below:

<Parameter name="DEPTNO">

<AParam type="3" value="Department No." />

<AParam type="2" value="10" />

</Parameter>

Netcool Reporter System Variables

The following system variables can be used as parameter values:

%CURR_USER%

Example

Here below provides an example of the drill across definition file:

<?xml version="1.0" encoding="UTF-8"?>

<DrillAcross id="NAME:department.rpt">

<From type="2" location="Name">

<To type="2" location="NAME:emp_in_dept.par" target="drilledtarget">

<Parameter name="DEPTNO">

<AParam type="3" value="Department No." />

</Parameter>

</To>

</From>

</DrillAcross>

Inserting Forms (Text and Reports)

A form can be used to display text or display the output of a selected report.

You can add a live report definition file to the Freeform Report Designer form. This means that when a freeform report template file is run or scheduled the reports included in the template are run at that time and the output is processed and placed into the presentation output, either HTML or PDF.

There is a subset of report styles within the Report Designer, that the Freeform Report Designer supports. The report styles include:

To insert a form into the template use one of the following options:

 

   Figure 289: Insert Table Button

The form size popup window is displayed, as shown below.

 

   Figure 290: Form Size Popup Window

Use the cursor to select the number of rows and columns to create for the form. The size expands from the top left box. Click the mouse to select the size of the form currently displayed. A placeholder form appears on the template, as shown below.

 

   Figure 291: Form Placeholder

 

   Note:


    When a form is used to display report data, the number of rows is specified by the report at runtime. If the number of columns specified in the form is less than the number of columns in the report, the data from the additional columns is moved to the next row. If the number of columns is greater than the number of columns in the report, the cells in the extra column are left blank.


The following figure shows an example of a report displayed in a form.

 

   Figure 292: Example Report within a Form

The same report, displayed within a table, is shown in Figure 284 on page 450.

Adding Text to an Ordinary Form

When a Form element is added as an ordinary form, adding content to the form can be done by switching the Freeform Report Designer mode to Text mode and clicking any label or data field and entering desired text directly. When a field label or data is selected, the clicked cell changes to an editing field.

Another method of entering text to a form is via the Labels and Data tab in the Form Properties window, as discussed in Labels and Data Tab on page 465.

Form Properties Window

To set the properties of the form, right-click in the form and select Properties from the popup list. The Form Properties window is displayed with the Form tab selected, as shown below.

 

   Figure 293: Form Properties Window Form Tab

Above the tabs in the Form Properties window, you can change the name of the element in the ID field.

Complete the configuration in each tab, as described in the following sections, and click OK to apply the configuration changes to the table.

Form Tab

The Form tab is shown in Figure 293.

The Layout section is used to control the way the report content (data) and the table look and also how they relate to the page. The options are described in the following table.

Table 95: Layout Section Options

Options

Description

Fit Page

This radio button sets the form to the width of the page. It also sets each column to a width proportional to the widest piece of date in the column.

Fit Content

This radio button changes the width of each column to the same width as the widest piece of date in the column. If the total width of the table exceeds the page width, columns are cut from the right side and pasted below the table.

Equal Width

This radio button sets the table to the width of the page. It also sets each column to the same width within the table.

Embed Field Widths

This radio button changes the width of each column to the same width as the widest piece of date in the column. It also embeds the width of the field in the HTML source code.

Fields per row

Changes the number of columns in the form.

The Label and Field sections set the style of the text in the form.

Change the font format by clicking the ... button. The font format is described in Selecting Fonts within Property Windows on page 495.

You can change the foreground and background colors, as described in Selecting Colors within Property Windows on page 496.

You can select a style of underline from the drop-down list. Only a single underline is supported on a template set to HTML output. All styles are available from the PDF output.

Labels and Data Tab

The Labels and Data tab, as shown below, can be used to format and add text to a Form element when used as an ordinary form (that is, the Form element is not going to be associated with a Netcool Reporter report in the Data Source tab).

 

   Figure 294: Form Properties Window Labels and Data Tab

To change the number of fields in the form, enter a number and click the Set Dimension button.

The field and data lists display the text already entered in the label and data fields. You can add or edit the text. Any text entered on the form is overridden if a report is associated with the form.

Data Source Tab

The Data Source tab, shown below, is used to select a report to act as a datasource.

 

   Figure 295: Form Properties Window Data Source Tab

To select a data course:

1.   Click the Select button in the data source field. The Select Data Source window is displayed.

2.   Select the type of report from the drop-down list. The options are: Report and Data Source File.

3.   Browse the directories and select the data source you require.

4.   Click the Open button to return to the Table Properties window.

Associating a report with a form provides a way to format the data within the template. A form can be used to format unformatted data such as .xml or .csv data, generated by the Report Designer or Easy Reporter.

The data from the report is placed within the fields of the form on a row by row basis. This means that each piece of data from the row returned by the report goes into a single field in the form. Once the last item in the current row is placed, the next row begins and a new form is placed on the template.

The Parameter Group section is only activated when a parameterized report is selected as the data source for the current form element. This section controls how the Parameter Value Selector dialog displays parameters contained in the template. That dialog is displayed when a template with a parameterized report(s) is run (previewed), which allows you to select values to run for parameters.

This grouping function is useful when multiple parameterized reports are added into a single template, particularly when the parameters utilized in those reports overlap. Properly grouping the parameters makes it much clearer for the Parameter Value Selector dialog to display the parameters.

There are three grouping options, select one of the three radio buttons below:

Auto Group is selected by default. This grouping type groups parameters by their names, with duplicate parameters displayed only once. For example, given a template containing two reports that both utilize the parameter named Deptno. When the two reports are set to Auto Group, the parameter Deptno will be listed in the Parameter Value Selector once, and the values selected for Deptno will be applied to both reports.

Group allows you to enter a custom group name and the current parameter will be displayed within that group. Similarly, duplicate parameters are displayed only once in that custom group.

No Group means that the parameter(s) contained in the current report is to be simply listed on the Parameter Value Selector, preceded by the reports ID name. This allows the report to utilize its own parameters, which are not shared among other reports.

Hyperlink Tab

The Hyperlink tab is used to select a custom defined drill across definition file to apply to the report. For detailed information, refer to Hyperlink Tab on page 456.

Attributes Tab

The Attributes tab contains the following options:

See Table 92 Attribute Tab Options on page 437 for descriptions of these options.