Getting and using resources from a real path

Not only can you use the published resources described in section Publishing resources, but also those resources obtained from a real path. The difference between real path resources and published resources lies in the way of managing them. Published resources are managed in JReport Server totally. Real path resources are managed in both the server and the operating system. In the server, when accessing a resource node which is linked with a real path, the local resources in the real path are loaded to the node and displayed together with other server resources (including the published resources) in the node. You cannot delete the real path resources directly from the server UI, but can only achieve it by removing the resources from the local disk.

To use real path resources, you should specify a real path for a virtual folder. You can then add or remove resources into or from JReport Server by adding or removing them into or from the real path. Also, if you do not want to publish resources to the server by using the publish feature, you can set a real path instead.

The following example uses the resources in the folder /SampleReports obtained from the real path:

1. On the JReport Administration page, click Configuration on the system toolbar, then select Advanced from the drop-down menu.
2. In the Advanced panel, check the Enable Resources from Real Paths option, save the changes and then restart the server.
3. Open the Properties dialog of the folder /SampleReports, check Enable Resources from Real Paths, specify a real path for the demo virtual folder as C:\JReport\Server\reportbak, then click OK to save the changes.
4. In the Windows directory C:\JReport\Server\reportbak, create three sub directories report1, report2, and report3, and then copy some reports and catalogs into them.
5. On starting JReport Server, click the virtual folder /SampleReports. You will then see the three sub folders: report1, report2, and report3 within it, including their reports and catalogs.

Now end users can perform operations on the real path resources, including viewing versions, setting properties, and report based operations such as running, advanced running, and scheduling.

Setting default real paths for the Public Reports and Public Components folders before server starts

JReport Server enables setting the default real paths for the Public Reports and Public Components folders without having to log onto the server. There are two ways to achieve this goal: setting the real path during or after installation.

• Setting during installation
  1. When installing JReport Server using the Installation Wizard, select the installation type Custom Installation for Standalone Server. The Configure System Environment screen is then available.
  2. In the screen, select Advanced from the left panel.
  3. Check the Enable Resources from Real Paths option, and then type in the paths separately in the Public Reports Real Path and Public Components Real Path text fields or specify the paths using the Browse button.
  4. Upon completion of the installation, an install.server.properties file will be created in the <install_root>\bin directory. When the server starts, it retrieves the file contents, and then sets the real path for the Public Reports and Public Components folders. Note that the file is deleted after the server has loaded the file contents.
• Setting after installation

  If you want to set the default real paths for the Public Reports and Public Components folders after installation, you can create an install.server.properties file in the <install_root>\bin directory manually. Specify the content in the file as follows:

  server.publicReportsRealPath=D:\JReport
server.publicComponentsRealPath=D:\JReport