Index

Accessing JReport Enterprise Server - JReport Viewer

JReport Enterprise Server supports four viewers to browse reports from a client: a common browser, JReport Enterprise Viewer for JREntServer, JReport Client API and JReport Viewer Bean. Since JReport Enterprise Viewer and JReport Viewer Bean are all based on Client API, strictly speaking there are two viewers: a common browser and JReport Viewer.

In this chapter, we will learn three ways of accessing JReport Enterprise Server - JReport Viewer.

JReport Enterprise Viewer for JREntServer

JReport Enterprise Viewer for JREntServer is based on Client API but with GUI. s

1. Download JREntViewer for JREntServer - EntViewSetup.exe or EntViewSetup.sh (for Unix) from the Jinfonet Web site at http://www.jinfonet.com.
2. Follow the Install Wizard, which is easy and straightforward. Assume JREntViewer for JREntServer is installed under c:\JREntViewer. The Viewer is the client accessing the server, and you should use the same version (the same build number) of JREntViewer and JREntServer.
3. Launch JReport Enterprise Server with the batch under %JREntServerInstallRoot%\bin. We use JREntServer.bat from a DOS command:
   c:\>cd JREntServer\bin
   c:\JREntServer\bin\>JREntServer.bat -verror
4. When the server starts up, launch the JREntViewer of the same version as the server. We use the batch %JREntViewer%\bin\JREntViewer.bat from a DOS command:
   c:\>cd JREntViewer\bin
   c:\JREntViewer\bin\>JREntViewer.bat -verror
5. In the Connect dialog for the viewer, fill in the host of the server, port number and servlet path. Enter the user name and password. Click Connect. If you want to connect to JReport Enterprise Server with SSL support, check the SSL box accordingly.
   
   
   
   Or, Cancel the dialog, and type the server host name, port number and servlet path in the address bar of the viewer just like you do with a browser, and press the Enter key. You will then be prompted to log onto the server with your user name and password. First time users can login with admin as both user name and password.
   
   
   
6. If authenticated, you will see the resource tree (or alias resource tree if defined) corresponding to that in Report Explorer.
   
   
   
   You can see the viewer has the basic features like exploring the resource tree, viewing reports and scheduling.
7. Double click the report selected to see its options.
   
   
8. In this dialog, you can change the report settings as well as edit its archive policy. Most often, we click Run to view the report result now.
   
   
9. Back in the main window, go to the Schedule, Active, Completed tabs to create a schedule and check its status, just as you do with a browser, or in your local administration dialog.

Reference Node: There is a separate manual for JREntViewer for JReport Enterprise Server.

Client API

We have used a common browser (like IE) and JREntViewer for JREntServer to connect with JReport Enterprise Server. What about if you want to integrate the client viewer in your own applications? You can. Client API is the foundation of JREntViewer for Enterprise Server (with GUI) and JReport Viewer Bean. You can call methods in either Client API or JReport Viewer Bean. JReport Viewer Bean is most often used for running reports and exporting report results to other formats or printers. Client API has more flexibility including the scheduling feature.

When you install JREntViewer for JREntServer, the archive file for Client API is also installed at %JREntViewer%\lib\JREntViewer.zip. There are demo sample code files you can refer to. Please go to the JREntViewer Manual | Client API chapter.

Index