Reports Builder can generate report output to Hypertext Markup Language (HTML) and Hypertext Markup Language with a Cascading Style Sheet (HTMLCSS) files, containing the formatted data and all objects. HTML is a form of encoding text formats that can be read by many different Web page developing software packages, such as Microsoft Front Page, and Web browsers. You can use the software's editing and graphics features to modify and enhance your report output. When you generate your report output to an HTML or HTMLCSS file, you can distribute the output to any HTML destination, including e-mail, printer, OracleAS Portal, and Web browser.
Note: This topic discusses the HTML generated when you run a paper-based
report to an HTML or HTMLCSS file. This is unrelated to HTML that might be generated
when you run a JSP-based Web report (when you click
in the toolbar, or choose Program
Run
Web Layout).
Oracle Reports 10g Release 2 (10.1.2) introduces HTMLCSS enhancements, which include the capability to apply style sheets and user-defined styles to your report or report objects for HTMLCSS output, using the following new properties:
Style Sheets property
CSS Class Name property
CSS ID property
Also new in Oracle Reports 10g Release 2 (10.1.2) is support for HMTL formatting in all bitmap output supported by Oracle Reports (including PDF, RTF, HTML, HTMLCSS, and PostScript), as described in About HTML formatting.
Note: If you modify your report's Before Report Value property or After Report Value property, you must make sure that you specify valid HTML. If the HTML is not valid, the generated HTML report output may not pass HTML 4.01 syntax checkers.
Document taxonomy (classification) for HTML and HTMLCSS output is provided by the report properties Title, Author, Subject, and Keywords, which assist in cataloging and searching a report document
You can preview your HTML or HTMLCSS report output in your Web browser
by choosing FilePreview
Format
Paginated
HTML (or Paginated HTMLCSS).
Bookmarks cause multiple HTML files to be created. One master file is created
with two frames: one for bookmarks and one for the report output. One HTML
file is created for each of these frames. The master document filename is
the name specified in the DESNAME parameter. The bookmark filename is desname
b.htm
.
The report output filename is desname
d.htm
.
Linked images, image fields, and graphs in a report cause GIF files to be created and referenced from the HTML document. Note that even if the linked boilerplate or image field refers to an external GIF file, a new GIF file is generated.
If an image is stored in the database, one GIF file may be generated for each occurrence of the image in the report. If an image is stored in a file (for example, imported images, linked boilerplate, or image fields that reference files), only one GIF file will be generated per image regardless of how many times it is repeated in the report.
Any GIF image files generated for HTML output have a number sequence (for example,
desname
0.gif
... desname
17.gif
).
A comment block in the master document contains the names of all of the files that are associated with the master document.
HTML has seven sizes for text. The font sizes in the report are mapped according to the following table. Note that the user can override the size specified in the HTML file from their browser.
Report Font Size |
HTML Size |
less than 8 |
1 |
8 through 9 |
2 |
10 through 12 |
3 |
13 through 15 |
4 |
16 through 20 |
5 |
21 through 30 |
6 |
more than 30 |
7 |
Note: If the font used in the report is non-proportional, TeleType mode is turned on for the generated HTML file.
HTML does not have the concept of a page. A separator line is placed between
each page of the report. Depending upon the browser, you may or may not
need to scroll to see the entire report page. Furthermore, if you print
the HTML document from your browser, the printer will not necessarily print
the separator lines at the bottom of each page. If you do not want the separator
line or you want to use a different separator line, you can use SRW.SET_AFTER_PAGE_HTML
to change it.
For HTMLCSS, graphics and text can be overlapped.
Once you have generated your report to an HTML or HTMLCSS file, the data model and looping tags are removed and replaced with the data. You can open the HTML or HTMLCSS file in Reports Builder, but it will be a static text file and not a report.
For information about paginating HTML or HTMLCSS output, see About HTML page streaming.
Objects cannot overlap one another. For example, you could not have text on top of an image.
If objects overlap slightly (two characters or less), then the underneath object is truncated to prevent overlap.
If objects overlap significantly (or one is completely on top of the other), then the underneath object is removed altogether. In this case, any linking information of the removed object is transferred using the same rules as if it were a frame (see the rules about frames below).
Text always takes precedence over horizontal lines, regardless of which is on top. This prevents the line underneath a column label from eliminating the label text.
When multiple output files are generated (for example, when bookmarks are used), any file except the master file will be overwritten without confirmation. For example, GIF files and bookmark files would be overwritten without prompting.
Report frames are not visually represented in the HTML output. Any fill or border attributes of frames do not appear in HTML output.
If the frame in a report is the target of a link or a bookmark, that attribute is transferred to the visible object nearest to the upper left corner of the frame in HTML output. If the frame object is a hyperlink, that attribute will be transferred to all the child (interior) objects that are not hyperlinks. If the hyperlink attribute cannot be transferred to the child objects, the frame's hyperlink is lost.
The only drawn object supported in HTML is a solid, black, horizontal line. The line width specified in the report may be honored depending upon the browser. All other drawn objects (for example, rectangles or circles) in the report layout will not show up in the HTML output. Space for these drawn objects is reserved, but there is no visible representation in the HTML output.
Background (fill) and border (line) colors/patterns for text are not available in HTML. Bold, italic, underline, and foreground (text) color are supported if the browser supports them.
The PDF action attribute is ignored for HTML output.
Any browser customizations that have been made will affect how the generated HTML is displayed.
About Web links for HTML output
Generating HTML or HTMLCSS output
Copyright © 1984, 2005, Oracle. All rights reserved.