Flexible deployment using separate repository headers.
When a repository is deployed or simply transferred to another computer, the configuration and the location of external resources (files) may change. The resources affected are CLASSPATH entries, image files, documentation files and internationalisation configurations. ReportWeaver allows to store the templates in a format, that extracts configuration info into a separate file that can be customized for development and deployment. For deployment or transfer, this deployment header must be edited.
Please use "Save as deployable ..." in the file menu of the editor to split the template set into the configuration header and the actual template set. You will be asked for two filenames: the header takes the extension .rwdh (ReportWeaver Deployable Header) the data file takes the extension rwdt (ReportWeaver Deployable Templates)
The idea behind the deployable headers is that they can be easily adjusted. It is also possible to duplicate the header, configure it and then exchange the rwdt file only. This would be the recommended way for a situation where the reports are frequently changed and must be redeployed. To do this create a duplicate deployment header, change all the settings for deployment and put it into your set of files for deployment. Now you can add the rwdt file after editing without any reconfiguration.
The header is an xml file that can be edited using a text editor or xml editor. The file below is a typical example. The highlighted regions can be changed.
<?xml version="1.0" encoding="UTF-8"?> <reportweavertemplate version="11" terse="true" centralRepositoryPure="C:\tmp\test\locked.rwdt"> localRepositoryPure="C:\tmp\test\templates.rwdt" <mappings> <map from="c:\development\reporting" to="/usr/local/reports"/> </mappings> <connector name="com.qintsoft.joria.datasources.osjicurtain.gui.OSJICurtainConnector"/> <com.qintsoft.joria.datasources.osjicurtain.OSJICurtainSchema curtainFile="C:\tmp\test\schema.rsd"> <extraClasspath > <s>file:/C:/tmp/test/tclasses.jar</s> </extraClasspath> </com.qintsoft.joria.datasources.osjicurtain.OSJICurtainSchema> <internationalisation propertiesName="reporttexts" directory="C:\tmp\locales"/> </reportweavertemplate>
The meaning of the configurable tags:
|reportweavertemplate||localRepositoryPure||The name of the file that holds the actual templates.|
|centralRepositoryPure||Optional. The name of the file that contains the set of locked templates and resources. This is used in conjunction with overlays.|
|map||from||Defines a pattern that is applied to icon and report documentation files. To match, a file name must start with the pattern. Longer (more specific) patterns take precedence. There can be any number of file mappings, each defined in a map tag.|
|to||Defines a replacement for a file part.|
|com.qintsoft.joria.datasources...||curtainFile||The file path of the schema definition file.|
|extraClasspath||s||A list of urls that are added to the classpath when reportweaver is run. Please enclose each url in an <s> tag.|
|internationalisation||propertiesName||The name stem for internationalisation files.|
|directory||The directory where internationalisation files are stored.|
|Mapping file locations for deployment||Contents||Setting up the template set for overlays|