Chapter 4 Using the Report Editor

Modifying HTML report properties

The HTML Format page includes the following properties. Each property is optional. If you do not want any HTML presentation template when generating, select <None> in the Template list:

Property Description
Template List of available HTML presentation template file names in the HTML Report Style Sheets folder.

You can click the Preview HTML Report Presentation Template tool to view the current HTML presentation template in your default browser.

You can click the Save HTML Report Presentation Template File tool to save changes you have made in a presentation template or to save a presentation template you have created.

You can click the Delete HTML Report Presentation Template File tool to delete a presentation template that you no longer want.

You can click the Select HTML Report Style Sheets tool to browse for an HTML presentation template in a folder of another version of PowerDesigner.
Style sheet Absolute or relative path of the style sheet file (CSS file). You can browse for a local or shared file (UNC), or type a URL.

You can click the Open HTML Report Style Sheets File tool to open the CSS file in your default text editor.

You can click the Browse for HTML Report Style Sheets File tool to browse for a CSS file within the folder you have selected for the presentation template.
Header

Location

Height 		Absolute or relative path of the header file (HTML file). You can browse for a local file or shared file (UNC), or type a URL.

Height in pixels of the upper header.

You can click the Open HTML Report Header File tool to open the HTML file in your default editor.

You can click the Browse for HTML Report Header File tool to browse for an HTML header file within the folder you have selected for the presentation template.
Footer

Location

Height 		Absolute or relative path of the footer file (HTML file). You can browse for a local file or shared file (UNC), or type a URL.

Height in pixels of the lower footer.

The tools beside the Footer box allow you to do the same actions as the ones beside the Header box.
Home page Absolute or relative path of the home page file (HTML file). You can browse for a local file or shared file (UNC), or type a URL.

The tools beside the Home page box allow you to do the same actions as the ones beside the Header box.
TOC

Level

Width 		Number of maximum depth levels to display in the HTML table of contents (TOC). 3 is the default level.

Width of the table of content expressed as a percentage of the total width of the report window.
Image Format

SVG

PNG

JPEG 		Format for Graphic items associated with diagrams. If your report contains large diagrams you should select the SVG format that allows you to interact with the graphics, see below for more details. During compression to reduce the graphic size, the PNG format (Portable Network Graphic) reduces the loss of quality but is longer to generate than the JPEG format.
List format

Number of rows per page

Links to additional results 		Format for Lists.

You can define the number of rows you want to display in the list results.

You can also define the number of links to additional results displayed below the list. Additional results are numbers with hyperlinks to other pages containing the next rows of the list.
Add page break for top level list and cards Page breaks creation for each top level list and card to avoid long HTML pages.

Reduce the size of the HTML TOC

You can reduce the size of the HTML TOC using the following commands from the contextual menu of a book item in the Report Items pane:

Show contents in HTML TOC When you deselect the Show contents in HTML TOC command, you only display the title of the item without its contents in the table of contents.

Show book title in HTML TOC When you deselect the Show book title in HTML TOC command, you remove the title of the book item from the table of contents. Note that the Show contents in HTML TOC option is also automatically deselected.

Style sheets and headers and footers associated files

When you generate an HTML report and want to keep the links associated with your style sheets (CSS) or headers and footers files (HTML), we recommend you to gather the linked files in a special folder named as the file to which they are associated and located at the same level in your explorer.

For example, the header Header_Blue.html uses files that should be gathered in folder Header_Blue_files :


This is to make sure that when generating the report, the content of the associated folders is also copied and links associated to your style sheets and headers and footers work properly.

Location type dependent

Depending on their type of location (local or UNC paths, or URL), style sheet files, header and footer files and home page files are used the following way:

Location Use
Local path or UNC path The HTML or CSS file is copied into the report generation folder.
URL The reference in the HTML report uses the HTML or CSS file as it is.

Valid codepage

By default, PowerDesigner generates in the HTML page a character set (charset) built from the current language of the report. If this is not correct for your needs, you can change the charset as follows:

Steps To change the charset:

  1. Right-click the report in the Browser, and select Properties from the contextual menu to open its property sheet.
  2. On the General tab, click the Properties button to the right of the Language field to open the Report Language resource file in the Resource Editor.
  3. Expand the Report Titles→Common Objects category, and set the appropriate values for the CharSet and CodePage items.

You can find examples of HTML charset at : http://www.w3.org/International/O-charset-lang.html.

SVG graphic format

Scalable Vector Graphics is an XML-based language for Web graphics from the World Wide Web Consortium (W3C). If you choose the SVG graphic format for the generation of images in your HTML report, you should use a browser with an integrated SVG viewer.

You can install an SVG viewer if your browser does not have it already, see http://www.w3.org/Graphics/SVG/SVG-Implementations.htm8 for more information about SVG viewers for Internet Explorer and Netscape.

You can also use a browser with an embedded SVG viewer like Opera or Firefox, in this case make sure the browser is running the correct SVG viewer version.

An SVG viewer provides the following features:

Default & Save as Default buttons

The Default button allows you to return to the previously saved format in the registry.

The Save As Default button allows you to save the current format in the registry. This format becomes the new default HTML format.

Steps To modify HTML report properties:

  1. Select Report→Report Properties from the Report Editor window, and click the HTML Format tab.
  2. Select an HTML presentation template in the Model list.

    or

    Select an HTML presentation template from the Template list in the Presentation Options page of the Report Creation Wizard.

    The options that follow are not available from the Report Creation Wizard.
  3. <optional> Browse for a .CSS file or type a URL in the Style Sheet box.
  4. <optional> Browse for a local or shared HTML file, or type a URL in the Header box.
  5. <optional> Browse for a local or shared HTML file, or type a URL in the Footer box.
  6. <optional> Browse for a local or shared HTML file, or type a URL in the Home page box.
  7. <optional> Type a number in the Level box and a percentage in the Width box of the Table of contents groupbox.
  8. <optional> Select image format and type a number for list format.
  9. Select the check box to Add page breaks for top level lists and cards.
  10. Click OK.

    When you generate the HTML report, it reflects the properties you have defined for the report.

Note   Previous, Next, Home navigation buttons
You can translate the navigation buttons (Previous, Next, Home) generated by default in your HTML report using HtmlNext, HtmlPrevious and HtmlHome items in the Report Titles\Common Objects category of the Report Language Editor. For more information, see the "Using the Report Language Editor" chapter.

Note   Default buttons
You can set as default the current property values for your HTML report by clicking the Set As Default button.
You can also return to the previously saved values, by clicking the Default button.

 

Copyright (C) 2007. Sybase Inc. All rights reserved.