Running a JSP-Based Web Report from a Browser

18-12 Publishing Reports to the Web with Oracle Reports Services – Oracle Reports returns the job id, and Oracle Forms Services queries on the status of this job id. – When the job status is FINISHED, Oracle Forms Services calls the WEB.SHOW_ DOCUMENT built-in to submit a request to open the report output. – The WEB.SHOW_DOCUMENT built-in opens the following URL in the browser: http:host:portreportsrwservletgetjobidn?server=server_name For additional information on calling a report from an Oracle Forms Services application, refer to the Integrating Oracle Reports Services 11g in Oracle Forms Services 11g white paper on OTN http:www.oracle.comtechnologyproductsformstechlisti ng10g.html .

18.8.1 Communication Between Reports and Forms Installed on Different Instances

Oracle Reports 11g Release 1 11.1.1 communicates with Forms. If Forms and Reports are configured on different Oracle Instances, you must complete the following steps in Forms to facilitate communication with Reports Servers. FORMS_ORACLE_INSTANCE refers to the Oracle Instance where Forms is configured.

1. From your present working directory, run the following command:

cd FORMS_ORACLE_INSTANCEconfig

2. Create the ReportsTools directory as follows:

mkdir -p ReportsToolsComponentReportsTools

3. Copy the tools-logging.xml file as follows:

cp ORACLE_HOMEreportsconfReportsToolstools-logging.xml FORMS_ORACLE_ INSTANCEconfigReportsToolsComponentReportsToolslogging.xm l

4. Copy the tools-log-template.xml file as follows:

cp ORACLE_ HOMEreportsconfReportsToolstools-log-template.xml FORMS_ ORACLE_ INSTANCEconfigReportsToolsComponentReportsToolscomponent- logs.xml

5. Copy the rwnetwork.conf file as follows:

cp ORACLE_HOMEreportsconfrwnetwork.conf FORMS_ORACLE_ INSTANCEconfigReportsToolsComponentReportsToolsrwnetwork. conf

6. Replace the following macros in the copied files:

■ Instance.directory with FORMS_ORACLE_INSTANCE ■ Self.component_type with ReportsToolsComponent ■ Self.name with ReportsTools Note: For secure mode, the URL will also include authid=authid Running Report Requests 18-13 ■ Instance.oracle_home with the path to the ORACLE_HOME directory If Forms and Reports are configured on different OHS Servers, you must route the web requests from OHS instance where Forms is configured to the Reports Servlet as follows: 1. Copy the reports_ohs.conf file as follows: cp ORACLE_HOMEreportsconfreports_ohs.conf FORMS_ORACLE_ INSTANCEconfigOHSohs1moduleconf. 2. Replace the macros managedserverhost and managaerserverport with host and port of the WLS_REPORTS managed server. 3. Restart the OHS that is running in FORMS_ORACLE_INSTANCE.

18.8.2 Generating Random and Non-Sequential Job IDs

With 11g Release 1 11.1.1, Oracle Reports allows you to generate random and non-sequential job IDs to make it impossible to predict the job ID for a particular job. To generate random and non-sequential job IDs for in-process servers, you must pass -Djobid=random via JVM options to Oracle WebLogic Server. For standalone servers, you can generate random and non-sequential job IDs by passing the -Djobid=random via JVM options in the command line or by setting the REPORTS_JVM_OPTIONS variable. For more information, see Section B.1.53, REPORTS_JVM_OPTIONS . This prevents malicious users from viewing non-secure report output by typing the job id in a URL.

18.9 Running Reports Using Oracle BPEL Process Manager

With 11g Release 1 11.1.1, Oracle Reports is integrated with the Oracle Service-Oriented Architecture SOA suite, which includes Oracle BPEL Process Manager to automate and monitor reporting requirements. You can submit Oracle Reports jobs from the Oracle BPEL Process Manager business process, get the status of report execution, and also invoke an Oracle BPEL Process Manager business process from your reports. This makes it easy to include reporting requirements in the business process; for example, submit a report request when an order gets approved. For more information, see Section 8.10, Configuring Oracle Reports to Communicate with Oracle BPEL Process Manager , and also Oracle Fusion Middleware Developers Guide for Oracle SOA Suite.

18.10 Scheduling Reports to Run Automatically

You can use the server to run reports automatically from Reports Queue Manager rwrqm on Windows, or rwrqv.sh on Solaris, Oracle Portal, or with the SCHEDULE command line keyword. The scheduling feature enables you to specify a time and frequency for the report to run. Refer to the Reports Queue Manager online Help for more information about scheduling your reports.