Templates must be published in specific locations for Report Studio to be able to display them. Report Studio displays templates by categories. When you publish a template, you can create a new category or select an existing category in which to display your template.
You can, for example, organize templates by report types (budget reports, expense reports, stock purchase plan reports) or by departments in your organization (Human Resources, Sales, Customer Support). Figure 4‑12 shows an example of Report Studio displaying additional categories by report types.
The Standard category appears at the top of the list because it is the default category supplied with Report Studio. All other categories that you create are listed in alphabetical order. You can designate a different template category as the default category, as described later in this section.
Typically, each template uses the following external resources that you must also publish to a specific location:
An image file that functions as the thumbnail image of the template
A library file containing the themes available to the report
If a template contains localized text and you have created resource files that translate text into different languages, you must also publish these (.properties) files. You publish all resources associated with a template when publishing the template.
Figure 4‑12 Displaying available template categories in Report Studio
Template files must be copied to the appropriate folders under the BizRDRptTemplates folder. You must have direct access to the machine on which Actuate Java Components runs, because you need to manually place the template files in the following location on the file system:
<context root>\resources\BizRDRptTemplates
All resources used by a template must be copied to the Actuate Java Components resource folder in the following location:
<context root>\resources
How to publish a report template and associated resources
1 Decompress the Actuate BIRT Java Component war file to a temporary location, using the following command:
jar -xf <Actuate BIRT Java Component archive name>
Make sure that files from the web archive were extracted.
2 Delete the original compressed archive file from the temporary directory.
3 In the folder containing the decompressed files, navigate to the following directory:
<context root>\resources\BizRDTemplates
4 Create the proper folder structure on the machine where Actuate BIRT Java Components runs. Do one of the following:
To organize the templates in categories, create one folder in the BizRDRptTemplates folder for each category. For example, to display templates in categories named Budget Reports and Expense Reports, create the following folders:
5 Place any resources associated with the template, such as image files, library (.rptlibrary) files, or properties (.properties) files in the following location:
<context root>\resources
6 Navigate to the temporary folder you created.
7 Compress the Actuate BIRT Java Component web archive file using the following command:
jar -cf <Actuate BIRT Java Component archive name> *
Once the web archive file is created, follow the process to deploy the file to your web server.
8 Restart your computer. Then, restart the web service.
9 Launch Report Studio, and create a new report to view the template categories you created.
An image file that functions as the thumbnail image of the template