Configuring report libraries for viewing

When creating BIRT reports, you can define report libraries containing components for reuse in reports. You must take special steps to ensure that such libraries are available when you run reports in WSRR.

About this task

A report library enables you to reuse components, such as a data source definition, across multiple reports. This saves you from defining the same components repeatedly for different report designs. There are two ways to make a report library available when reports are viewed: you can store the library in WSRR along with the reports that uses it, or you can ensure that the WSRR Studio or BIRT Studio resource directory is available to WSRR when the report is run.

If you store a report library in WSRR, you must ensure that the configuration stores it under the library name as referenced by the reports that use it. For example, if a report design contains the following reference to the report library WSRRv7ReportLibrary.rptlibrary:

<list-property name="libraries">
    <structure>
       <property name="fileName">WSRRv7ReportLibrary.rptlibrary</property>
       <property name="namespace">WSRRv7ReportLibrary</property>
    </structure>
</list-property>

Then the report library must be stored in the BIRT Report Design configuration item with the name WSRRv7ReportLibrary.rptlibrary.

When creating BIRT reports, the library folders are generally placed in a resource directory. If you are designing reports on the same computer as the WSRR that is acting as your data source, you can place the resource directory where it can be accessed at both design time and run time. If you are designing reports on a computer that is remote from WSRR, you must copy the report library manually to the expected location. Similarly, if you have WSRR deployed on a cluster system, you must copy the report library to all the nodes in the cluster.

Procedure

To make a report library available, take one of the following steps:

To load a library into WSRR:
1. Switch to the Configuration perspective, by selecting Configuration in the Perspective list.
2. Click Active Profile > BIRT Report Design > Load BIRT Report Design.
3. Select the file containing the report library:
  - If the required BIRT report library file is on a local system, click Local file system and either type the name of the file in the entry field, or select it by using the Browse button.
  - If the file is on a remote system, click Remote file location and specify the URL of the file.
4. Specify the library name, for example, WSRRv7ReportLibrary.rptlibrary, as the configuration item name.
5. Click OK to load the report library.
To make a report library available from the resource directory, if you are working locally to WSRR, and using WSRR Studio to design reports, proceed as follows:
1. In WSRR Studio, click on Window > Preferences.
2. Select Report Design > Resource from the preferences tree.
3. In the Resource folder field, enter the path of the WSRRReportViewer in your WSRR installation:
```
WSRR_INSTALL/profiles/myprofile/InstalledApps/mynode/WSRRReportViewer.ear/WSRRReportViewer.war/WSRRv7ReportLibrary.rptlibrary
```
4. Click OK.
5. Select your library in the explorer pane, and select Place Library in Resource Folder from the shortcut menu.
If you are working locally to WSRR, and using BIRT Studio to design reports, proceed as follows:
1. In BIRT studio, select your library in the explorer pane and select Place Library in Resource Folder from the shortcut menu.
2. In the Publish Library window, enter the path of the WSRRReportViewer in your WSRR installation:
```
WSRR_INSTALL/profiles/myprofile/InstalledApps/mynode/WSRRReportViewer.ear/WSRRReportViewer.war/WSRRv7ReportLibrary.rptlibrary
```
3. Click OK.
If you are working remotely, then you must copy the report library manually when you are ready to deploy it. If WSRR is on a cluster system, you must copy the report library to every node in the cluster.
1. Locate your report library file in the resources folder of WSRR Studio or BIRT studio.
2. Copy the file to the following directory on your remote WSRR system:
  - ```
  WSRR_INSTALL/profiles/myprofile/InstalledApps/mynode/WSRRReportViewer.ear/WSRRReportViewer.war/WSRRv7ReportLibrary.rptlibrary
```
- ```
WSRR_INSTALL\profiles\myprofile\InstalledApps\mynode\WSRRReportViewer.ear\WSRRReportViewer.war\WSRRv7ReportLibrary.rptlibrary
```