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.
Insert text into the template using one of the following options:
Select the menu option InsertÆText.
Click the Insert Text button, as shown below.
|
|
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. |
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.
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.
|
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. |
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.
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.
To add a tab enter a new value and click the Set button.
To clear a tab, select the tab and click the Clear button.
To clear all tabs, click the Clear All button.
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.
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.
When a element name is entered in the Target field, clicking the hyperlink in the preview window will open a new preview window with the content automatically jumped to the element where the hyperlink points to.
When the Link to Data checkbox is selected, select a report or chart from the Elements drop-down list, which contains a listing of all the report and chart elements already added on the template. When the hyperlink is clicked in the preview window, the display jumps to the linked element automatically.
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:
Select the menu option InsertÆImage.
Click the Insert Image button, as shown below.
|
|
Figure 276: Insert Image Button |
The Image Properties window opens with the Image tab selected, as shown below.
|
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.
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.
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. |
The Attributes tab contains the following options:
Alignment
Vertical alignment
Indent
See Table 92 Attribute Tab Options on page 437 for descriptions of these options.
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.
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:
Standard Netcool Reporter chart definition files with GIF output format.
Lightweight chart definition files with support of Lightweight chart templates.
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:
Select the menu option InsertÆChart.
Click the Insert Chart button, as shown below.
|
|
Figure 279: Insert Chart Button |
The Chart Properties window opens with the Chart tab selected, as shown below.
|
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.
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.
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
Group
No Group
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.
|
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.
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.
The Attributes tab contains the following options:
Alignment
Vertical alignment
Font
Foreground
Background
Indent
For descriptions of these options, see Table 92 Attribute Tab Options on page 437.
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:
Default Report with default report styles.
Parameterized reports with appropriately supported report styles.
XML output files from Netcool Reporter.
CSV files.
To insert a table element into the template, use one of the following options:
Select the menu option InsertÆTable.
Click the Insert Table button, as shown 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.
|
The same report, displayed within a form, is shown in Figure 292 on page 462.
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.
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.
|
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.
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.
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.
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
Group
No Group
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.
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.
The Attributes tab contains the following options:
Alignment
Vertical alignment
Font
Foreground
Background
Indent
Use Transparent Background
See Table 92 Attribute Tab Options on page 437 for descriptions of these options.
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
>
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:
ID
That is, to identify a file by file ID. The location_value is file ID.
Example: ID:1234
NAME
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.
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.
|
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.
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>
The following system variables can be used as parameter values:
%CURR_USER%
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>
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:
Default Report with default report styles.
Parameterized reports with appropriately supported report styles.
XML output files from Netcool Reporter.
CSV files.
To insert a form into the template use one of the following options:
Select the menu option InsertÆForm.
Click the Insert Form button, as shown below.
|
|
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.
|
The same report, displayed within a table, is shown in Figure 284 on page 450.
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.
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.
|
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.
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.
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.
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
Group
No Group
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.
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.
The Attributes tab contains the following options:
Alignment
Vertical alignment
Font
Foreground
Background
Indent
Use Transparent Background
See Table 92 Attribute Tab Options on page 437 for descriptions of these options.