The Word and RPE templates examples used in this article are available in the CLM Templates Page of the RPE DevWorks wiki.
Using Word Stylesheets with DNG templates
Using Word stylesheets with your template allows you to keep a consistent look&feel and simplify the design and maintenance of the RPE templates.
To use Word stylesheets with the templates deployed in DNG you need to:
- use the same name for the stylesheet and the dta file. Use doc extension for the stylesheet
- copy the stylesheet in <Server Installation>\server\conf\rm\reporting\initialization\templates\word
- reinitialize the DNG publish service by making a request to https://clmserver:port/rm/publish/initialize
The RPE SVT team ( System Verification Test) performs periodically what we call a “long run” test of RPE. This test involves running a large number ( 6000) of remote document generations. The jobs are started using the RPE Launcher Command Line API.
The purpose of this test is to observe the stability of RPE and measure if any degradation of performance, which would indicate a resource leak, is observed over the duration of the tests.
When DNG’s “Generate a document style report” feature misbehaves you should go through the following actions:
- check rrdg.log for additional information. The log file is location is <SERVER_INSTALL>\server\logs\rrdg.log.
- delete/move the rrdg folder located in C:\Program Files\IBM\JazzTeamServer\server\tomcat\temp\rrc_reports\ See this technote for scenarios where this also helps. You do not need to stop the DNG server for this.
- create C:\Program Files\IBM\JazzTeamServer\server\tomcat\temp\rrc_reports\rrdg\ if missing and step #2 did not help. You do not need to stop the DNG server for this.
- reinitialize the RM Publish Service http://server:9443/rm/publish/initialize
One more thing to be aware of is the UAC Data Virtualization trap. If you use Document Studio to edit the DNG templates directly in the server installation make sure you run Document Studio.
A problem that I troubleshooted and resolved recently using the above techniques was DNG not running macros on my machine despite everything being in place for that. The rrdg.log gave the first clue:
Another source of Rational education in general and RPE in particular is the IBM Rational software channel on Slideshare. IBM Rational has posted +70 presentations and other documents that cover a wide set of products.
See below a list of slideshares relevant to reporting and RPE from IBM Rational and other sources:
When editing the example templates that ship with RPE or OOTB templates that ship with other products you might find that your changes are not visible in the point product and not even in Windows Explorer.
This is happening because of UAC data virtualization which basically means that Windows stores these files in a different location and only shows them to your user as being in the system folder.while all other user accounts will not “see” them.
Once you have a report that works well in RPE and produces a great document the next question for a report designer is how to make that template available to the end users. This is especially important for users of Web based tools like DNG/QM/RTC .
The solution is to deploy the RPE template in the point product and have it generated using RRDG. See RRDGvsRPE for an introduction of RRDG and how it relates to RPE.
The main advantage of deploying RPE templates in point products is that end users do not need to know about RPE, templates, data sources, URI and other technical details. Instead they will use the point product’s reporting UI for docgen, UI that should be more user friendly and use a terminology that is specific to the point product.
NOTE: you do not need to have RPE installed to deploy or use a template in DNG.
This article documents how to deploy an RRDG template that prints the content of a DNG module. The configuration used is RPE 18.104.22.168 with DNG 4.0.6
The view schema used by the DNG out of the box templates for printing views is internal and is not supported ( see RRC Reporting Wiki) which means that those templates can’t be customized. Thanks to Einar Karlsen for pointing this out.