01.02.2013 Views

Publishing Reports to the Web - Downloads - Oracle

Publishing Reports to the Web - Downloads - Oracle

Publishing Reports to the Web - Downloads - Oracle

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Things <strong>to</strong> Consider When You Set Up Your System<br />

If <strong>the</strong> request is <strong>the</strong> same as a currently running job, <strong>the</strong>n <strong>the</strong> request will reuse <strong>the</strong><br />

output from <strong>the</strong> current job ra<strong>the</strong>r than rerunning <strong>the</strong> report.<br />

If nei<strong>the</strong>r of <strong>the</strong>se conditions is met, <strong>the</strong>n <strong>the</strong> <strong>Reports</strong> Server processes <strong>the</strong> request:<br />

a. If configured, <strong>the</strong> <strong>Reports</strong> Server initiates an au<strong>the</strong>ntication and authorization<br />

check through mod_osso, part of <strong>the</strong> <strong>Oracle</strong> HTTP Server.<br />

b. If <strong>the</strong> report is scheduled, <strong>the</strong> <strong>Reports</strong> Server s<strong>to</strong>res <strong>the</strong> request in <strong>the</strong><br />

scheduled job queue, and <strong>the</strong> report is run according <strong>to</strong> schedule. If <strong>the</strong> report<br />

is not scheduled, it is queued in <strong>the</strong> current job queue for execution when a<br />

<strong>Reports</strong> Engine becomes available.<br />

Note:: When you configure <strong>the</strong> <strong>Reports</strong> Server (in server_<br />

name.conf), you can specify <strong>the</strong> maximum number of <strong>the</strong> Report<br />

Engines it can use. If <strong>the</strong> <strong>Reports</strong> Server is under this maximum,<br />

<strong>the</strong>n it can send <strong>the</strong> job <strong>to</strong> an idle engine or start a new engine <strong>to</strong><br />

handle <strong>the</strong> request. O<strong>the</strong>rwise, <strong>the</strong> request must wait until one of<br />

<strong>the</strong> current <strong>Oracle</strong> <strong>Reports</strong> Engines completes its current job.<br />

c. At runtime, <strong>the</strong> <strong>Reports</strong> Server spawns a <strong>Reports</strong> Engine and sends <strong>the</strong><br />

request <strong>to</strong> that engine <strong>to</strong> be run.<br />

4. The <strong>Reports</strong> Engine retrieves and formats <strong>the</strong> data.<br />

5. The <strong>Reports</strong> Engine populates <strong>the</strong> <strong>Reports</strong> Server cache.<br />

6. The <strong>Reports</strong> Engine notifies <strong>the</strong> <strong>Reports</strong> Server that <strong>the</strong> report is ready.<br />

7. The <strong>Reports</strong> Server accesses <strong>the</strong> cache and sends <strong>the</strong> report <strong>to</strong> output according <strong>to</strong><br />

<strong>the</strong> runtime parameters specified in ei<strong>the</strong>r <strong>the</strong> URL, <strong>the</strong> command line, or <strong>the</strong><br />

keyword section in <strong>the</strong> cgicmd.dat file (URL requests only).<br />

Ano<strong>the</strong>r way <strong>to</strong> create a report is through event-driven publishing. With event-driven<br />

publishing, <strong>the</strong> client is <strong>the</strong> database (ra<strong>the</strong>r than <strong>the</strong> end user). Events are defined<br />

through <strong>the</strong> Event-Driven <strong>Publishing</strong> API. The event invokes a database trigger, an<br />

advanced queuing application, or a PL/SQL package that calls <strong>the</strong> Event-Driven<br />

<strong>Publishing</strong> API <strong>to</strong> submit jobs <strong>to</strong> <strong>the</strong> <strong>Reports</strong> Server. Event-Driven <strong>Publishing</strong> is<br />

discussed in detail in Chapter 17, "Using Event-Driven <strong>Publishing</strong>".<br />

1.4 Things <strong>to</strong> Consider When You Set Up Your System<br />

The way you set up <strong>Oracle</strong>AS <strong>Reports</strong> Services can vary widely depending upon <strong>the</strong><br />

requirements of your system. Before you set up <strong>Oracle</strong>AS <strong>Reports</strong> Services, you must<br />

make some decisions based upon your requirements. By making <strong>the</strong>se decisions<br />

beforehand, you can greatly simplify <strong>the</strong> set-up process.<br />

The following subsections discuss some of <strong>the</strong> decisions involved in:<br />

■ Choosing <strong>the</strong> Types of Requests You Will Service<br />

■ Choosing Servlet, JSP, or CGI<br />

■ Choosing Single- Or Multiple-Machine Configurations<br />

■ Choosing Whe<strong>the</strong>r <strong>to</strong> Cluster Multiple Servers<br />

1-6 <strong>Oracle</strong> Application Server <strong>Reports</strong> Services <strong>Publishing</strong> <strong>Reports</strong> <strong>to</strong> <strong>the</strong> <strong>Web</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!