When starting with DNG and document generation or when deploying new reports on the server the RRDG log is an invaluable resource for troubleshooting problems on the RRDG server. As expected the log provides detailed information on errors and additional information including performance data.
All the DNG logs can be access at https://server:9443/rm/logs. The log for document generation is rrdg.log which is located towards the end of the list.
By default the RRDG log is set on WARN level which means only warnings and errors will be logged. This is the recommended setting for most production servers but if you need to troubleshoot document generation you should increase the level and set it to INFO.
If you are using the document generation UI in DNG’s 5.0.x and older to generate PDF documents the default option is to use RRDG’s so called “performance driver“. This driver is legacy and has far fewer capabilities than the alternative “sophisticated formatting” driver.
Considering the performance and quality of the output produced by the “sophisticated driver” you should always use that driver. This is enforced in DNG 6.0 by making “sophisticated formatting” the default option for the PDF output.
So what is the problem? The answer is in the Rational Quality Manager Reportable REST API Documentation. For efficiency reasons RQM does not return the link information by default. If you want to create traceability documents you’ll have to explicitly ask for the link information using the calmlinks argument in the request URL.
This is one the best, if not the best, education material I’ve seen for RPE and Rhapsody and it adds to Andy’s already long list of contributions to RPE. @Andy – thank you so much for all the help.
The training gives an introduction to RPE and continues with basic concepts before elaborating on advanced techniques. Everything is beautify explained and the concepts are introduced incrementally in a way that it is easy to follow and understand.
Overview of Rational Publishing Engine
Creating Basic Templates for Rhapsody
Formatting in RPE
Filtering and Conditions
Bookmarks and Hyperlinks
Creating Advanced Templates for Rhapsody
RPE in a Jazz Environment
Recursing Through Rhapsody Project Structures
Variables and ‘Looking Down the Tree’
Reporting on Multiple Rhapsody Projects
Up to date information and comments on RPE, Document Generation and Reporting