Previous Page Next Page

Publishing Resources

Publishing resources locally

Publishing resources remotely

JReport Designer, as a report design tool, allows you to publish your resources from it to your local computer or to JReport Server.

When you publish a resource such as a report template, all of the referenced report templates and additional resources such as images will also be published although they will not be visible. This ensures that images and linked reports will be available at runtime.

Publishing resources locally

JReport Designer supports publishing resources locally. That is, publishing resources to any directory on your computer or across your intranet.

1. Click File > Publish > Publish to Local Directory. The Publish to Local Directory dialog appears.

   

2. Click the Browse button to select a catalog, or type the catalog name with its full path directly into the From Catalog text field, and then press Enter to specify the catalog. All the reports in the specified catalog will then be displayed in the Select Report box.
3. Select the reports that you want to publish from the Select Report box and click the arrow button to add them to the box on the right, or directly drag the reports you want to publish from the Select Report box to the box on the right. If no report is selected here, only the catalog will be published.
4. Specify a directory for the catalog and reports that are to be published.

   Click the Browse button to the right of the To Local Directory text field, and locate a directory in the Get Directory dialog. Or you can type a directory in the text box directly. If you type in a directory which does not exist, JReport Designer will automatically create it for you.

5. Click Next to view or modify properties of the data source connection.

   

   First, select a data source from the Catalog Data Source drop-down list, and then the connection properties of the selected data source will be displayed. If the selected data source is built on a JDBC connection, you can click the Modify button to modify properties of the data source connection in the Get JDBC Connection Information dialog.

6. Click the Finish button to publish the catalog and reports.

Publishing resources remotely

The following introduces how to publish different resources to JReport Server, which include reports, library components and additional resources.

If the resource you publish to on the server is already a real path resource you will get a permission denied error since real path resources can only be published by copying the files physically using FTP or OS copy file utilities.

Make sure that JReport Server is started before publishing resources.

Publishing reports and library components

When publishing reports and library components to JReport Server you are actually copying the files into a subfolder in the <install_root>/history folder. The JReport Server database keeps track of physical disk locations and maps those to logical folders shown in the server resource tree.

1. In JReport Designer:
   • Click File > Publish > Publish Report to Server if you want to publish reports.
   • Click File > Publish > Publish Component to Server if you want to publish library components.

   The Connect to JReport Server dialog appears.

   

2. Type in the host and port of the remote JReport Server in the Host and Port text fields.
3. When using a standalone server, enter /jrserver in the Servlet Path text field or the context root of your web application if deployed as a war or ear file such as /jreport/jrserver.
4. If the server has been integrated with another web server that supports SSL, select the SSL (Security Socket Layer) checkbox to create an SSL connection.
5. Check Remember connection information to enable JReport Designer to remember the connection information.
6. Provide the user name and password of the server. When the Organization feature is enabled and when the user is an organization user, User Name should include the organization name. Use \ to separate the organization name and the user name, for example, org1\user1.
7. Click Connect. The Publish to JReport Server dialog appears.

   

8. Click the Browse button next to the Publish Resource From text field to find the directory where your resources are located, and the resources in the specified directory will be loaded automatically. If you choose to type in the directory in the text field directly, you need to press Enter on the keyboard to load the resources in that directory.
9. In the resource tree box, check the checkboxes in front of the resources that you want to publish. To publish all the resources in the specified directory, check Select All.
10. In the Publish Resource To text field, click the Browse button to specify the folder in the server resource tree where the resources are to be published.
11. Select a to-be-published resource in the resource tree box and then click the More Options button to set properties for the resource.
12. In the Properties tab,
    1. In the Resource Node Name text field, specify a name to be displayed in the server resource tree for the resource. You can type a name in the text field or click the Browse button to select a resource name from the Select Resource Name dialog, where all resource names of the same type as the selected resource, which are contained in the Publish Resource To path, are displayed.
    2. In the Resource Description text box, type a brief description to describe the resource.
    3. If a report is selected, specify the status of the report by selecting the required item from the Status drop-down list:
       • Active
         The report can be run, advanced run and scheduled on JReport Server.
       • Inactive
         The report cannot be run, advanced run or scheduled on JReport Server.
       • Incomplete
         The report is not completely designed and cannot be run, advanced run or scheduled on JReport Server.
    4. If a folder is selected, type a local disk path in the Resource Real Path text field as the real path of the folder. If you would like to map the real path resources into the new node created for the folder in the server resource tree so that the server will always be able to get the resources and updates from the real path, check the option Enable Resources from Real Paths. However once you create a real path folder you can no longer publish reports to it from JReport Designer. You need to physically copy the files you want to publish into the specified folder on the server.
    5. In the Custom Field box, specify custom field values for the resource if there are custom fields enabled on JReport Server.
    6. Check Apply Archive Policy to apply an archive policy to the resource.
       • To use multiple versions for the selected resource, check Archive as New Version, then in the Max Number of Versions text box enter the maximum number of versions that will be listed in the version table of the selected resource. The default value is 0, which means that the version amount is unlimited.
       • To replace the old version when the new version is generated, check Replace Old Version.
13. In the Permissions tab, check the Enable Setting Permissions option to specify permissions for the selected resource (this tab is available only when you have specified to publish the resources to a public folder on the server). For detailed information about the permissions, see Managing Permissions in the JReport Server User's Guide.

    The roles, users, and groups that are created in the JReport Server security system are listed in the Role, User and Group boxes. From one box, select a principal then check the checkboxes ahead of the required permissions. You can remove the principals in any box by selecting it and clicking the Remove button. To add the deleted principal back, use the Add button.

    

14. If the selected resource is a catalog, the Connection tab is activated. Select a data source from the Catalog Data Source drop-down list and the connection properties of the selected data source are displayed. If the data source contains multiple connections only properties of the first connection are listed. When the connection is a JDBC connections the Modify button is activated. You can click it to modify properties of the JDBC connection in the Get JDBC Connection Information dialog. This is very useful when the database you use for report development is different from the one you use for production reports. Another alternative is to override the details of the connection by using the datasource.xml file in JReport Server.

    

15. Repeat steps 11 - 13 to set properties for other resources as required.
16. Click OK to publish the resources. If the reports or library components use special fonts, style groups, geographic information, or customized control files, the Publish Additional Resources dialog appears for you to specify them.

Publishing additional resources

Additional resources used by reports and library components can also be published to JReport Server. These resources include special fonts, geographic information, style groups, and customized control files.

1. Click File > Publish > Publish Other Files to Server.
2. In the Connect to JReport Server dialog, specify the information to connect to a started JReport Server. The Publish Additional Resources dialog is displayed.

   

3. If special fonts are available, click the Browse button to specify the folder containing the special fonts.
4. In the Style tab, select the style groups you need and then click the right-headed single arrow button to add them to the right box.
5. In the Geographic Information tab, select the desired xml file where geographic information is stored and click the right-headed single arrow button to add them to the right box.

   

6. In the Customized Control tab, select the customized control files you need and click the right-headed single arrow button to add them to the right box.

   

7. Click OK to publish the resources.

Previous Page Next Page