Oracle Report Builder 10g

Oracle Reports Developer 10g: Build Reports
Electronic Presentation
D17075GC10 Production 1.0 June 2004 D39524
Authors Ellen Gravina Smitha Keshav Technical Contributors and Reviewers Cem Ayberkin Christian Bauwens Alena Bugarova Kathryn Cunningham Laurent Dereac Mark Fleming Warren Lord Marcelo Manzano Darren McBurney Paul Narth Daphne Nougier Miyuki Ohsato Ligia Jasmin Robayo Jim Safcik Rie Saitoh Navneet Singh Sarah Spicer Martijn van der Bruggen Vanessa Wang Philipp Weckerle Ted Witiuk Publisher Sujatha Nagendra
Copyright 2004, Oracle. All rights reserved. This documentation contains proprietary information of Oracle Corporation. It is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright law. Reverse engineering of the software is prohibited. If this documentation is delivered to a U.S. Government Agency of the Department of Defense, then it is delivered with Restricted Rights and the following legend is applicable: Restricted Rights Legend Use, duplication or disclosure by the Government is subject to restrictions for commercial computer software and shall be deemed to be Restricted Rights software under Federal law, as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, Rights in Technical Data and Computer Software (October 1988). This material or any portion of it may not be copied in any form or by any means without the express prior written permission of the Education Products group of Oracle Corporation. Any other copying is a violation of copyright law and may result in civil and/or criminal penalties. If this documentation is delivered to a U.S. Government Agency not within the Department of Defense, then it is delivered with Restricted Rights, as defined in FAR 52.227-14, Rights in DataGeneral, including Alternate III (June 1987). The information in this document is subject to change without notice. If you find any problems in the documentation, please report them in writing to Worldwide Education Services, Oracle Corporation, 500Oracle Parkway, Box SB-6, Redwood Shores, CA 94065. Oracle Corporation does not warrant that this document is error-free. Oracle is a registered trademark and all references to Oracle and Oracle Products are trademarks or registered trademarks of Oracle Corporation. All other products or company names are used for identification purposes only, and may be trademarks of their respective owners.
Introduction
Copyright 2004, Oracle. All rights reserved.
Course Objectives
After completing this course, you should be able to do the following: Describe the capabilities of Oracle Reports Develop and maintain Web and paper reports in different styles using Reports Builder Lay out and format data to meet user reporting requirements Incorporate text, images, and graphics in reports
Course Content
Day 1: Introducing Oracle Reports Developer Designing and running reports Working in Oracle Reports Builder Creating and modifying paper reports using the Wizard Enhancing a paper report in the Paper Design view Day 2: Managing templates Creating a Web report Enhancing report structure
Course Content
Day 3: Using the paper layout Modifying properties Using Web reporting Extending functionality using XML Day 4: Customizing reports with parameters Embedding graphs Enhancing matrix reports Adding PL/SQL code
Course Content
Day 5: Extending functionality using the SRW package Using OracleAS Reports Services Efficiency and performance guidelines
Introduction to Oracle Reports Developer
Objectives
After completing this lesson, you should be able to do the following: Describe business intelligence List the benefits of enterprise reporting Describe the differences between Web publishing and paper publishing Describe the key features of Oracle Reports Developer Describe the architecture of Oracle Application Server Describe OracleAS Reports Services
Business Intelligence
Discoverer Server Reports Server
XML
Enterprise Reporting
Provides access for more users to vital customized information Lowers cost of ownership Uses integrated business intelligence
Any Client Web Application Server Data Server
Enterprise Reporting
Reporting
Ad hoc query
Web Client
Advanced analysis Data Server Application Server
Web Publishing
GIF89a hyperlinks
JavaScript
Paper Publishing
8.5
GIF89a
hyperlinks 11 JavaScript
Oracle Reports Developer

Publish data from any source, in any format, to any destination with high fidelity.
JDBC OLAP XML TEXT <Your Data Source>
Benefits
Publish data from any source, in any format, with high fidelity Develop one time and deploy anywhere Open, standards-based, modular architecture
Oracle 10g Products
Oracle 10g provides the complete solution: Oracle Database 10g Oracle Developer Suite 10g Oracle Application Server 10g
Oracle Database 10g
Oracle Database 10g manages all of your data:

Relational Data
Documents
Multimedia
Oracle Developer Suite 10g

Application Development
Oracle Developer Suite 10g

Business Intelligence
Oracle Application Server 10g
Browser
Oracle DB Non-Oracle
Wireless
Packaged Apps
Web Services
B2B Apps
Oracle Reports Developer
User-friendly wizards Pluggable data sources Customizable report templates WYSIWYG live editor for paper reports Dynamic Web publishing using JSP/HTML Run-time customization Dynamic SQL execution Portal integration Event-based reporting
OracleAS Reports Services
Flexible reporting Reduced overhead Fast distribution Real time publishing
OracleAS Reports Services Architecture for the Web
HTTP Oracle HTTP Listener mod_OC4J JSP Engine Oracle Internet Directory CORBA/IIOP OracleAS Reports Services CORBA/IIOP Reports Engine PDS
Summary
In this lesson, you should have learned how to: Describe integrated business intelligence List the benefits of enterprise reporting Describe the challenges of publishing for different media List the Oracle 10g products List the key features and benefits of Oracle Reports Developer Describe OracleAS Reports Services
Designing and Running Reports
Objectives
After completing this lesson, you should be able to do the following: Identify user requirements Name the common report styles Describe the structure of each style Run prebuilt reports as an end user Identify supported report file types
Understanding User Requirements
What data Parameters
Web features Security
Web or Paper
Charts Drill down
Designing Reports
Before you start development, consider:

Specification Data retrieval Common features Structure
Style Publishing Medium
Tabular
List of Products Product Number
Description
Price
Master-Detail
Outstanding Customer Items Customer Name Product Number Price
Customer Name Product Number Price
Master with Two Details

Customer Statistics Customer Outstanding Items Product Number Price Orders in Last Six Months Order No. Date Total Value
Matrix
Customer Matrix Product ID Customer
Retrieving and Sharing Data
Keep database access to a minimum Consider report structure and number of queries Make effective use of common code and objects
Running a Report
Your browser OracleAS Portal application Command line (Start > Run) OracleAS Reports Queue Manager Java application Database trigger Menu integrated with a Forms application Button in a Forms application
Previewing Reports
Print Preview
1 2 3
Print Preview
1 2 3
Supported File Types
RDF REP JSP HTML XML
Summary
In this lesson, you should have learned how to: Identify key questions to help understand user requirements List the simple report styles and describe their underlying structures Identify key design considerations:
Report style Database access Common code Common objects
List the various options for running a report
Practice 2 Overview
Executing existing reports
Working in Oracle Reports Developer
Objectives
After completing this lesson, you should be able to do the following: Describe the main Oracle Reports executables Describe the main components of Reports Builder Describe the main objects in a report
Reports Developer Executables
Developer
Reports Builder rwbuilder Reports Runtime rwrun Reports Converter rwconverter
Reports Services
Reports Server rwserver Reports Client rwclient Queue Manager rwrqm
Reports Servlet rwservlet
Reports CGI rwcgi
Invoking Reports Builder
Reports Builder Modules
Report
Template
PL/SQL Library
Report Data and Layout
Paper
Web
Reports Builder Components
Main Menu Structure
Main Menu Structure
Main Menu Structure
Main Menu Structure
Wizards
Report Wizard Data Wizard Graph Wizard Report Block Wizard
Report Editor
Data Model Web Source Paper Layout Paper Design Paper Parameter Form
PL/SQL Development Environment: Syntax Palette
Object Navigator
Report-Level Objects
Properties Triggers PL/SQL Program Units Attached Libraries
Data Model Objects
Parameters Queries Groups Columns Data Links
Paper Layout Objects
Frames Repeating frames Fields Boilerplate
Paper Parameter Form Objects
Fields Boilerplate
Object Interrelationship
1
Select
...
2 3
Customizing Your Oracle Reports Developer Session
Saving Preferences
Oracle Reports Environment Variables
REPORTS_PATH REPORTS_TMP REPORTS_RESOURCE ORACLE_PATH REPORTS_CLASSPATH
Windows: Modify in Registry
Using the Online Help System
Summary
In this lesson, you should have learned how to: Describe the Oracle Reports executables List the types of modules you can create in Reports Builder Describe the views of the Report Editor Describe the main object categories in a report module
Practice 3 Overview
Invoking Reports Builder Opening an existing report Switching views in the Report Editor Accessing the Help system
Creating a Paper Report
Objectives
After completing this lesson, you should be able to do the following: Create a simple tabular paper report using the Report Wizard Describe the methods of building the report query Summarize report values Modify the style and content of a report Create other report styles available in the Report Wizard Preview a paper report on the Web
Report Module Components
Data Model Web Source Paper Layout Paper Parameter Form Program Units
Building a Paper Report
You have two options: Use Reports Builder

Wizards Paper Layout Paper Design
Define the report in XML
Invoking the Report Wizard
Choosing the Layout Type
Wizard Pages Report Style Data Source Type Data Source Definition Fields Totals Labels Template
Creating a Tabular Report
Wizard Pages Report Style Data Source Type Data Source Definition Fields Totals Labels Template
Selecting the Data Source Type
Using Query Builder
Building a Query
Building a Query
Query Builder Functions
User-friendly interface: Alternative to writing SQL syntax

1 2 3 4
6 5
Selecting Displayed Fields
Totals and Labels
Selecting a Report Template

Enforce corporate standards Create professional-looking paper reports easily
Viewing the Paper Report Output

2 1
Saving the Report Definition
Save changes frequently.

File > Save
File > Save As...
xxx.rdf
yyy.rdf
Reentering the Wizard
Select Tools > Report Wizard. Tabs are different for each report style. Wizard preserves all previous settings.
Creating a New Report
Creating Break Reports
Break report styles:

Group Left, Group Above
Additional wizard page:

Groups
Break Report Labels

Group Left
Location Id xxxx
Department Name xxxxxx
Last Name Job Id xxxx xxxxxxx xxxxx xxxx
Group Above
Location Id
xxxx xxxxxx Job Id xxxxx xxxx
Department Name Last Name xxxx xxxxxxx
Creating Mailing Labels and Letters
Wizard pages: Style Data Text Template
Creating a Matrix Report
Three additional wizard pages: Matrix rows Matrix columns Matrix cells
Previewing a Paper Report in a Browser
Use Insert > Bookmark to create a bookmark for your break report
Use File > Generate to File
Previewing a Paper Report in a Browser
Summary
In this lesson, you should have learned how to: Create paper reports with the Report Wizard Build queries using the Query Builder Apply templates to paper reports Modify reports by reentering the wizard Create new reports of different styles Preview a paper report on the Web
Practice 4 Overview
Creating a Tabular report Modifying the report to create a Group Above break report Creating a Form Letter Creating a Matrix report Creating a Matrix with Group report
Enhancing a Basic Paper Report
Objectives
After completing this lesson, you should be able to do the following: Describe the Paper Design view Modify the display of report data in the Paper Design view Modify the positioning of report data Highlight data using conditional formatting Add page numbering and the current date
What Is the Paper Design?
The Paper Design is a view of report output that allows live editing of text and paper layout attributes: True WYSIWYG report editing Easy editing: See it. Click it. Change it. Cached report data
The Paper Design Window

1 2 3
4
Modifying a Report
Common modifications: Align columns Set format masks Manipulate objects Edit text Modify visual attributes Highlight data using conditional formats Insert page numbers and current date
Aligning Columns
Point and select
Select Align Right
Setting a Format Mask
Change format masks from the stylebar
Manipulating Objects
Clear fields Move fields Resize fields
Flex Mode adjusts layout during changes.
Modifying Visual Attributes
Modify text colors and fonts Edit text Set fill, patterns, and colors Use the Parent Frame tool to select an enclosing object
-Sales Report Year 1993 1993 1993 Year 1994 1994 Region Sales Americas 200 Europe 400 Asia Pacific 770 Region Americas Europe Sales 210 390 Sales Report by Area Year 1993 1993 1993 Year 1994 1994 Region Sales Americas 200 Europe 400 Asia Pacific 770 Region Americas Europe Sales 210 390 Sales Report by Area Year 1993 1993 1993 Year 1994 1994 Region Sales
Americas 200 Europe 400 Asia Pacific 770 Region Americas Europe Sales 210 390
Applying Conditional Formatting
Inserting Page Numbers, Dates, and Times

Inserted easily Customizable extensions
Customizing Dates
Summary
In this lesson, you should have learned how to: Enhance report output using live data:
Move, resize, delete objects Edit text Alter fonts, colors, and patterns Apply format masks Add page numbering and current date
Save report to preserve changes
Practice 5 Overview
Modifying reports by applying changes in the Paper Design view
Managing Report Templates
Objectives
After completing this lesson, you should be able to do the following: Describe the template regions Describe the difference between default and override template sections Modify a predefined report template Register a customized template Add a Web link to a template
Using Report Templates
For paper reports, you have three template options: Predefined User-defined No template
Installation templates in: <oracle_home>\reports\templates
Modifying a Template
Margin Body
Customizing the Template Margin
Include objects such as: Images Text Page Numbers Date
Customizing the Template Body
Adding Web Links to a Template for Report HTML Output
Predefining Your Own Templates
Modify and save template file (mytemp.tdf) Move file to template directory: <oracle_home>\reports\templates> Register name and description in cagprefs.ora
Reports.Tabular_Template_File = (rwbeige, rwblue, mytemp, rwgray, rwgreen, rwpeach, Reports.Tabular_Template_Desc = ("Beige", "Blue", "My Template Description", "Gray", "Green", "Peach",
Adding a Template Preview Image
Image area is 200 x 150 pixels Image filenames = template name + .bmp Move .bmp files to template directory
Summary
In this lesson, you should have learned how to: Modify existing templates to create your own userdefined template Modify the default section for all styles or override for individual style changes Add your templates to the predefined list Display an image for a predefined template Add Web links for report HTML output
Practice 6 Overview
Customizing an existing template Applying the modified template to an existing report Adding a Web link
Creating a Web Report
Objectives
After completing this lesson, you should be able to do the following: Identify the options for designing a Web page Create a simple Web report using the Report Wizard Invoke the Web Source view of the Report Editor Describe the elements of the Web source code Preview a Web report Identify supported image formats for Web reports
What Is JSP Technology?
Dynamic scripting capability for Web pages Server-side technology Enables the separation of dynamic and static content in a Web page
JSP Advantages
Separation of dynamic and static content Support for scripting and tags Reuse of components and tags Portable, powerful, and easy to use Accepted industry standard for building dynamic Web pages
Simple JSP Example
<HTML> <HEAD><TITLE>Simple JSP Example</TITLE></HEAD> <BODY> Welcome to my page!! Current time is : <%= new java.util.Date() %> </BODY> </HTML>
Building a Web Report
Two Options: Open an existing HTML page in Reports Builder Use one of the predefined HTML templates shipped with Oracle Reports Developer
Using the Report Wizard
Report Editor: Web Source View

Reports JSP Custom Tag Library Start of report
Data model information HTML template information
End of report
JSP Tags
Standard JSP Tags

taglib page
Reports Custom JSP Tags

rw:report rw:objects rw:foreach rw:field rw:include
Web Source Example
Generating Output
Image Format Support
Source Image Formats: JPG, JPEG GIF PNG BMP TIFF CGM Progressive JPEG Exif JPEG
Destination Image formats: JPG, JPEG GIF PNG BMP
Summary
In this lesson, you should have learned how to: Create a Web report using the Report Wizard and a predefined HTML template Identify and describe standard and Reports custom JSP tags Use the Run Web Layout feature to test Web deployment
Practice 7 Overview
Creating Web reports using the Report Wizard Examining the Web source code Modifying a Web report using the Report Wizard
Enhancing Reports Using the Data Model: Queries and Groups
Objectives
After completing this lesson, you should be able to do the following: Describe the Data Model objects Modify query properties Modify the report hierarchy Change the order of data in a group Eliminate data from a report
The Data Model Objects
Modifying Properties of a Query
Modifying Properties of a Query
Modify SQL query statement:

Add, rename, or delete columns Use column and table aliases Remove or modify schema name
Syntax error checks occur when:

Exiting SQL query statement Compiling or executing a report
More Properties
Aid maintenance and testing: Rename queries in complex reports Add comments to describe queries:
Use the Comment property -- comment for single lines /*comment*/ for multiple lines
Set Maximum Rows to Fetch to restrict data
Applying Changes
Update the paper layout and Web source to reflect changes in the Data Model. For paper reports:
Select Report Wizard. Alter the necessary tabbed pages.
The Wizard destroys previous layout and creates new objects. For Web reports:
Select the Report Wizard and navigate through each of the tabbed pages, reselecting the desired options. or Edit the Web source manually.
Changing the Group Structure
Groups determine hierarchy and frequency. Wizard creates default groups.

Default naming conventions You can change query name. You can change group name.
Developer-created groups for:

Control break reports Complex matrix reports
Group Hierarchy
Ordering Data in a Group
1 2 3
Query Modifications
In a break report, data order is determined by: Break order columns in the break groups Columns that you specify in the ORDER BY clause
SELECT d.department_id, d.department_name, e.last_name... FROM employees e, departments d WHERE e.department_id = d.department_id ORDER BY 2, e.salary
Filtering Data in a Group
Using a Packaged Filter
Reports Developer provides two packaged filters: First: Retrieves the first <n> records for the group Last: Retrieves the last <n> records for the group
Summary
In this lesson, you should have learned how to: Identify Data Model objects Modify query properties Modify the report hierarchy by creating additional groups Filter data in a group
Practice 8: Overview
Modifying report hierarchy Restricting records in a query Restricting records with a packaged filter
Enhancing Reports Using the Data Model: Data Sources
Objectives
After completing this lesson, you should be able to do the following: Describe the various data source types Create reports using pluggable data sources Create supplemental rows of data by adding queries Reuse PL/SQL code to create a REF cursor Link data from multiple data sources using a data link
Data Source Types
Access data from a variety of sources: SQL-based XML Oracle OLAP JDBC Express Text
Pluggable Data Sources

Text files
Express JDBC
OLAP
SQL
XML
Oracle Reports
Client Oracle10g
Out-of-the-Box Options
Using XML as a Data Source
Example: XML Data Stream
XML Report
OLAP Data Source
Multidimensional objects OLAP database
Defining an OLAP Query
Example: OLAP Report
Using Text as a Data Source
Setting Up the textpds.conf File
Defining a Text Query
Sample Text PDS Report
Using JDBC as a Data Source
JDBC data source
Configuring the jdbcpds.conf File
Defining a JDBC Query
Defining a JDBC Query
Adding New Data
1 5 6 7 2 3 4
Adding New Data
Using REF Cursor Queries
Viewing Output from Multiple Query Reports
Using Data Links

Equijoin
DEPARTMENTS Department_Id 90 100 Department_Name Executive Finance Last_Name DeHaan Department_Id = Department_Id Faviet 100 Greenberg Department_Id 90 100 EMPLOYEES
Using Data Links
Compound join:
Multicolumn primary or foreign key Define multiple equijoins
Nonequijoin:
Primary key value between two other values Create two links: employees.salary >= job_grades.lowest_sal employees.salary <= job_grades.highest_sal
Creating a Column-to-Column Link
Other Data Link Methods
Other methods of forming a link: Manual: Using a WHERE clause to form the link (SQL queries + column objects) Manual: Using parameters to form the link (REF cursor queries) Automatic: Using primary/foreign key constraints to form the link (SQL queries)
Efficiency Issues: Multiple- or SingleQuery Hierarchy

Outer joins Data ratio Multitier environment
Summary
In this lesson, you should have learned how to: Publish data from any source using the Pluggable Data Source feature Add additional queries using the Data Wizard Publish a report with data returned from a REF cursor query Create a relationship between data in different queries using a data link Design the data model to be most efficient
Practice 9 Overview
Creating a second query in an existing report Creating a data link Creating a report using a pluggable data source Creating a report containing a REF cursor query
Enhancing Reports Using the Data Model: Creating Columns
Objectives
After completing this lesson, you should be able to do the following: Describe various Data Model columns Display the contents of a file Identify characteristics of user-defined columns Create report summaries and subtotals Derive data using a formula column Create and populate a placeholder
Data Model Columns

5
2 3 4
Maintaining Data Source Columns
Read-only properties
Producing File Content Output
Creating a Column
Summary column
What type of value? Choose the correct column tool
Formula column Placeholder column
What frequency? Create in a group or at report level
C_xxx
C_xxx
C_xxx
Creating Summary Columns
Specific properties:
Function Source Reset At Compute At
Data type depends on Source data type Page summaries: Not supported in the wizard
Displaying Subtotals
Reset At: G_DEPARTMENT Report
Displaying Percentages
Reset At: G_EMPLOYEE Compute At: G_DEPARTMENT G_EMPLOYEE Report
Resetting Summary Values
Data Model Group REPORT G_DEPARTMENT G_EMPLOYEE
Reset At REPORT Grand Total Running Total Running Total G_DEPARTMENT G_EMPLOYEE XXXX Sub Total Running Total XXXX XXXX Record Total
Creating a Formula Column
Performs a user-defined computation Executes a PL/SQL function Must return a value Can be Character, Number, or Date Returned value must match data type
function CF_SALCALCFormula return Number is begin return(my_function(:salary)); end;
Creating a Placeholder Column
CP_xxx
An empty container at design time Populated by another object at run time

Before Report trigger Formula column at report level Formula column in same group or below placeholder
CF_xxx
Populating a Placeholder Column
Summary
In this lesson, you should have learned how to: Identify column types and their uses Create Summary columns Define valid summary levels in a report Specify column properties based on required output:
Reset At: Resets to zero Compute At: % of Total only
Create Formula columns to return values Create Placeholder columns to hold values
Practice 10 Overview
Creating a new report with summaries Adding summary calculations to an existing report Creating a new report with ranking summary columns Adding placeholders for highest and lowest values
Enhancing Reports Using the Paper Layout
Objectives
After completing this lesson, you should be able to do the following: Identify the paper report sections Design multipanel reports Mail a report Distribute a report to various destinations Describe the layout objects and relationships Modify an existing paper report layout Create variable length lines
Viewing the Paper Layout

Header section
Compensation Report

Header section
Compensation Report
Page 1 of 1
Main section

Header section
Compensation Report
Page 1 of 1
Main section
Trailer section
End of report
Viewing the Section Areas

Header section Body/ Margin
Compensation Report
Page 1 of 1
Main section Body/ Margin
Trailer section
End of report
Body/ Margin
Designing Multipanel Reports

Logical Page 1 Panel 1 Physical Page 1 Logical Page 1 Panel 2 Physical Page 2 Logical Page 1 Panel 1 Physical Page 3 Logical Page 1 Panel 3 Physical Page 5 Logical Page 1 Panel 1 Physical Page 7 Logical Page 1 Panel 2 Physical Page 4 Logical Page 1 Panel 4 Physical Page 6
Header
Main
Trailer
Printing Multipanel Reports
Page 1-1
Page 1-2
Page 2-1
Page 2-2
Logical horizontal panels = 2
Different Objects in the Paper Layout
4 5 1 2 3 6
The Paper Layout Layers
F_xxx R_G_xxx M_G_xxx Body
F_xxx
Layers of a tabular report
Avoiding Layout Errors
Confine Mode
Flex Mode
Report Processing
BEGIN M_G_master REPEAT R_G_master
f_xxx
f_xxx
BEGIN M_G_detail REPEAT R_G_detail
f_xxx
f_xxx
f_xxx
END M_G_detail
END M_G_master
Creating Layout Objects
The tool palette contains: Standard GUI drawing tools Frame, repeating frame, field objects Other layout objects
2 3 4 5
7 8 9
Paper Layout Tools
Pin a tool: Double-click Shift key for constrained objects Magnify Frame Select Report Block
Report Bursting
Header e-mail
Report Bursting
Body PDF
Report Bursting
Trailer HTML
Report Bursting
Dept 10
West East
Dept 20
West East
;
Dept 30
West East
Dept 40
Dept 80
Bursting on a Repeating Group
Bursting on a Repeating Group

Setting the Repeat On property
Creating an Additional Layout
Distributing a Report
Distributing a Report
Tracing the Report Distribution
Creating Variable Length Lines
Flex lines adjust to fit variable frames and repeating frames.
Summary
In this lesson, you should have learned how to modify the Paper Layout using: Report sections Layout objects and tools Report mailing, bursting, and distribution features Variable length lines
Using report sections Adding a repeating frame to the header page Adding flexible lines Distributing a report
Controlling the Paper Layout: Common Properties
Objectives
After completing this lesson, you should be able to do the following: Identify common paper layout properties Modify common paper layout properties Explain the use of format triggers Modify Web Settings properties
Modifying Paper Layout Object Properties
Accessing a Property Inspector: Object Navigator:

Select object Double-click node icon
abc
Paper Design or Paper Layout view:

Use Select Parent Frame tool Select Tools > Property Inspector
Comparing Properties
Intersection Pin
Common Layout Properties
Four objects with common properties: Frames Repeating Frames Fields Boilerplate Objects Some common properties affect: Sizing Pagination Frequency of display
Sizing Objects
Layout icons Elasticity Vertical Horizontal
fixed
expand
contract variable
Anchors
Objects in the push path have implicit anchors (not visible in Paper Layout)
Explicit anchors override implicit anchors All anchors appear in Object Navigator
Implicit (shaded) Explicit (solid)
Layout Object Relationships
1 2
Layout Object Relationships
4 1 2 3 6 5
Pagination Icons in the Paper Layout
Using Page Break Before

-11

-11 xxx xxx -2-

-11 xxx xxx -2-
-12

-11 xxx xxx -2-
-12 xxx xxx -2-
Using Page Break After

xxx xxx -1-
-12 xxx xxx -2-
Using Page Protect
f_dept_id Employee f_ename
Using Page Protect

-1-
f_dept_id Employee
40 xxxxxxxx xxxxxxxx
-2f_ename 41 xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx
Controlling Print Frequency

-1Your Company Your Company -2Your Company -3Your Company
Print Object On = All Pages Base Printing On = Enclosing Object
Using Format Triggers
Layout Object Properties for Web Support
Hyperlink Hyperlink Destination Bookmark Application Command Line
Summary
In this lesson, you should have learned how to: Identify common properties for most layout objects:
Size Pagination Print frequency Format trigger Web settings
Modify common properties for special reporting needs
Creating a break report with continuation pages displaying limited information Modifying properties for object Web support
Controlling the Paper Layout: Specific Properties
Objectives
After completing this lesson, you should be able to do the following: Identify specific layout properties Modify specific layout properties Explain the use of specific properties Create a file link Specify the format order for the report sections Enable cataloguing and searching of PDF output
Properties of a Repeating Frame
Specifying Print Direction

1 2 3
Controlling the Number of Records per Page

1
-1-2-3-2-
2
-1-
Controlling Spacing Between Records

Mailing Labels
1 2
Minimum Widow Records

Without widow control Page 1
Page 2
Minimum Widow Records

Without widow control Page 1 With widow control (Min Widow Records = 3) Page 1
Page 2
Page 2
Column Mode
Column Mode Off
Page 1
10
20
Page 2
20
30
Column Mode
Column Mode Off
Page 1
Column Mode On
Page 1
10
20
10
20
30
Page 2
Page 2
20
30
20
Properties of a Field
Fields define formatting attributes and logic Wizard creates a field for each column You create additional fields in the Paper Layout:
Source: Column, parameter, or system variable Format mask: Standard Oracle format symbols
System Variables
Page Numbering
Page 4 of 4 Example 1 Page 3 of 4 Page 2 of 4 Page 1 of 4 Report Title Example 2 End
Page 1 of 1 Page 2 of 2 Page 1 of 2 Report Title
End
Valid Source Columns
G_Region R_Region F_1 G_Dept R_Dept R_Emp
G_Emp
F_REPORT
Displaying File Contents
When Are the Contents Updated?
Reports Builder reads the file contents when you: Modify the Property Inspector Open a report definition Run a report
Linking and Importing Files

1

1 2 Import
Link

1 2 Import
Link 3

1 2 Import
Link 3 4
Comparing a File Link and a File Column
Q_EMP
G_EMP PICTURE 1 F_PICTURE
Specifying the Format Order
PDF Document Taxonomy Properties
Summary
In this lesson, you should have learned how to: Identify object-specific properties Modify these properties when necessary Create a file link in your report Modify the default format order for report sections Specify taxonomy properties for PDF documents
Modifying the printing of a mailing label report Controlling the number of records on a page Adding a file link to a report Ensuring all details of a master print on the same page
Web Reporting
Objectives
After completing this lesson, you should be able to do the following: Identify the attributes of a high quality Web report Describe the JavaServer Page run-time environment Describe static and dynamic Web reporting Add dynamic content to a Web page Identify Reports custom JSP tags Customize Web reports
High Quality Web Publishing
Comparing Static and Dynamic Reporting
Adding Dynamic Content
Report Block Wizard Graph Wizard <body>
</body> Data Model Web Source JavaServer Page (JSP)
Creating a Report Block
Invoking the Report Block Wizard
Examining the Web Source Code

Structure of a Reports JSP:
<%@ taglib uri="/WEB-INF/lib/reports_tld.jar" prefix="rw" %> <%@ page language="java" import="java.io.*" errorPage=/rwerror.jsp" %>
<rw:report id="report"> <rw:objects id="objects"> Data Model & Business Logic (XML) <layout> Paper Layout (XML) </layout> </rw:objects> <HTML> Web Layout (JSP) Graph (XML) </HTML> </rw:report>
Examining the Web Source Code
rw:foreach Tag
... <rw:foreach id="R_G_EMPLOYEE_ID_1" src="G_EMPLOYEE_ID"> <tr> <td <rw:headers id="HFEMPLOYEEID" src="HBEMPLOYEEID"/>. . . <td <rw:headers id="HFEmployee" src="HBEmployee"/> . . . ...
rw:field Tag
... <td <rw:headers id="HFEMPLOYEEID" src="HBEMPLOYEEID"/> class="OraCellNumber"> <rw:field id="F_EMPLOYEE_ID" src="EMPLOYEE_ID" nullValue=" "> F_EMPLOYEE_ID </rw:field></td> ...
Customizing Reports JSPs
Modify the classes in the style sheet Use HTML tags and attributes Use Reports custom tags
Customizing Reports JSPs Using Style Sheets

<rw:style id="rwbeige"> <link rel="StyleSheet" type="text/css" href="rwbeige.css"> </rw:style> <td <rw:headers id="HFEMPLOYEEID" src="HBEMPLOYEEID"/> class="OraCellNumber"><rw:field id="F_EMPLOYEE_ID" src=EMPLOYEE_ID" nullValue=" "> F_EMPLOYEE_ID </rw:field></td>
.OraCellNumber { color: #000000; background-color: #f7f7e7; font-family: Arial, Helvetica, sans-serif; font-size: 10px ; textalign: right}
Customizing Reports JSPs Using HTML Tags and Attributes
<thead> <tr> <th <rw:id id="HBEMPLOYEEID" asArray="no"/> class="OraColumnHeader"> Employee Id </th> <th <rw:id id="HBSALARY" asArray="no"/> align="right" bgcolor="yellow"> Salary </th> </tr> </thead>
Customizing Reports JSPs Using Reports Custom Tags

Tag attributes provide additional formatting functionality. Example: rw:field tag optional attributes: breakLevel breakValue nullValue containsHtml formatMask formatTrigger

<tbody> <rw:foreach id="R_G_EMPLOYEE_ID_1" src="G_EMPLOYEE_ID"> <tr> <td <rw:headers id="HFSALARY" src="HBSALARY"/> align=right"> <rw:field id="F_SALARY" src="SALARY" nullValue=" " formatMask="$999,999.00" > F_SALARY </rw:field> </td> </tr> </rw:foreach> </tbody>
Summary
In this lesson, you should have learned how to: Create a Web report using an existing HTML page and the Report Block Wizard Describe the structure of a Reports JSP and identify key custom JSP tags Use style sheets to customize Web reports Use HTML attributes and Reports custom tag attributes to customize Web reports
Adding dynamic content to an existing Web page Customizing a Web report using JSP tag attributes
Extending Functionality Using XML
Objectives
After completing this lesson, you should be able to do the following: Describe the benefits of XML definitions Create XML report definitions Apply XML report definitions Debug XML report definitions
Why Use XML Report Definitions?
Apply run-time customizations Perform batch updates Build fully functional reports Product openness
Creating XML Report Definitions
<report> <data> . . . </data> <layout> . . . </layout> </report>
XML tags Partial definition Full definition
Partial Report Definitions: Format Modification Example

<report> <data> </data> <layout> <section> <field .../> ... </section> </layout> </report>
Empty <data> tag Use of <layout> Use of <field>
Partial Report Definitions: Format Exception Example

Empty <data> tag Use of <exception> Use of <condition>
<report> <layout> <section> <field ...> <exception> <condition .../> </exception> </field> </section> </layout> </report>
Full Report Definition: Data Model Modification Example

<report> <data> <dataSource> ... </dataSource> </data> <layout> </layout> </report>
Empty <layout> tag Use of <dataSource> Column aliases Bind references
Running XML Report Definitions
Apply to an .rdf or .xml file

rwclient userid=... report=... customize=....xml server=... destype=... desformat=...
One or multiple definitions
Running XML Report Definitions
Before Form or After Form trigger

SRW.APPLY_DEFINITION(....xml);
Run by itself Batch updates

rwconverter source="(...)" dest=... customize=... batch=yes
Debugging XML Report Definitions
XML parser Tracing option Using Reports Builder
Summary
In this lesson, you should have learned how to: Use XML report definitions:
Run-time customizations Batch updates
Apply XML definitions Debug XML definitions
Creating an XML report definition Applying a run-time customization Debugging an XML definition
Creating and Using Report Parameters
Objectives
After completing this lesson, you should be able to do the following: Create and reference a parameter Create a list of values for parameter input Use and modify a system parameter Build a Paper Parameter Form layout Customize a Paper Parameter Form layout Use HTML parameter form extensions
Creating User Parameters
Restrict values in a WHERE clause

SELECT CUST_LAST_NAME, ACCOUNT_MGR_ID FROM CUSTOMERS WHERE ID = <a value>
Substitute any part of a SELECT statement

SELECT CUST_LAST_NAME, ACCOUNT_MGR_ID FROM CUSTOMERS <a where clause>
Substitute a single column or expression

SELECT <a column/expression> FROM CUSTOMERS
Creating User Parameters
Referencing Parameters in a Report Query

Bind reference replaces a value:
:parameter_name
Lexical reference replaces a clause:

&parameter_name
Using Bind References
Restrict values in a WHERE clause

SELECT CUST_LAST_NAME, ACCOUNT_MGR_ID FROM CUSTOMERS WHERE CUSTOMER_ID > :P_CUST
Substitute a single value or expression in the select statement

SELECT CUST_LAST_NAME, ACCOUNT_MGR_ID FROM CUSTOMERS ORDER BY DECODE( :SORT, 1, CUST_LAST_NAME, , 2, NLS_TERRITORY, ACCOUNT_MGR_ID)
Using Lexical References
Use to substitute any part of the query.

SELECT CUST_LAST_NAME, ACCOUNT_MGR_ID FROM CUSTOMERS &P_WHERE_CLAUSE &P_ORD_CLAUSE SELECT CUST_LAST_NAME, ACCOUNT_MGR_ID FROM CUSTOMERS &P_WHERE_ORD_CLAUSE SELECT FROM &P_CUSTNAME CUST, &P_ACCTMGR MGR &P_TABLE
Make sure that the number and data types match at run time.
Hints and Tips When Referencing Parameters

Always do the following: Specify column aliases when substituting column names Create lexical parameters explicitly in the Object Navigator Enter an initial value for parameters that affect query validation when NULL
Creating a List of Values
Static list of values

1
2 4 5
Creating a List of Values
Dynamic list of values

1 3 4 2 5
Referencing System Parameters
Building a Paper Parameter Form
+ Report properties: Width Height Number of Pages
Customizing a Paper Parameter Form
Using Parameter Form HTML Extensions
Boilerplate text with HTML tags Parameter fields with JavaScript Parameter Form header Parameter Form footer
Parameter Form Header and Footer
Header
Footer
Summary
In this lesson, you should have learned how to: Define and use bind and lexical parameters Create a list of values Reference system parameters Modify parameter values at run time, using:
Command line arguments Run-time parameter form
Create a run-time paper parameter form:

Build it using the Parameter Form Builder Customize it using the Report Editor, HTML
Modifying an existing report to use a bind parameter Adding a dynamic list of values Adding a lexical parameter Adding a static list of values Creating a customized parameter form
Embedding a Graph in a Report
Objectives
After completing this lesson, you should be able to do the following: Create and display a simple graph Customize a graph in a Web report Modify graph data dynamically Specify additional graph attributes using Graph.XML Use graph hyperlinks
Adding a Graph to a Paper Report
Adding a Graph to a Web Report
Adding a Graph to a Web Report
Selecting the Graph Type
Selecting the Graph Data
Adding Options to the Graph
Customizing Web Graphs

<rw:graph id="graph" src="G_DEPARTMENT_ID" groups="DEPARTMENT_ID" dataValues="SALARY" series="EMPLOYEE_ID,MANAGER_ID" width="1200" height="600" graphHyperlink="http://myhost.mycompany.com /myexamples/emp.jsp?server=rep-server& userid=hr/hr@orcl&destype=cache& desformat=htmlcss&emp_id=&EMPLOYEE_ID;">
Graph XML
</rw:graph>
The rw:graph Tag
Defines a graph Attributes:

id src groups dataValues series width height graphHyperlink
<rw:graph id="graph-id" src="group-name" groups="column-list" dataValues="list" [series="column-list"] [width="size"] [height="size"] [graphHyperlink="link"] tag body </rw:graph>
Customizing Graphs Using the Graph.XML File
Using Graph Hyperlinks
Document on same machine Any destination Any URL
Summary
In this lesson, you should have learned how to: Build a new graph by invoking the Graph Wizard to build and embed a graph in a paper report Customize a graph in a Web report using the rw:graph tag Customize graphs using the Graph.XML file Use a graph hyperlink for drilling down
Using the Graph Wizard to create a graph Altering the graph in the Graph Wizard Creating graphs that print once for each record of a group Adding a graph to a Web layout Customizing a graph in a Web report
Enhancing Matrix Reports
Objectives
After completing this lesson, you should be able to do the following: Design a matrix Data Model Design a matrix Paper Layout Modify a matrix structure Create and modify matrix summaries Create a matrix with group report Create a nested matrix report
The Matrix Data Model
The Matrix Paper Layout
Job Title Dept Name F_department_na
F_job_id Sumsalary F_Sumsalary
Creating Matrix Summaries
F_CITY
Job Title Dept Name

F_name
F_job_id Sumsalary F_Sumsalary

F_SumsalaryPerJOB_I F_SumsalaryPerDEPT
F_SumsalaryPerCITY
F_SumsalaryPer
Creating the Matrix Manually
Using the Data Wizard:

Select the Matrix query check box Step through the wizard
Entirely manual:
Select the appropriate query tool Create extra groups Create the cross product group
The Matrix with Group Data Model
The Matrix with Group Layout
Region:
F_CITY
Job Title Dept Name F_department
F_job_id Sumsalary Total: F_Sumsalary

F_SumsalaryPerTITLE F_SumsalaryPerDEPA
F_SumsalaryPerCITY
Total:
F_SumsalaryPer
Building a Nested Matrix
Nested Matrix Paper Layout
Creating Nested Matrix Summaries
F_SumSALARY
F_SumSALPerDEPA
F_Sum_CITY
F_SumSALPerJOB_
Displaying Zeros
Summary
In this lesson, you should have learned how to: Create matrix reports with the Report Wizard Describe the relationship between the data and layout in a cross product structure Identify and describe matrix-specific elements:
Cross product group Product Order property Matrix layout object
Opening and changing an existing matrix report Building a nested matrix report Adding summaries to a nested matrix report Displaying zeros for summary values and restricting columns per page Displaying more meaningful column information and rotating the text
Coding PL/SQL Triggers
Objectives
After completing this lesson, you should be able to do the following: Describe the different types of triggers Describe sample uses of triggers Write and reference common code Create a PL/SQL library Publish a report as a result of a database event
Types of Triggers in Reports
Report:
Five triggers Report Triggers node in Object Navigator
Data Model:
Formula (column) Filter (group) Parameter validation
Layout: Format trigger on most objects
Trigger Code
Boolean: true false
Character Number Date
Using Report Triggers

Before Parameter Form 1 F After Parameter Form Before Report F page1 F
If readonly=yes
If > 1 page Between Pages F page2 After Report
Using Report Triggers
After Parameter Form

Example: Build dynamic WHERE clause
FUNCTION AfterPForm RETURN BOOLEAN IS BEGIN IF :p_customer IS NULL THEN :p_where_clause := ' '; ELSE :p_where_clause := 'where id >= :p_customer'; END IF; RETURN(TRUE); END;
Query syntax
SELECT CUSTOMER_ID, CUSTOMER_NAME FROM CUSTOMERS &p_where_clause ORDER BY CUSTOMER_NAME
Using Data Model Triggers: PL/SQL Group Filter

Restrict records in a group Perform PL/SQL for each record
FUNCTION G_empGroupFilter RETURN BOOLEAN IS BEGIN IF :department_name = 'Operations' AND :salary > 5000 THEN RETURN(my_function); ELSE RETURN(TRUE); END IF; END;
PL/SQL filters result in all records being fetched
Using Data Model Triggers: Parameter Validation

Example: Do not allow report output to be sent directly to a printer.
FUNCTION DESTYPEValidTrigger RETURN BOOLEAN IS BEGIN IF :DESTYPE = 'Printer' THEN RETURN(FALSE); ELSE RETURN(TRUE); END IF; END;
You cannot reassign values to parameters or columns in this trigger.
Using Layout Triggers
Format triggers: Exist on most layout objects Can suppress an entire layout section (master group frame): No records fetched Can suppress the display of individual records (repeating frame): All records fetched
Using a Format Trigger on a Frame

Displaying a Text String in Place of Column Headings
Dept: 10 Dept: f_deptno Name Name Salary No employees in this department Dept: 40 No employees in this department 2 Salary
Using a Format Trigger on a Repeating Frame

Dynamically Altering the Display of Records
Employee Details Employee Details King f_name f_date f_salary f_name f_date King Kochhar 2 1 De Haan 3
17-JUN-87 24000
Kochhar 21-SEP-89 17000 De Haan 13-JAN-93 17000 Employee Details 17-JUN-87 21-SEP-89 13-JAN-93
Using a Format Trigger on a Field

Dynamically Hiding Fields
Employee Details f_name f_date f_salary Employee Details King 17-JUN-87 24000 1
Kochhar 21-SEP-89 17000 De Haan 13-JAN-93 17000 Employee Details King 17-JUN-87
Kochhar 21-SEP-89 De Haan 13-JAN-93
Using a Format Trigger in a Web Layout

<tbody> <rw:foreach id="R_G_DEPARTMENT_ID_1" src="G_DEPARTMENT_ID"> <tr> <td <rw:headers id="HFSALARY" src="HBSALARY"/> class="OraCellNumber"> <rw:field id="F_SALARY" src="SALARY" nullValue=" " formatMask="$999,999.00" formatTrigger="mystyles"> F_SALARY </rw:field> </td> </tr> </rw:foreach> </tbody>
Using a Format Trigger on a Boilerplate Object

Insert Spacing Between Groups of Records
f_1 f_2 1 3 FUNCTION spacing RETURN BOOLEAN IS BEGIN IF MOD(:count_column, 3) = 0 THEN RETURN(TRUE); ELSE RETURN(FALSE); END IF; END;
f_3
Writing Common Code
At the Report level: Object Navigator, Program Units Menu: Program > PL/SQL Editor In a library: Object Navigator, PL/SQL Library File > New: Create new library File > Open: Add to existing library Attach library to report
Event-Based Reporting
Implemented through PL/SQL stored procedures Uses include:

Running a report Displaying report status Canceling a report Managing parameter lists
Event-Driven Publishing API

Oracle PL/SQL Workflow Advanced Queuing
Output
Client
Data model
Data interface
Reports Services
Reports Cache
E-mail File Printer
Invoking a Report from a Database Event
Create a database trigger Include a parameter list with the required entries:
GATEWAY SERVER REPORT USERID
Summary
In this lesson, you should have learned how to: Select the appropriate trigger type for your requirement: Report, Data Model, or Layout Identify the trigger and code needed for:
Building a dynamic WHERE clause Validating a parameter value Dynamically altering record display Suppressing null fields
Use Report-level program units and create PL/SQL libraries for common code Invoke a report from a database event
Creating a format trigger to display different paper layouts conditionally Creating and using a report-level PL/SQL function Creating an using an external PL/SQL library Creating a PL/SQL group filter
Extending Functionality Using the SRW Package
Objectives
After completing this lesson, you should be able to do the following: Describe the package contents Output messages at run time Execute a drill-down report Create a simple table of contents Create and populate temporary tables Modify visual attributes dynamically
Contents of the SRW Package
SRW.SET_BOOKMARK SRW.SET_FONT_STYLE
SRW.DO_SQL SRW.RUN_REPORT
SRW.SET_MAXROW SRW.MESSAGE
SRW.TRACE_START SRW.PROGRAM_ABORT
Outputting Messages
Warning:
WHEN <exception> THEN SRW.MESSAGE (999, Warning: report continues);
Error:
WHEN <exception> THEN SRW.MESSAGE (999, Warning: report terminated); RAISE SRW.PROGRAM_ABORT;
Exceptions:
SRW.INTEGER_ERROR SRW.NULL_ARGUMENTS
Executing a Nested Report

1 KING.LIS xxx xxxxxxx xxx xxxxxxx 2
KING KOCHHAR DE HAAN
KOCHHAR.LIS yyy yyyyyyy yyy yyyyyyy
DE HAAN.LIS zzz zzzzzzz zzz zzzzzzz
SRW.RUN_REPORT
Executing a Nested Report
Example:
SRW.RUN_REPORT ('Report=EMPS DESTYPE=FILE DESNAME='||:LAST_NAME||'.LIS BATCH=YES MGRNO='||TO_CHAR(:MANAGER_ID));
Exceptions:
SRW.RUN_REPORT_FAILURE SRW.RUN_REPORT_BATCHNO
Function: SRW.GETERR_RUN
Restricting Data
Before Report trigger SRW.SET_MAXROW('Q_EMP',3);
Q_EMP EMPLOYEE_ID LAST_NAME G_EMP EMPLOYEE_ID LAST_NAME 100 101 102 KING KOCHHAR DE HAAN
Initializing Fields
Output: logical page no. = 2
Paper Layout Page: F_NEWPAGE
Page: 5
1 FUNCTION F_LOGICAL_PAGEFormatTrigger RETURN BOOLEAN IS my_page number; BEGIN SRW.GET_PAGE_NUM(my_page); SRW.SET_FIELD_NUM(0,my_page+3); RETURN(TRUE); END;
Creating a Table of Contents
Use SRW.SET_FORMAT_ORDER in an After Parameter Form trigger to format the Main section of the report first Use SRW.GET_PAGE_NUM in a format trigger to fetch the page number for each topic in the TOC
Performing DDL Statements
Example:
SRW.DO_SQL('CREATE TABLE SRW_LOG (RPT_NAME VARCHAR2(40), REC_NUM NUMBER, MSG_TEXT VARCHAR2(80))' ); SRW.DO_SQL('INSERT INTO SRW_LOG (RPT_NAME, REC_NUM, MSG_TEXT) VALUES (''PAY_REPORT'', TO_CHAR(:EMPLOYEE_ID), :LAST_NAME||''PAY REPORT RUN'') ');
Exception: SRW.DO_SQL_FAILURE
Setting Format Attributes
Tuesday, January 2004
Borderwidth Fill pattern Format mask
Printer tray control
Car Policy
Define a bookmark
Setting Format Attributes
Visual attributes: SRW.SET_FILL_PATTERN('solid'); SRW.SET_BORDER_WIDTH(250); SRW.SET_FORMAT_MASK('Day, Month yyyy'); Printer tray control: SRW.SET_PRINTER_TRAY('letterhead'); Defining a bookmark: SRW.SET_BOOKMARK('Car Policy');
Using Format Attributes in a Web Layout

<rw:field id="F_SALARY" src="SALARY. . . formatTrigger="mystyles"> F_SALARY </rw:field>
FUNCTION mystyles RETURN BOOLEAN IS BEGIN SRW.SET_JUSTIFICATION(SRW.RIGHT_HJUST); SRW.SET_TEXT_COLOR('Red'); SRW.SET_FONT_WEIGHT(SRW.BOLD_WEIGHT); SRW.SET_FONT_STYLE(SRW.ITALIC_STYLE); return (TRUE); END;
Summary
In this lesson, you should have learned how to: Describe the SRW package contents:
Procedures Functions Exceptions
Use SRW.PROGRAM_ABORT to stop report processing Use the SRW package to:
Execute a detail report Create a table of contents Dynamically execute DDL statements Provide conditional layout formatting and display
Building a report containing conditional highlighting Modifying a Web report with conditional highlighting Executing a detail report from a master report Writing to a temporary table from a report
Maximizing Performance Using OracleAS Reports Services
Objectives
After completing this lesson, you should be able to do the following: Describe the OracleAS Reports Services architecture Distinguish between the JSP and Servlet run-time architectures Describe the various ways to run a report List the options for managing and monitoring OracleAS Reports Services
Running Reports Using OracleAS Reports Services

Provides the deployment platform Formats, prints reports on a powerful server Eliminates rerunning reports Enhances scalability and performance
Report Request Methods
RWCLIENT command line URL syntax OracleAS Portal SRW.RUN_REPORT Event-Driven Publishing API
Oracle Application Server Components

Web Services
System Management
Security and Identity
Enterprise Portal
Application Development Framework Business Intelligence Application server Grid Computing Infrastructure Integration Broker Management
Portal
Any Data Source
Mobile and Wireless
Packaged Application
Oracle Application Server 10g

Business Intelligence B2B
Enabling Single Sign-On Access

Oracle Internet Directory
Log in only once Access application level authentication Access data level authentication
Running the Web Layout: JSP Run-time Architecture
HTTP Oracle HTTP Listener mod_OC4J JSP Engine CORBA/IIOP OracleAS Reports Services CORBA/IIOP Reports Engine PDS
rept.jsp OID
Running the Paper Layout: Servlet Run-time Architecture

HTTP Oracle HTTP Listener mod_OC4J Reports Servlet OID CORBA/IIOP OracleAS Reports Services CORBA/IIOP rept.rdf rept.jsp Reports Engine PDS
Fax
t rin P
ma il
Running a Paper Report on the Web
URL syntax:
http://vesuvius.world.com:8888/reports/rwservlet? report=emp_dept.rdf&desformat=html&destype=cache& server=repsrv1&dept_param=10
Key map file: cgicmd.dat
Running a Report from the Command Line
SERVER = <server_name> MODULE|REPORT = <runfile> DESTYPE = FILE, PRINTER, MAIL, CACHE, LOCALFILE, SYSOUT,ORACLEPORTAL DESNAME = <desname> DESFORMAT = PDF, HTML, HTMLCSS, RTF, DELIMITED, XML
RWCLIENT SERVER=server1 MODULE=my_rep.rdf DESTYPE=cache DESFORMAT=html
The OUTPUTIMAGEFORMAT Parameter
Commands that can use OUTPUTIMAGEFORMAT:
rwclient
rwrun rwbuilder rwservlet rwcgi
Syntax:
OUTPUTIMAGEFORMAT={PNG|JPEG|JPG|GIF|BMP}
The Schedule Parameter
SCHEDULE = [FREQ from] TIME [retry n after LEN]

RWCLIENT... SCHEDULE=monthly_last_weekday_from_17:00_Nov_22,_2003_ retry_3_after_1_hour
FREQ
CLOCK
DATE
TIME
Reports Caching
Cached reports on server: Tolerance = n (minutes) Tolerance = 0 (default/current behavior) Maximum tolerance is 232 minutes (approximately 10,000 years) Cached output controlled by a CACHEDIR server parameter
Using Oracle Enterprise Manager
Managing and Monitoring OracleAS Reports Services

Start, stop, and restart a Reports server View and manage:
Current Jobs queue Scheduled Jobs queue Finished Jobs queue
Monitor server performance Edit server configuration
What Is the Queue Manager?
Real-time Reports Server status: View report status and scheduled jobs Refresh to see the up-to-date status Reprioritize or cancel jobs
Administrator password encrypted in .conf file
Queue Manager
Past jobs Current jobs Scheduled jobs
Queue Manager
All my jobs All jobs Refresh
Using the Queue Manager

RSVR1 Queue Manager RSVR2
Connect to any number of servers Administrator can shut down server Reports Services restores scheduled jobs after shutdown
Summary
In this lesson, you should have learned how to: Describe the JSP and servlet run-time architectures List several ways to run a report Describe the features of Oracle Enterprise Manager and Queue Manager for monitoring Reports Services
Constructing a URL to run a report on the Web Creating an entry in the key map file
Building Reports: Efficiency Guidelines
Objectives
After completing this lesson, you should be able to do the following: Describe performance areas Use performance measuring tools Build reports to run in other languages
Tuning Reports
No absolute rules Investigate specific areas:

Data Model Paper Layout Web Layout and JSP report definitions Run-time arguments
Performance Measurement
Measurement tool: Trace option Server and network measurements: SQL Trace Traffic and bandwidth
Non SQL Data Sources
Investigating the Data Model
Schema design Indexes Efficient SQL Efficient PL/SQL Calculations
Redundant queries Break groups Group filters Linking queries
Investigating the Paper Layout
Frames Object size Format triggers Fetching ahead Bursting and distribution
Running the Report
RUNDEBUG=NO Array processing LONGCHUNK PARAMFORM Batch processing
Different Development and Run-Time Environments

Reports Builder development
Bitmapped only
Reports Builder Runtime

Bitmapped MODE = bitmap Character mode MODE = character
Developing Reports to Run in Different GUIs

Use common fonts or map fonts in uifont.ali Use common colors Be aware of dots per inch (DPI)
Setting NLS Language Environment Variables

NLS_LANG DEVELOPER_NLS_LANG, USER_NLS_LANG
NLS_LANG=French_France.WE8DEC
Unicode:
NLS_LANG=<lang>_<territory>.UTF8
Translating an Oracle Reports Application
Use TranslationHub to translate messages and text defined as part of the application. Consider: Format masks Hard-coded strings Multiple character sets
Summary
In this lesson, you should have learned how to: Use performance measuring tools Describe the facilities for running reports in other languages
Identifying areas to investigate for tuning reports Using the trace facility Interpreting time statistics Improving performance

Oracle Report Builder 10g

Încărcat de

Informații document

Descriere originală:

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Oracle Report Builder 10g

Încărcat de

Drepturi de autor:

Formate disponibile

Oracle Reports Developer 10g: Build Reports

D17075GC10 Production 1.0 June 2004 D39524

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Introduction to Oracle Reports Developer

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Advanced analysis Data Server Application Server

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Oracle Reports Developer

JDBC OLAP XML TEXT <Your Data Source>

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Oracle 10g Products

Copyright 2004, Oracle. All rights reserved.

Oracle Database 10g

Oracle Database 10g manages all of your data:

Copyright 2004, Oracle. All rights reserved.

Oracle Developer Suite 10g

Copyright 2004, Oracle. All rights reserved.

Oracle Developer Suite 10g

Copyright 2004, Oracle. All rights reserved.

Oracle Application Server 10g

Copyright 2004, Oracle. All rights reserved.

Oracle Reports Developer

Copyright 2004, Oracle. All rights reserved.

OracleAS Reports Services

Flexible reporting Reduced overhead Fast distribution Real time publishing

Copyright 2004, Oracle. All rights reserved.

OracleAS Reports Services Architecture for the Web

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Designing and Running Reports

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Understanding User Requirements

What data Parameters

Web features Security

Charts Drill down

Copyright 2004, Oracle. All rights reserved.

Before you start development, consider:

Style Publishing Medium

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Customer Name Product Number Price

Copyright 2004, Oracle. All rights reserved.

Master with Two Details

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Retrieving and Sharing Data

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Copyright 2004, Oracle. All rights reserved.

Supported File Types

RDF REP JSP HTML XML