Paper Layout Formatting the Data

24-44 Publishing Reports to the Web with Oracle Reports Services ■ When generating a report to PDF output, set the PDFCOMP command line keyword to NO. PDF output is compressed by default. Although compressed files download quickly, the time taken to generate a compressed file is much more when compared to a non-compressed file. Note: Running a Report to WebLayout works only if the weblayout port in the ORACLE_ INSTANCEconfigReportsToolsComponentReportsToolsr wbuilder.conf file is set to the port of the managed server, as in the following example: webLayout port=managed_server_port docroot=DOMAIN_HOMEserversWLS_REPORTStmp_WL_userreports_ versionrandom_stringwar Part VII Part VII Appendixes Part VII contains appendixes that provide additional, detailed information about functioning in Oracle Reports Builder and in the Oracle Reports Services environment. It includes information about Oracle Reports commands and their associated command line options, details about Reports-related environment variables, as well as how to register reports in Oracle Portal using batch scripts: ■ Appendix A, Command-Line Keywords ■ Appendix B, Environment Variables ■ Appendix C, Batch Registering Reports in Oracle Portal ■ Appendix D, Troubleshooting Oracle Reports Services A Command-Line Keywords A-1 A Command-Line Keywords This appendix contains descriptions and examples of command-line keywords that can be used with the Oracle Reports components. This appendix contains the following topics: ■ Using the Command Line ■ Overview of Oracle Reports Components ■ Keyword Usage Summary ■ Command-Line Keywords The information in this appendix is also documented in the Oracle Reports online Help, which is available in Reports Builder or hosted on the Oracle Technology Network OTN, as described in the Preface under Related Documentation . A.1 Using the Command Line An Oracle Reports command on the command line generally has the following form: component_name keyword=value, keyword=value, ... where each keyword=value pair is called a command line option. Keywords must be specified and can be used in any order following the component name. A.1.1 General Usage Notes ■ No spaces should be placed before or after the equal sign of an option. ■ Separate options with one or more spaces; do not use commas to separate options. ■ Values may be in single or double quotes. The effect of single or double quotes is operating system-specific. ■ The keyword= part of all options is not case-sensitive. The value portion may be case-sensitive, depending on your operating system. ■ To pass a single quote from the command line, you must enter two quotes one quote as an escape and one as the actual quote. For example: Note: For examples of using command line keywords in your runtime URL, see Chapter 18, Running Report Requests . A-2 Publishing Reports to the Web with Oracle Reports Services rwrun REPORT=myrep DESTYPE=file DESNAME=run.out BATCH=yes p_value=Roys Batch Report ■ Full pathnames are supported for all file references for example, DESNAME=revenuesq1nwsales. If you do not specify the full path name, the Oracle Reports file searching method is used to find the file. If you do not specify a path for a keyword value that includes a file name, the Reports Server will try to find the file from the REPORTS_PATH environment variable. ■ All file names and paths specified in the client command line refer to files and directories on the server machine, except for any file specified for the following command line keywords: – CMDFILE=filename. In this case, the CMDFILE specified is read and appended to the original command line of which CMDFILE is a part before being sent to the Reports Server. The runtime engine does not reread the command file – DESNAME=filename DESTYPE=LOCALFILE. In this case, DESNAME refers to files on the client machine. A.1.2 Rules ■ Values entered on the Runtime Parameter Form override those entered on the command line. For example, if you specify rwrun on the command line with COPIES=1, but in the Runtime Parameter Form, specify COPIES=2, then two copies of the report are generated. ■ Values entered on the command line override those specified in command files. For example, if you specify rwrun on the command line with COPIES=1 and CMDFILE=RUNONE a command file, but the command file RUNONE, includes rwrun COPIES=2, only one copy of the report is generated. ■ You can specify values for DESTYPE, DESNAME, DESFORMAT, ORIENTATION, and COPIES in a number of different places. The following list shows the decreasing order of precedence for the places where you specify these values: 1. Print Job dialog box 2. Runtime Parameter Form 3. Runtime ParametersSettings tab of Preferences dialog box 4. Keywords on the command line 5. Values specified in the report definition 6. Choose Printer dialog box A.2 Overview of Oracle Reports Components This section provides a brief description of the Oracle Reports components and contains examples showing how to use command-line keywords with each component. ■ rwclient ■ rwrun ■ rwbuilder ■ rwconverter