Using report libraries and additional resources

You can use report libraries to share data source and data set definitions, and other resources, between different reports in WSRR.

About this task

You can store data source and data set definitions, and other resources, in a BIRT report library. This library can be shared by many reports; this means that you have to define your resources only once for a set of reports.

Procedure

You can create a report library in your configuration profile project either from the WSRR Configuration perspective, or from the Report Design perspective.

  1. To create a report library from the WSRR Configuration perspective, complete the following steps:
    1. Expand your project in the WSRR Configuration Project Explorer view.
    2. Right-click the Reports folder, and select New > Other. The Select a wizard dialog box opens.
    3. Expand Business Intelligence and Reporting Tools, select Library, and click Next.
    4. Enter a name for the library, and click Finish.
  2. To create a report library from the Report Design perspective, complete the following steps:
    1. Expand your project in the Navigator view.
    2. Right-click the Reports folder, and select New > Library.
    3. Enter a name for the library, and click Finish.
  3. Add data sources and data sets, and other report artifacts, to your report library as you would when creating a report.
  4. After you have created your report library, you can attach it to reports by completing the following steps:
    1. Double-click your report design file to open it.
    2. Switch to the Report Design perspective if it is not already open.
    3. In the Outline view, right-click Libraries, and select Use Library. The Use Library dialog opens.
    4. Locate your report library in the Shared Resources folder; it should be located in the Reports subfolder. Select the library and click OK.
      By default the Shared Resources folder is set to be the folder for the project that you are currently modifying. You can change this setting, although if you are deploying to WSRR then this should be avoided unless absolutely necessary. To change this folder, complete the following steps:
      1. Click Windows > Preferences.
      2. Select Resource, and specify a different resource folder.

    The artifacts that you have added to the library can now be added to the report. Browse to the library in the Resource view to view the artifacts that it contains.

  5. If you are storing and running your reports in WSRR, follow the procedure for publishing reports and report libraries to WSRR to load the report library into the configuration profile in WSRR, so that it is available when any reports that reference it are run, see Deploying reports to WSRR. (If you are using another BIRT engine to run reports, then you must take steps to ensure that the library is available at run time).