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.

The <strong>Reports</strong> URL Syntax<br />

Table 13–1 Components of a URL that calls <strong>the</strong> <strong>Reports</strong> Servlet<br />

Component Description<br />

web_server The name you gave <strong>the</strong> <strong>Oracle</strong> HTTP Server when you installed<br />

it.<br />

domain_name Your organization's domain name.<br />

port The port number on which <strong>the</strong> <strong>Oracle</strong> HTTP Server listens for<br />

requests. When no port is specified, <strong>the</strong> default is used (80).<br />

alias The virtual path that stands in for <strong>the</strong> absolute path <strong>to</strong> <strong>the</strong> files a<br />

URL will access.<br />

rwservlet Invokes <strong>the</strong> <strong>Reports</strong> Servlet.<br />

? Identifies <strong>the</strong> beginning of <strong>the</strong> command line options.<br />

parameters All <strong>the</strong> command line options, or <strong>the</strong> key <strong>to</strong> <strong>the</strong> key map file<br />

where command line options are specified.<br />

The URL that calls <strong>the</strong> <strong>Reports</strong> Servlet could look like this:<br />

http://neptune.world.com:80/reports/rwservlet?keyname<br />

Keyname refers <strong>to</strong> a command line listed under a unique header (<strong>the</strong> key name) in <strong>the</strong><br />

cgicmd.dat file. Note that this works differently for JSP files, which use <strong>the</strong><br />

keyword/value pair cmdkey=value <strong>to</strong> specify key names for command lines that are<br />

s<strong>to</strong>red in <strong>the</strong> cgicmd.dat file. You'll find more information about using key mapping<br />

in Using a Key Map File.<br />

Using <strong>the</strong> servlet does not mean that you cannot also use JSP report files, if <strong>the</strong> JSP files<br />

contain both <strong>Web</strong> and paper layouts. When you run <strong>the</strong> report, specify <strong>the</strong> servlet in<br />

<strong>the</strong> URL and call <strong>the</strong> JSP with <strong>the</strong> command line option: report=myreport.jsp.<br />

For example:<br />

http://neptune.world.com:80/reports/rwservlet?report=myreport.jsp&destype=cache&de<br />

sformat=html<br />

You'll find more information about command lines in Appendix A, "Command Line<br />

Options".<br />

Note: You can also supply <strong>the</strong>se parameters within <strong>the</strong> JSP file<br />

itself.<br />

Note: If you shutdown or disable <strong>Web</strong> Cache and you run a report<br />

through rwservlet <strong>to</strong> a browser with pagestreaming, <strong>the</strong><br />

resulting report output will not display correctly. This is expected<br />

behavior as <strong>the</strong> port and listener property in httpd.conf<br />

(<strong>Oracle</strong> HTTP Server configuration file) are not referring <strong>to</strong> <strong>the</strong> same<br />

port.<br />

If <strong>Web</strong>Cache is <strong>to</strong> be bypassed / shutdown / disabled for requests <strong>to</strong><br />

<strong>Oracle</strong> <strong>Reports</strong>, <strong>the</strong>n <strong>the</strong> value for Port should be changed <strong>to</strong> <strong>the</strong><br />

same value as Listen in <strong>the</strong> httpd.conf file.<br />

13-2 <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!