A script-enabled browser is required for this page to function properly.

About previewing JSP-based Web reports

You can preview a JSP-based Web report by clicking the Run Web Layout button in the toolbar, or by choosing Programright arrowRun Web Layout, to run the Web Source. Reports Builder displays Web reports in your default browser.

Note:

You do not need to have the Reports Server configured to use this functionality. Reports Builder includes an embedded Oracle Container for Java (OC4J) server. Each instance of Reports Builder has its own OC4J server listening on a unique port, so you can have multiple Reports Builder sessions running at the same time. If a port is not specified, Reports Builder automatically looks for a free port in the default range. If you are using the OC4J option to preview a JSP report locally and your JSP depends on external files, such as images, or if you want to check the generated Java files, it is important to understand how Reports Builder handles the temporary files.

A JSP gets converted into a .java file and compiled into a class file. When the class file is executed, it will return HTML in a .html file. This file and the .java and .class files are all located in the $REPORTS_TMP/docroot directory. $REPORTS_TMP can be passed in as a command line parameter to Reports Builder, thus allowing you to override the default location for the docroot directory. The contents of the docroot directory are cleaned up when you exit Reports Builder.

Document Root

By default, the Reports Builder document root is the docroot directory under the directory specified by the $REPORTS_TMP environment variable (for example, c:/temp/docroot). The end user can override this default docroot from the command line (using the WEBSERVER_DOCROOT command line keyword). If your JSP depends on external files, such as images, style sheets, and so on, make sure you copy them into the docroot directory. Better yet, you can specify the WEBSERVER_DOCROOT command line value to be your document root directory.

Document Root Structure

A JSP gets translated into a .java file and compiled into a .class file. When the .class file is executed, it will return HTML in a.html file. When the .class file is executed, it will return HTML in an .html file. This file and the .java and .class files are all located in the $REPORTS_TMP/docroot directory. $REPORTS_TMP can be passed in as a command line parameter to Reports Builder, thus allowing you to override the default location for the docroot directory. The contents of the docroot directory are cleaned up when you exit the Reports Builder.

The docroot directory structure looks as follows after running emp.jsp (note that we use the default docroot which is $REPORTS_TMP/docroot):

temp
  docroot
    3000                        working directory for instance of the Builder 
      default
	    defaultWebApp           temporary JSP working directory
		  temp
		    _pages
			_empxxx.class       compiled Java class
			_empxxx.java        translated Java file
	  log                       OC4J log directory
	    global-application.log
		server.log
		orion-conf              OC4J configuration files directory
	  stderr.log                debug log when WEBSERVER_LOG=yes
	  stdout.log
	3002                        another instance's working directory
	css                         template style sheets
	images                      template images
	WEB-INF
	  lib
	  reports_tld.jar
	web.xml                           
	rwerror.jsp                 template error JSP
	empxxx.jsp                  working copy of emp.jsp
	empxxx.html                 resulting output

Notes:

See also

About Web reports

Displaying report output in your Web browser

Printing a report from your Web browser