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

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

orawin/reports/conf/filename.ext<br />

3.3.1 Specifying <strong>the</strong> Location of <strong>the</strong> Key Map File<br />

Configuring <strong>the</strong> <strong>Reports</strong> Servlet<br />

Your report runtime command line may include information you do not want <strong>to</strong><br />

expose <strong>to</strong> your users. Additionally, it may be comprised of a long string of options that<br />

is difficult <strong>to</strong> remember or makes for an ungainly URL.<br />

You have <strong>the</strong> option of entering a report's command line options in a key map file<br />

(cgicmd.dat), <strong>the</strong>n limiting <strong>the</strong> exposed runtime command <strong>to</strong> <strong>the</strong> name of <strong>the</strong><br />

particular key section in this file that holds <strong>the</strong> required options.<br />

The key map file is discussed in Chapter 13, "Running Report Requests". Use <strong>the</strong><br />

<strong>Reports</strong> Servlet configuration file <strong>to</strong> list <strong>the</strong> location of this file.<br />

For example:<br />

KeyMapFile=d:\\orawin\\reports\\conf\\cgicmd.dat<br />

This example uses <strong>the</strong> default filename and location. An entry for <strong>the</strong> location and<br />

filename of <strong>the</strong> key map file doesn't appear by default in <strong>the</strong> servlet configuration file<br />

because <strong>the</strong> servlet already knows what <strong>to</strong> look for and where <strong>to</strong> look for it. If you use<br />

a file with a different name and/or different location, you must include a<br />

KeyMapFile parameter in your servlet configuration file that includes <strong>the</strong> direc<strong>to</strong>ry<br />

path and filename.<br />

3.3.2 Reloading <strong>the</strong> Key Map File<br />

Use <strong>the</strong> RELOAD_KEYMAP parameter <strong>to</strong> specify whe<strong>the</strong>r <strong>the</strong> key map file<br />

(cgicmd.dat) should be reloaded each time <strong>the</strong> servlet receives a request.<br />

For example:<br />

RELOAD_KEYMAP=yes<br />

This is useful if you frequently make changes <strong>to</strong> <strong>the</strong> map file and want <strong>the</strong> process of<br />

loading your changes <strong>to</strong> be au<strong>to</strong>matic. Runtime performance will be affected according<br />

<strong>to</strong> how long it takes <strong>to</strong> reload <strong>the</strong> file.<br />

Typically, this parameter is set <strong>to</strong> no in a production environment and yes in a testing<br />

environment.<br />

3.3.3 Hiding <strong>Web</strong> Command Output<br />

You may want <strong>to</strong> provide an au<strong>the</strong>ntication mechanism for an unsecured <strong>Reports</strong><br />

Server so that only an administra<strong>to</strong>r (based on <strong>the</strong> authid) can run a <strong>Web</strong> command,<br />

like showenv, showjobs, etc. By setting DIAGNOSTIC=NO in <strong>the</strong><br />

rwserver.properties file, you can provide just such an au<strong>the</strong>ntication mechanism.<br />

This au<strong>the</strong>ntication information is also used for administrative tasks, for example,<br />

s<strong>to</strong>pping <strong>the</strong> <strong>Reports</strong> Server from <strong>the</strong> command line.<br />

Note: Setting DIAGNOSTIC=NO only works for non-secured<br />

<strong>Reports</strong> Server. For secure <strong>Reports</strong> Server users, <strong>Reports</strong> Server<br />

verifies <strong>the</strong> user’s privileges based on <strong>the</strong> entries in <strong>Oracle</strong> Internet<br />

Direc<strong>to</strong>ry.<br />

To disable <strong>Web</strong> command display for an unsecured <strong>Reports</strong> Server<br />

Configuring <strong>Oracle</strong>AS <strong>Reports</strong> Services 3-33

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

Saved successfully!

Ooh no, something went wrong!