Publishing Reports to the Web - Downloads - Oracle

Using a Key Map File
An exception to this is if you use the cmdkey command line keyword, and express the
key name as its value: cmdkey=keyname. In this case, you can place the key name
anywhere in the query string within the report request URL. The cmdkey keyword can
be used with jobs run as JSPs and with the rwservlet command.
13.11.1 Enabling Key Mapping
Note: You’ll find more information about the cmdkey keyword in
Command Line Options.
Key mapping is enabled when any of these conditions are met:
■ A valid file with the standard file name, cgicmd.dat, is present in the default
location: the ORACLE_HOME\reports\conf\ directory on the Web server
machine (on either Windows or UNIX).
■ A valid key map file is entered in the Reports Servlet configuration file
(rwservlet.properties) under the KEYMAPFILE parameter.
■ When rwcgi is used, when the REPORTS_CGIMAP environment variable on the
Web server machine specifies the name of a valid key map file. See
Reports-Related Environment Variables for more information.
13.11.2 Adding Key Mapping Entries to a Key Map File
To add key mapping entries to a key map file:
1. Navigate to the cgicmd.dat file on the machine that hosts your Reports Server,
and open it with a text editor.
You'll find this file in the following directory on both Windows and UNIX:
ORACLE_HOME\reports\server\conf\cgicmd.dat
2. Add a key mapping entry. For example:
key1: report=your_report.rdf userid=username/password@my_db desformat=html
SERVER=server_name.cluster_name (if present)> destype=cache
In this example, key1 is the name of the key.
Except for the special parameters that are described in the file itself, the command
line options follow the syntax rules of rwclient. See Command Line Options for
more information.
3. Add or update the hyperlinks on your Web page.
For more information, see Specifying a Report Request from a Web Browser.
13.11.3 Using a Key with Everything but JSPs
When you place a key name in a report request URL, it must always be the first value
within the query string (immediately after the question mark). For example:
http://…/rwservlet?keyname
Below is an example of a key mapping for a restricted run with a parameter form.
The URL might be:
http://web_server.domain_name:port/cgi-bin/rwcgi.exe?key&par1&par2&parN
Running Report Requests 13-19