Customizing printouts of issues

The Print button in the upper right corner of an issues form invokes the shell script rz_issue_print. By creating your own copy of rz_issue_print, and placing it earlier in your search path, you can override the default output format.

The default rz_issue_print script supplied as part of the Razor release resides in the $RAZOR_HOME/scripts directory. It is accompanied by a file rz_issue_print.awk which it expects to reside in the same directory. To utilize your own version of the script, it is suggested that you copy both of these files to the $RAZOR_UNIVERSE_DIR/Scripts directory. Since the rz_prep files automatically place this directory earlier in your search path, it will find and use this copy in preference to what comes with the release.

As supplied, the script parses the issue form into a very basic structure and sends it to the requesting client as simple ASCII. If you are content with the organization of the data on the printout then no modifications are necessary.¹

If you wish to generate your own output format, overhaul the script and its associated awk program as you see fit. The comments at the top of the existing file should be able to guide you fairly well as to what arguments are supplied to the script on invocation. Please bear in mind however that the script named rz_issue_print is also utilized as one of the default options on the Reports menu.

¹ Refer to "Printing customization" on page 217 for details on controlling the printed output destination.