This manual will help you get started using Oracle Reports, as well as introduce you to publishing data to the Web and paper.
This tutorial is intended for users new to Oracle Reports, or for users familiar with Oracle Reports who would like to learn more about building JSP-based Web reports.
Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at
Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.
This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
To reach Oracle Support Services, use a telecommunications relay service (TRS) to call Oracle Support at 1.800.223.1711. An Oracle Support Services engineer will handle technical issues and provide customer support according to the Oracle service request process. Information about TRS is available at http://www.fcc.gov/cgb/consumerfacts/trs.html, and a list of phone numbers is available at http://www.fcc.gov/cgb/dro/trsphonebk.html.
For more information about Oracle Reports, refer to the following resources:
Oracle Reports online Help, which you can access in two ways:
From Reports Builder:
Choose Help > Help Contents.
Click Help or press F1 in any dialog box.
In the Property Inspector, click a property, then press F1 to display the property's help topic.
On the Oracle Technology Network (OTN) Oracle Reports 10g page (
Under Resources, click Hosted Online Help to display the Web-based version of the most recent Oracle Reports online Help.
Under News, click Oracle Reports Online Help Update to replace your Oracle Reports online Help in Reports Builder with the most recent update. Instructions for replacing your help file are included in the
readme.txt in the download file.
The following text conventions are used in this document:
|boldface||Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.|
|italic||Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.|
||Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.|
||Monospace italic type indicates variables or user-supplied names.|
|[ ]||Brackets enclose optional clauses from which you can choose one or none.|
The exercises in the tutorial use the Human Resources sample schema provided with the Oracle database and an HTML template.
The supporting files for the report you will build are available on the Oracle Technology Network (OTN): on the Oracle Reports 10g page (
http://www.oracle.com/technology/products/reports/index.html), click Getting Started to display the Getting Started with Oracle Reports home page. In the list of topic sections on the left, click Index. In the Topic list, choose Building and Developing Reports; in the Collateral Type list, choose Examples, then click Search. In the list of topics that displays, find Tutorial Sample Files and click the Download icon to download a zip file, called
tutorial_examples.zip. This zip file contains a text file containing the SQL you will enter, as well as the JSPs you will create in every chapter. Extract this zip file into
\examples (for example,
This tutorial relies on the data contained in the Human Resources section of the sample schema. This sample schema is provided with the Oracle database.
To produce the Web-based report, you must have a Web browser installed on your computer. The minimum and recommended requirements are:
Microsoft Internet Explorer 4.x or higher
Netscape Communicator 4.x or higher
Although you can view the Web source for your JSP report in Reports Builder, this tutorial also shows you how to analyze your Web source in a text editor. It is recommended that you use a text editor such as NotePad or UltraEdit.