Sie sind auf Seite 1von 32

[Delete from Title Master]

Set correct lesson


number in the Title
Master.
Oracle9iAS Reports Services:
Deploy Internet Reports

Version: OU5_1.ppt
Released: 06_JULY_01

Copyright © Oracle Corporation, 2001. All rights reserved.

Oracle9iAS Reports Services: Deploy Internet Reports.

<Course name> <Lesson number>-1


[Delete from Slide Master]
Objectives

After completing this eClass you should be able to do


the following:
• Configure Oracle9iAS Reports Services for optimum
performance
• Manage Oracle9iAS Reports Services with Oracle
Enterprise Manager
• Enable Oracle9iAS Reports Services Security with
Oracle9iAS Portal
• Deploy reports using Oracle9iAS Reports Services

1-2 Copyright © Oracle Corporation, 2001. All rights reserved.

After this eClass you should be able to configure Oracle9iAS Reports


Services to achieve optimum performance, use Oracle Enterprise Manager
to manage and configure Oracle9iAS Reports Services, use the Oracle9iAS
Portal interface to administer Oracle9iAS Reports Services Security, and
finally you learn how to deploy and run reports using Oracle9iAS Reports
Services.

Let’s move to Topic 1.

<Course name> <Lesson number>-2


[Delete from Slide Master]
Configuring Oracle9iAS Reports Services

• Introducing Oracle9iAS Reports Services


Architecture
• Configuring Oracle9iAS Reports Services Server
• Configuring Oracle9iAS Reports Services Servlet

1-3 Copyright © Oracle Corporation, 2001. All rights reserved.

This topic discusses the Oracle9iAS Reports Services Architecture,


followed by configuring an Oracle9iAS Reports Services Server, and the
Oracle9iAS Reports Services Servlet. Let us begin by looking at the
Oracle9iAS Reports Services Architecture.

<Course name> <Lesson number>-3


[Delete from Slide Master]
JSP Runtime Architecture

HTTP

Oracle HTTP Listener


mod_OC4J
JSP Engine

CORBA/IIOP CORBA/IIOP

Login Oracle9iAS Reports


Server Engine
Reports Services
PDS

OID Oracle9iAS
Portal

1-4 Copyright © Oracle Corporation, 2001. All rights reserved.

<Course name> <Lesson number>-4


[Delete from Slide Master]
Servlet Runtime Architecture
HTTP

Oracle HTTP Listener


mod_OC4J
Reports Servlet Fax t
in
Pr
CORBA/IIOP
ma
il
Oracle9iAS Reports Services
Login
Server
CORBA/IIOP

Oracle9iAS Reports Persistent


Portal Engine Reports
OID Cache
PDS

1-5 Copyright © Oracle Corporation, 2001. All rights reserved.

<Course name> <Lesson number>-5


[Delete from Slide Master]
Configuring Oracle9iAS Reports Server

• Configuring the Oracle9iAS Reports Services Server


instance
– ORACLE_HOME\reports\conf\<server_name>.conf
– ORACLE_HOME\reports\dtd\rwserverconf.dtd
• Configuring the Server instance in Reports Builder
– ORACLE_HOME\reports\conf\rwbuilder.conf
– ORACLE_HOME\reports\dtd\rwserverconf.dtd

1-6 Copyright © Oracle Corporation, 2001. All rights reserved.

All reports are run via the Reports Server. The Oracle9iAS Reports Servers
need to be configured. The Reports Builder too includes a built-in Reports
Server and needs to be configured. The slide shows you the path and
name of both Reports Servers. The configuration file for the Oracle9iAS
Reports Services server is server_name.conf and for the builder it is
rwbuilder.conf. The DTD file for both is rwserverconf.dtd - so the XML
configuration files must adhere to the rules defined in this DTD file.

<Course name> <Lesson number>-6


[Delete from Slide Master]
Configuring the Reports Server

<server>
<compatible version="6i"/>

<persistFile filename="your_filename.dat"/>

</server>

tnsnames.ora
rep9isvr.world = (ADDRESS=
(PROTOCOL=tcp)
(HOST=host.company.com)
(PORT=1949)
)

1-7 Copyright © Oracle Corporation, 2001. All rights reserved.

Every Reports Server configuration file i.e. the Reports Server in


Oracle9iAS Reports Services and that in the Reports Builder, has as its root
the <server> element. The Oracle9iAS Reports Services Servers alone have
the compatible element. The compatible element is available for backward
compatibility with Reports 6i clients. When compatible is set to 6i, the
Reports Server will make use of the executable file, named rwproxy, that
listens for requests from a 6i client and forwards them to a 9i server. If you
use the compatible element, you must also have an entry for the Reports
Server in your tnsnames.ora file.

The persistFile element identifies the file that records all job status
information. If you do not specify a file, the server will create one of its
own. You can have only one persistFile per server. The persistFile is
persistent so the file remains intact even when the server is restarted. The
persistFile is a binary file, and therefore can only be used by Oracle9iAS
Reports Services. The showjobs command line option uses the persistFile
to display job information.

<Course name> <Lesson number>-7


[Delete from Slide Master]
Configuring the Reports Server

<server>

<cache class="oracle.reports.cache.RWCache">
<property name="cacheSize" value="50"/> Megabytes
<property name="cacheDir" value="your cache directory"/>
</cache>

</server>

1-8 Copyright © Oracle Corporation, 2001. All rights reserved.

The cache element specifies the Java class that defines the server’s cache
implementation. You can have as many property name/value pairs as
needed by your cache implementation class. The default cache Java class
settings looks as you see on the slide. The cache size is specified in
Megabytes. Cache directory specifies the location of the cache. You enter
a standard directory path for this value.

<Course name> <Lesson number>-8


[Delete from Slide Master]
Configuring the Reports Server

<security id="rwSec"
class="oracle.reports.server.RWSecurity">
<property name="securityUserid"
value="portal_id/portal_password@portal_schema"
confidential="yes" encrypted="no"/>
</security>

<destination destype="oraclePortal"
class="oracle.reports.server.DesOraclePortal">
<property name="portalUserid"
value="portal_id/portal_password@portal_schema"
confidential="yes" encrypted="no"/>
</destination>

1-9 Copyright © Oracle Corporation, 2001. All rights reserved.

The security element specifies the Java class that controls server access.
The default security class provided with Oracle9iAS Reports Services relies
on using the Oracle9iAS Portal interface to administer Reports Services
security. During the initial setup you specify the username, password and
portal_schema name for the securityUserid property. Confidential is set to
yes and encrypted is set to no. Since confidential was set to yes - when
the Reports Server is started, the value for securityUserID in the
configuration file is encrypted and the encrypted property will be changed
to yes. This prevents anyone from seeing the username, password, and
portal schema values after the server is restarted.

Destinations are also setup using the server configuration file. There is no
need to register default destinations other than Oracle9iAS Portal. You
need to enter the Oracle9iAS Portal userid, password, and schema
information in a destination element in the configuration file. Again this
information is encrypted following the Reports Server startup since
confidential is set to yes. The encrypted attribute will be changed to yes
following encryption.
<Course name> <Lesson number>-9
[Delete from Slide Master]
Configuring the Reports Server

<engine id="rwEng" class="oracle.reports.engine.EngineImpl"


initEngine="1" maxEngine="1" minEngine="0" engLife="50"
maxIdle="30" callbackTimeOut="60000"> … </engine>

<engine id="rwURLEng"
class="oracle.reports.urlengine.URLEngineImpl"
initEngine="1" maxEngine="1" minEngine="0" engLife="50"
maxIdle="30" callbackTimeOut="60000"/>

<job jobType="report" engineId="rwEng" securityId="rwSec"/>


<job jobType="rwurl" engineId="rwURLEng"
securityId="rwSec"/>

1-10 Copyright © Oracle Corporation, 2001. All rights reserved.

You must have at least one engine element in your configuration file. The
engine attribute specifies the Java class that implements the engine. The
default implementation settings are shown on the slide. The initEngine
attribute specifies the number of engines that are started at initialization.
The maxEngine attribute specifies the maximum number of engines of this
type that can run on the server. The minEngine attribute specifies the
minimum number of this type of engine that should be active on the server.
The engLife attribute specifies the number of jobs the engine can run
before the engine is terminated. The maxIdle attribute specifies the number
of minutes of allowable idle time before the engine is shut down, provided
the current number of engines is higher than minEngine. The
callbackTimeOut specifies the number of mSec of allowable waiting time
between when the server calls the engine and the engine calls the server
back.

The first engine on the slide is the engine to run reports. The second
engine is the URL engine. The job elements indicate the functionality of
each engine. The first job element specifies that the rwEng is for the
purpose of running reports. The second job element specifies that the
<Course name> <Lesson number>-10
rwURLEng is for the purpose of running rwurl or URL Engine jobs.
[Delete from Slide Master]
Configuring the Reports Server

<jobStatusRepository
class="oracle.reports.server.JobRepositoryDB">
<property name="repositoryConn"
value="scott/tiger@orcl" confidential="yes"
encrypted="no"/>
</jobStatusRepository>

<pluginParam
name="mailServer">your_mail_server.company.com
</pluginParam>

<trace traceFile="your_file.trc" traceOpts="trace_all"
traceMode="trace_append"/>

1-11 Copyright © Oracle Corporation, 2001. All rights reserved.

The jobStatusRepository element specifies the Java class that implements


a job status repository. This job status repository is stored in a table in the
database. The job status repository is persistent, so each job is appended
to the table. The username, password and schema are encrypted when the
Reports Server is restarted since the confidential is set to yes. Following
encryption the encrypted attribute will be set to yes.

The pluginParam element is used for pluggable components of Oracle9iAS


Reports Services. The slide shows you the plugin parameter used to
include your mail server. Substitute your outgoing SMTP mail server for
your_mail_server.company.com on the slide.

The trace element is used to create a file for tracing your report’s execution
and to specify the objects and activities you want to trace. Trace-all for
traceOpts, logs all possible server and engine information in a trace file.
The trace_append for traceMode will append the trace information to the
end of the existing trace file.
<Course name> <Lesson number>-11
[Delete from Slide Master]
Configuring the Reports Servlet

ORACLE_HOME\reports\conf\rwservlet.properties
CGINODIAG=YES
TRACEOPTS=TRACE_ALL
SERVER_IN_PROCESS=yes
SERVER=<reports_server_name>
IMAGEURL=http://<web_server>:<port>/servlet/rwservlet
RELOAD_KEYMAP=NO

1-12 Copyright © Oracle Corporation, 2001. All rights reserved.

Configuring the Reports Servlet is done in the rwservlet.properties file. Let


us take a look at a typical rwservlet.properties file. The CGINODIAG
parameter equals YES is used to ensure that command line information is
not included with the error message. Trace options are set using the
TRACEOPTS parameter - TRACE_ALL logs all possible runtime information
on the Reports Servlet and JSPs in the trace file. To run the Reports Server
in the same process as the Reports Servlet set SERVER_IN_PROCESS to
YES. You can specify the default Reports Server using the SERVER
parameter. If the Reports Server is a member of a server cluster, use the
cluster name.
The IMAGEURL parameter specifies the reports servlet information which
is used to retrieve dynamically generated images such as charts.
The RELOAD_KEYMAP parameter is used to specify whether to reload the
key map file (cgicmd.dat) for each report request. This may be useful if you
update your key map file often. However, the runtime performance will be
affected if the key map file is reloaded for every request.

<Course name> <Lesson number>-12


[Delete from Slide Master]
Managing Oracle9iAS Reports Services

• Maintaining Oracle9iAS Reports Services


• Accessing Oracle9iAS Reports Services Security
• Optimizing Oracle9iAS Reports Services
Performance

1-13 Copyright © Oracle Corporation, 2001. All rights reserved.

This topic discusses managing Oracle9iAS Reports Services. You learn


how to monitor, configure and optimize Oracle9iAS Reports Services. You
also learn how to use Oracle9iAS Reports Services security to secure your
reports and connection strings. Let us look at maintaining Oracle9iAS
Reports Services.

<Course name> <Lesson number>-13


[Delete from Slide Master]
Maintaining Oracle9iAS Reports Services

Oracle showjobs Job Status


Enterprise Repository
Manager
(OEM)
Job queue x x x
View cached output x x
Delete current job x x
Re-run Report x
Configuration x
Administration x
Performance x

1-14 Copyright © Oracle Corporation, 2001. All rights reserved.

You have several tools to maintain Oracle9iAS Reports Services. You can
use Oracle Enterprise Manager also called OEM, the showjobs command
line option and the Job Status Repository.
OEM provides the following benefits
1. Control the server (start, stop and restart)
2. Monitor server activity
a) server metrics such as CPU load, memory usage, and average
response time
b) queue information
c) trace information
3. Edit server configuration
With the showjobs command line option, you can look at job queue
information and view cached output. You can also delete current jobs.
With the Job Status Repository, you can query job queue information since
the information is stored in a database table.
<Course name> <Lesson number>-14
[Delete from Slide Master]
Integrating Reports Server with OEM

<targets> targets.xml
<target type="oracle_repserv" name="your_repsvr">
<property name="password" value="tiger"
encrypted="true"/>
<property name="host" value="host.company.com"/>
<property name="server" value="your_repsvr"/>
<property name="servlet" value="http://host.company.com
/servlet/rwservlet"/>
<property name="userName" value="scott"/>
<property name="oracleHome" value="ORACLE_HOME"/>
<compositeMembership>
<memberOf type="oracle_ias" name="IAS-1"/>
</compositeMembership>
</target>

</targets>

1-15 Copyright © Oracle Corporation, 2001. All rights reserved.

In order for you to manage a Reports Server using OEM, you need to
include the information in the targets.xml file. The slide shows you an
example. The target type for a Reports Server is oracle_repserv. You
include the Reports Server name in the name attribute. You will need to
include the reports servlet information and the reports host machine
information. You will also need to include the username and password
information for the Reports Server. For a secure server, this is the
username and password you entered in the security element in the
<server_name>.conf file. This is used for comparing usernames and
passwords between OEM and the Reports Server when shutting down the
Reports Server via OEM. The password will be encrypted after you restart
OEM.

<Course name> <Lesson number>-15


[Delete from Slide Master]
Viewing Job Information

Showjobs command line option


http://host.company.com/servlet/rwservlet/showjobs?
server=your_repsvr
&statusformat= [ html | xml | xmldtd ]

• Job id
• Job type
• Job name
• Job status - click to view output or delete job
• Job owner
• Output type, and output name
• Server name
• When queued, started, and finished

1-16 Copyright © Oracle Corporation, 2001. All rights reserved.

The showjobs command line option provides you job queue information.
You need to specify the Reports Server you want query. The information
that can be obtained with this command is shown on the slide. After you
run the showjobs command line in the URL - you can view the cached
output of a completed job by clicking on the job status column of a
completed job. You can delete a job that is running by clicking on the job
status column of a job that is currently running. The default statusformat
for showjobs is html. You can also get an XML and XML with the inline
DTD using the xml and xmldtd statusformat options respectively.

<Course name> <Lesson number>-16


[Delete from Slide Master]
Viewing Job Information

Job Status Repository


select * from RW_SERVER_QUEUE;
• Job id, Job type, and Job name
• Status code, and status message
• Command line
• Owner
• Destype, and Desname
• Server
• When queued, started, and finished
• Last run, and next run
• Repeat interval, and repeat pattern
• Cache hit, and cache key

1-17 Copyright © Oracle Corporation, 2001. All rights reserved.

The job status repository is stored in the rw_server_queue database table.


This table is created by running the rw_server.sql script in the
ORACLE_HOME\reports\sql directory. The database table is updated each
time a job request is submitted. The job status repository answers
questions such as the status of a report that has been submitted, how
many concurrent users there are on the Reports Server. The job type
indicates whether the job listed is current, past or scheduled. Since this is
in a table, you can use this as a data source to create your own reports on
Reports Server utilization.

<Course name> <Lesson number>-17


[Delete from Slide Master]
Accessing Oracle9iAS Reports Services
Security
<server_name>.conf Register Register
<security id="rwSec" Reports Reports
class="oracle.reports.server.RWSecurity"> Servers
<property name="securityUserid"
value=“scott/tiger@orcl" Register Availability
confidential="yes" Printers Calendars
encrypted=“no” /></security>

scott/tiger@orcl
Oracle
Login Access Control Information
Server
Oracle9iAS
OID Reports Server Portal Repository

1-18 Copyright © Oracle Corporation, 2001. All rights reserved.

Oracle9iAS Reports Services security is accessed via the Oracle9iAS Portal


interface. Oracle9iAS Reports Services security is turned on when the
security element is configured in the server_name.conf file. This specifies
the Portal securityUserid and schema that is used to maintain the security
information within Oracle9iAS Portal. The Oracle9iAS Reports Services
Security page shown within Oracle9iAS Portal provides you an interface to
register Reports Servers, Reports, Printers and Availability Calendars.
This Application Security information is stored within the Oracle9iAS Portal
Repository. The connection strings to access data sources are stored in
the Oracle Internet Directory, also called OID.

When a report is to be executed the Reports server checks application


security, that is if this user is allowed to run this report at this time on this
server and print to this printer etc, against the Oracle9iAS Portal
Repository. If it is permissible, the Reports Server gets the connection
strings to the various data sources for this user from the OID.

<Course name> <Lesson number>-18


[Delete from Slide Master]
Optimizing Oracle9iAS Reports Services
Server Performance

Reports Servlet
Reports Servlet CORBA / IIOP
Reports Server Reports Server

In-Process Stand-Alone
Server Server
Setting Server_In_Process=yes Server_In_Process=no
(rwservlet.properties) (rwservlet.properties)
Location Reports Servlet Independent
Starting Up Automatic with job Must be started
Performance Faster Slower
Cluster No Yes

1-19 Copyright © Oracle Corporation, 2001. All rights reserved.

Optimizing Oracle9iAS Reports Services Server performance. The Reports


Server can be in the same process as the Reports Servlet or communicate
with each other using CORBA invocations. With in-process server support,
the servlet and the server are in the same process. The communication
between the two takes place with normal Java function calls. This makes
the in-process server much faster than the stand-alone server. In addition
the In-process server starts automatically when a job is received. The
stand-alone server must be started before jobs can be submitted. The in-
process server cannot be a member of a cluster but the stand-alone server
can be.

To choose the in-process server setting, set Server_In_Process=yes in the


rwservlet.properties file. For stand-alone server set Server_In_Process=no.

<Course name> <Lesson number>-19


[Delete from Slide Master]
Tuning the Reports Engine

Parameter Default Higher Value Lower Value


initEngine 1 High constant load Low loads with
occasional peaks
maxEngine 1 High constant load Low loads
- max #CPUx4
minEngine 0 High constant load Low loads
engLife 50 High constant load Low loads
(jobs)
maxIdle 30 Not necessary Not necessary
(mins)
callBackTimeOut 60000 Server host Server host
(mS) machine slow machine fast

1-20 Copyright © Oracle Corporation, 2001. All rights reserved.

Tuning the Reports Engine. Here are some points to remember - Report
engines take memory, it takes time to start an engine, the more an engine is
reused it can lead to memory leaks and faster the machine the faster the
communication between the Reports Server and the engine.
Bearing these in mind, the more engines that are up and running the faster
the response time but it uses more memory. The choice depends on the
load, for a high constant load you would need more engines running. For
low loads with occassional peaks, you can have fewer engines running.
For high constant loads it is better to have the maxEngine and minEngine
close together to prevent engines from starting up and shutting down in
high volume situations.

<Course name> <Lesson number>-20


[Delete from Slide Master]
Improving Performance using Peer-Level
Clustering

• Caches report output locally


• Shares report output among cluster members
• Distributes job requests equally among members
• Has no single-point-of-failure
java oracle.report.utility.KeyManager <public_key_file_name>
<private_key_file_name>

<server_name>.<cluster_name>.conf
<connection …>
<cluster
publicKeyFile="ORACLE_HOME\reports\server\yourpubkey"
privateKeyFile="ORACLE_HOME\reports\server\yourprikey"/>
</connection>

1-21 Copyright © Oracle Corporation, 2001. All rights reserved.

You can improve performance by using Peer-Level clustering. Peer-Level


clustering caches the report output on each server but shares the output
among cluster members. Jobs are distributed equally among all members
of the cluster and has no single-point-of-failure.

To setup a peer-level cluster, you need to create a new public key and a
private key. You use the command shown on the screen to create these
keys. Each server in the cluster must have the same public and private
keys in the server configuration file. The reports servers are then restarted
after the configuration files have been changed.

<Course name> <Lesson number>-21


[Delete from Slide Master]
Optimizing Cache Access
<cache class="oracle.reports.cache.RWCache">
<property name="cacheSize" value="50"/>
<property name="cacheDir" value="your cache directory"/>
</cache>

• Using the cacheSize value


– Large cache sizes may slow searches
• Using the tolerance command line parameter
– Balance the need for current information versus time
to rerun report
• Using the expiration command line parameter
– Balance the need for current information, cache file
space, and time to rerun report

1-22 Copyright © Oracle Corporation, 2001. All rights reserved.

Optimizing cache access. The cache element in the server configuration


file specifies the cache settings. The default cache size is 50MB. Larger
cache sizes will take longer to search the cache but too small a value will
not allow you to store much in the cache.

You can use expiration and tolerance with rwclient, rwservlet and rwcgi.

Use tolerance to set the maximum acceptable time for reusing a report’s
cached output when a duplicate job is detected. Setting the time tolerance
on a report reduces the processing time when duplicate jobs are found.
However, you need to balance the need for current information versus the
time to rerun the report. If tolerance is not specified, then Oracle9iAS
Reports Services reruns the report even if a duplicate report is found in
cache.

Use expiration to define how long the report output can exist in cache
before it is deleted. Again here, you will need to balance the need for
<Course name> <Lesson number>-22
current information, cache file space, and time to rerun the report. If
expiration is not specified then Oracle9iAS Reports Services rer ns the
[Delete from Slide Master]
Running Reports using Oracle9iAS
Reports Services

• Accessing Oracle Internet Directory for


authentication
• Deploying reports using Oracle9iAS Reports
Services
• Enabling Key Mapping

1-23 Copyright © Oracle Corporation, 2001. All rights reserved.

This topic discusses running reports using Oracle9iAS Reports Services.


We discuss using OID for authentication, deploying reports with
Oracle9iAS Reports Services and using Key Mapping.

<Course name> <Lesson number>-23


[Delete from Slide Master]
Accessing Oracle Internet Directory for
authentication

1. Enter users into the OID


a. Manually
b. Batch upload with OID tool
2. Enter data source connection strings for each user
a. Give users access to the Oracle Delegated
Administration Service (DAS) tool of OID
b. Give each user the URL which includes the ssoconn
command line parameters

1-24 Copyright © Oracle Corporation, 2001. All rights reserved.

Now that pluggable data sources have been introduced with Oracle9iAS
Reports Services, the need for Single-Sign-On authentication to all data
sources must be satisfied. This is done with OID. Before the OID can be
used, users need be entered. This can be done manually or if you have
some other LDAP compliant directory you can use an OID tool to populate
the directory.

Entering data source connection strings can be done either by providing


users access to the Oracle Delegated Administration Service (DAS) tool of
OID or thru a dummy URL with the ssocon command line parameter setup
by the OID administrator for each user. With the ssocon parameter users
login to the data sources the first time and that information is recorded in
the OID for subsequent access.

<Course name> <Lesson number>-24


[Delete from Slide Master]
Deploying Reports using Oracle9iAS
Reports Services

• JavaServer Page (JSP)


– Must be in a directory accessible by the Web Server
• Servlet
– Must be in the REPORTS_PATH
• CGI
– Must be in the REPORTS_PATH

1-25 Copyright © Oracle Corporation, 2001. All rights reserved.

Deploying reports using Oracle9iAS Reports Services. JSPs must be


placed in a subdirectory of the web server root. Servlets must be
accessible in the REPORTS_PATH. To run a report using CGI it must be in
the REPORTS_PATH. .

<Course name> <Lesson number>-25


[Delete from Slide Master]
Submitting a Report Request to
Oracle9iAS Reports Services

Use one of the following to submit a report:


• Rwclient command line

rwclient report=paperwl.rdf userid=hr/hr@orcl


server=repsvr destype=file desformat=pdf
desname=client.pdf

• URL (servlet, JSP, or CGI)


• Oracle9iAS Portal
• PL/SQL API - SRW.RUN_REPORT

1-26 Copyright © Oracle Corporation, 2001. All rights reserved.

Submitting a report request to Oracle9iAS Reports Services. You can use


the rwclient command line option as shown on the slide. Rwclient
interfaces with the Reports Server directly. You can use a URL as shown
earlier. You can use Oracle9iAS Portal to run a report using Oracle9iAS
Reports Services. You can also use the SRW.RUN_REPORT API to submit
a report to Oracle9iAS Reports Services.

<Course name> <Lesson number>-26


[Delete from Slide Master]
Running a Report via the Reports Servlet
• Using the complete URL
http://host.company.com:port/servlet/rwservlet?
server=your_repsvr&report= report_name.rdf&
userid=hr/hr@orcl&destype=cache&
desformat=htmlcss&paramform=yes

Report Parameters
Enter values for the parameters
P Lastname

• Using a key in the key map file to provide default


report parameters
http://host.company.com:port/servlet/rwservlet?my_key

Put my_key information in cgicmd.dat

1-27 Copyright © Oracle Corporation, 2001. All rights reserved.

Running a report via the Reports Servlet. You can specify the complete
URL as shown on the slide. You can also use a key and specify the
parameters for the key in the cgicmd.dat file. The Reports servlet runs
paper reports only.

<Course name> <Lesson number>-27


[Delete from Slide Master]
Running a JSP-based Report

• Using the complete URL


http://host.company.com:port/examples/report_name.jsp?
server=your_repsvr&userid=hr/hr@orcl

• Using the parameters attribute of the report tag to


provide default report parameters
http://host.company.com:port/examples/report_name.jsp

<rw:report id="report"
parameters="server=your_repsvr&userid=hr/hr@orcl">

</rw:report>

1-28 Copyright © Oracle Corporation, 2001. All rights reserved.

Running a JSP report. You can use the URL as shown on the slide to run a
JSP report. You can also use the parameters attribute of the rw:report tag
to specify default parameters. You can also use a key mapping with the
key parameters specified in the cgicmd.dat file.

<Course name> <Lesson number>-28


[Delete from Slide Master]
Advantages of Key Mapping

• Shortening the URL


• Changing runtime commands without affecting URL
• Standardizing typical run configurations
• Hiding sensitive information such as passwords
• Restricting the parameters that can be used

1-29 Copyright © Oracle Corporation, 2001. All rights reserved.

Key mapping provides many advantages - it shortens the URL, you can
change runtime commands without affecting the URL, you can standardize
on typical runtime configurations within a company, you can hide sensitive
information such as usernames and passwords. You can also restrict the
parameters that can be used.

<Course name> <Lesson number>-29


[Delete from Slide Master]
Enabling Key Mapping

• Specify file with REPORTS_CGIMAP environment


variable or use CGICMD.DAT in
ORACLE_HOME\reports\conf
; JSPs
BarcodeWeb: server=repsvr userid=hr/hr@orcl
ParmformJSP: server=repsvr userid=hr/hr@orcl
ChartHyperlink: server=repsvr userid=hr/hr@orcl

;PaperReports
XMLdata: server= repsvr userid= hr/hr@orcl report=Inventory.rdf
destype=cache desformat=PDF
P_FileLocation="FILE://D|/examples/XML_PDS/scripts/"

1-30 Copyright © Oracle Corporation, 2001. All rights reserved.

Enabling Key Mapping. If you do not specify a file using the


REPORTS_CGIMAP environment variable, the cgicmd.dat file in
ORACLE_HOME\reports\conf is used by default.

Some key mappings in a cgicmd.dat file are shown on the slide.

<Course name> <Lesson number>-30


[Delete from Slide Master]
Using Key Mapping

• With servlet-based reports


– Use http://…/rwservlet?keyname
– Must be the first value in the query string
• With JSP-based reports
– Use http://…/myreport.jsp?cmdkey=keyname
– Can be anywhere within the query string
– Can also be used with servlet-based reports

1-31 Copyright © Oracle Corporation, 2001. All rights reserved.

Key mapping provides many advantages - it shortens the URL, you can
change runtime commands without affecting the URL, you can standardize
on typical runtime configurations within a company, you can hide sensitive
information such as usernames and passwords. You can also restrict the
parameters that can be used.

<Course name> <Lesson number>-31


[Delete from Slide Master]
Summary

In this course, you should have learned to:


• Configure Oracle9iAS Reports Services
• Manage Oracle9iAS Reports Services
• Enable Oracle9iAS Reports Services Security
• Tune Oracle9iAS Reports Services for optimum
performance
• Deploy reports using Oracle9iAS Reports Services

1-32 Copyright © Oracle Corporation, 2001. All rights reserved.

<Course name> <Lesson number>-32

Das könnte Ihnen auch gefallen