As mentioned before, Report Designer must be used in conjunction with ERES Server. ReportDesigner can be called using the API. Note that in this scenario, you will have to add ReportDesigner.jar in your CLASSPATH and place a copy of the reportimages (ERES/reportimages), images (ERES/images), and the backgroundImages (ERES/backgroundImages) directories under the working directory of the .class file.

Instead of copying the directories relative to the working directory when invoking the Report Designer from API, an option to set the location images/, reportimages/ and backgroundImages/ directory is also available. Simply use a QbReportDesigner constructor with the parameter imagesPath. For more detail about the QbReportDesigner constructor or the imagesPath parameter, please refer to the ERES Java API Documentation.

To connect to ERES Server, you use the following three API methods in QbReportDesigner to set the connection information:

static void useServlet(boolean b);
static void setServletRunner(String comm_url);
static void setServletContext(String context);
        

Please note that specifying the connection information to ERES Server must be made before calling any QbReportDesigner constructors.

Report Viewer can be used in an applet or application environment to show a report saved in a .pak file (either generated by Report Designer or Report API).

To deploy Report Viewer in an applet environment, the ReportViewerWithChart.jar must be included in the HTML file as the archive file.

To use Report Viewer, construct an HTML page with the proper applet code (for more details, please refer to the Report Viewer chapter). Note that any relative references to the report location and/or data are relative to the directory from where the ERES Server has been started.

To connect to the ERES Server, you pass the following parameters to the Report Viewer applet:

comm_protocol (servlet), comm_url (machine name/IP address and port number), servlet_context (servlet context)
        

Page Viewer can be used in an applet or application environment to show a particular page of a report at a time. These PAGE files are of .page file extension and are generated by Report Designer or by the Report API.

To deploy Page Viewer in an applet environment, the PageViewer.jar must be included in the HTML file as the archive.

To use Page Viewer, construct an HTML page with the proper applet code (for more details, please refer to the Page Viewer chapter). Note that any relative references to the report location and/or data are relative to the directory from where ERES Server has been started.

To connect to ERES Server, you pass the following parameters to the Page Viewer applet:

comm_protocol (servlet), comm_url (machine name/IP address and port number), servlet_context (servlet context)
        

Deploying Chart Viewer is similar to deploying Report Viewer. Chart Viewer can be used in an applet or application environment to show a chart saved in a .cht or .tpl file (either generated by Designer or API).

To deploy Chart Viewer in an applet environment, EspressViewer.jar must be included in the HTML file as the archive.

To use Chart Viewer, construct an HTML page with the proper applet code (for more details, please refer to start the Chart Viewer chapter). Note that any relative references to the chart location and/or data are relative to the directory from where ERES Server has been started.

To connect to ERES Server, you pass the following parameters to the Chart Viewer applet:

comm_protocol (servlet), comm_url (machine name/IP address and port number), servlet_context (servlet context)
        

Report API can be used in either an applet environment or as an application. Report API can also be used in a servlet or jsp environment to generate server-side reports.

To deploy Report API, ERESOrganizer.jar, ERESServer.jar and ExportLib.jar must be in the CLASSPATH (for application and servlet/jsp environment) or included in the HTML file (for an applet).

To connect to ERES Server, you would use the following methods in QbReport to set the connection information:

static void useServlet(boolean b);
static void setServletRunner(String comm_url);
static void setServletContext(String context);
        

Please note that specifying the connection information to ERES Server must be made before calling any QbReport constructors.

A scheduler has also been included with ERES. This scheduler can be used to export and archive reports and charts from their source files at specific intervals. For more information on the Scheduler, please look in the Scheduler chapter.

Like Report Designer, Scheduler too must be used in conjunction with the ERES Server. Scheduler can be called using the API. Note that in this scenario, you will have to add ERESServer.jar and ERESOrganizer.jar in your CLASSPATH.

To connect to the ERES Server, you would use the following methods in QbOrganizer to set the connection information:

static void setServletRunner(String comm_url);
static void setServletContext(String context);
        

Please note that specifying the connection information to the ERES Server must be made before calling any QbOrganizer constructors.

To deploy Report Viewer, ReportViewerWithChart.jar must be included in the HTML file as the archive. Depending on what functionality you are using, you have to include additional jars as necessary.

Report Viewer can be used independent of the ERES Server with the addition of one more parameter in the applet code:

<param name="EspressManagerUsed" value="false">
        

Note that any relative references to the report location and/or data are relative to the directory where the HTML file is located. For example, if the data source specified in the .pak file is help\examples\data\sample.dat and if the HTML file is located in D:\ERES\TestApplet, then for the report to be displayed successfully, help\examples\data\sample.dat must exist within D:\ERES\TestApplet (i.e., D:\ERES\TestApplet\help\examples\data\sample.dat must exist).

To deploy Page Viewer, PageViewer.jar must be included in the HTML file as the archive. Depending on what functionality you are using, you have to include additional jars as necessary.

Page Viewer can be used independently from ERES Server with the addition of one more parameter in the applet code:

<param name="EspressManagerUsed" value="false">
        

Note that any relative references to the report location and/or data are relative to the directory where the HTML file is located. For example, if the data source specified in the .pak file is help\examples\data\sample.dat and if the HTML file is located in D:\ERES\TestApplet, then for the report to be displayed successfully, help\examples\data\sample.dat must exist within D:\ERES\TestApplet (i.e., D:\ERES\TestApplet\help\examples\data\sample.dat must exist).

Also note that when using Page Viewer without connecting to ERES Server, you cannot pass in a template directly. You must pass in the page file instead.

To deploy Chart Viewer, EspressViewer.jar must be included in the HTML file as the archive. You have to include additional jars as necessary depending on what functionality you are using.

Chart Viewer can be used independently from ERES Server with the addition of one more parameter in the applet code:

<param name="EspressManagerUsed" value="false">
        

Note that any relative references to the report location and/or data are relative to the directory where the HTML file is located. For example, if the data source specified in the .pak file is help\examples\data\sample.dat and if the HTML file is located in D:\ERES\TestApplet, then for the report to be displayed successfully, help\examples\data\sample.dat must exist within D:\ERES\TestApplet (i.e., D:\ERES\TestApplet\help\examples\data\sample.dat must exist).

To deploy Report API, ERESOrganizer, ERESServer.jar and ExportLib.jar must be in the CLASSPATH (for application and servlet/jsp environment) or included in the HTML file (for an applet).

Report API can also be used without connecting to ERES Server by adding the line of code below:

QbReport.setEspressManagerUsed(false);
        

This method must be called prior to any QbReport instantiation.

As with Report Viewer, any relative references to the report location and/or data are relative to the working directory from where class file is being executed. For example, if the data source specified is help\examples\data\sample.dat and if the class file is located in D:\ERES\TestApplication, then for the report to be displayed successfully, help\examples\data\sample.dat must exist within D:\ERES\TestApplication (i.e., D:\ERES\TestApplicationhelp\examples\data\sample.dat must exist).

Note that any charts created in Report Designer will contain a relative path to the template. Therefore, the directory structure must be mirrored under the working directory (i.e. create a chart sub-directory with the template under the working directory) or open the template and change the path with an absolute path using the following code:

// Get the Chart from the footer
ReportChartObject obj = (ReportChartObject)report.getTable().getFooter().getData(0);
String originalLocation = obj.getText();
String newLocation = new String("http://128.0.0.1/EspressEnterprise/ERES/test/chart/chart/ERES1.1_0.tpl");
obj.setText(newLocation);
        

In a servlet/jsp environment, the location of the directory with the class file and the working directory might differ. In that case, any relative references are with respect to the working directory. For example, if the servlet class file was in D:\<some servlet engine>\webapp\examples\quadbase\someservlet.class and the data source was help\examples\data\sample.dat and the working directory was D:\<some servlet engine>\webapp, then help\examples\data\sample.dat must exist under D:\<some servlet engine>\webapp (i.e., D:\<some servlet engine>\webapp\help\examples\data\sample.dat must exist) for the report to be generated successfully.

Note that in the API, methods are also available that allow you to specify the location of the chart, drill-down, image, and sub-report directories where certain files may be located. For instance, given the existence of a template, ERES1.1_0.tpl, in the report, you can specify the location this template by using the following code:

report.setChartPath("d:/ERES/Chart/");        // where report is an object of type QbReport
        

The above code sets the location of the template file thus avoiding the need to have a chart subdirectory under the working directory of your class file.

The following methods work similarly:

QbReport.setDrillDownPath(String directory);
QbReport.setImagePath(String directory);
QbReport.setSubReportPath(String directory);
        

Xvfb is an X server that can run on machines with no display hardware and no physical input devices. It emulates a dumb terminal framebuffer using virtual memory.

The primary use of this server is intended to be server testing. Xvfb is also limited in the number of colors and fonts it can handle.

Xvfb can be downloaded (there are different version available depending on the system) and then run. After Xvfb is running, the DISPLAY variable needs to be set and then passed to the application (or the servlet engine).

You can use a 1.5+ JVM run-time parameter to run applications using ERES. The run-time parameter is java.awt.headless and setting it to true results in Java not making an X connection for any graphics information. For example, if you have an application called chartExport that generates charts as jpg's, ordinarily running it would involve making a connection to X. However, using the following command:

java -Djava.awt.headless=true exportChart
        

the same application is now run without a connection to X.