Publishing Reports to the Web - Downloads - Oracle

13.3.3 Deploying a JSP report to the Web and to Paper
Deploying Your Reports
There are two ways you can deploy your JSP reports: through the existing Oracle
Reports application, or through a J2EE application you create yourself. Using an
existing application is useful when you are developing and testing your JSP-based
Web reports. When you are ready to deploy your reports, however, we recommend
you use an application you’ve created yourself.
About JSP reports with both paper and Web layouts
With Reports Builder, you can create a JSP report with a paper layout, a Web layout, or
both. You execute these reports using different processes:
■ JSP reports with paper layouts are executed via the Reports Engine
■ JSP reports with Web layouts are executed via the J2EE container
If your report depends on Java classes (e.g., Barcode classes, a Web Service stub, etc.),
you must configure the process to access these classes. That is, if your JSP report with a
paper layout contains a Java class, you must set the classPath property of the
Reports engine element in the server configuration file (ORACLE_
HOME\reports\conf\server_name.conf).
If your JSP report with a Web layout contains a Java class, you can either add the
classes or JAR to the WAR file, or change the J2EE container classpath. For more
information, refer to the Oracle Application Server Containers for J2EE documentation.
Note: For an example on building a report with a paper and Web
layout, refer to the "Building a Report with a Barcode" chapter in
the Oracle Reports Building Reports manual. For a simple JSP-based
Web report example, refer to the Oracle Reports Tutorial.
The steps in this section show you how to deploy a JSP report with a paper and Web
layout using a J2EE application. To deploy your JSP report with a paper and Web
layout, you can create a new Oracle Reports J2EE application in your Oracle
Application Server. You can create this application in a an existing instance or a new
instance of Oracle Application Server Containers for J2EE (OC4J).
13.3.3.1 Creating a New J2EE Application
In this section, you will create a new J2EE application for Oracle Reports. You will
create a Web application archive (a WAR file) that will contain the application
information, then deploy it as an Enterprise archive (an EAR file). To create a new J2EE
application, you can use Oracle JDeveloper, another Java development tool, or you can
create it manually. If you do not use Oracle JDeveloper to create the application, you
will need to make a few modifications to the application, as well as to your JSP report.
To create a J2EE application:
Note: If you are not familiar with creating a J2EE application, refer
to Sun’s Web site at,(http://java.sun.com/j2ee/). For more
information on using Oracle JDeveloper, refer to the Oracle
JDeveloper Online Help.
1. Before you create your WAR file, make sure your application contains all the
necessary directories, such as WEB-INF and the web.xml file.
Running Report Requests 13-7