Fixing invalid characters in PDF files of test artifacts

To save test artifacts to a localized PDF file, the correct language fonts must be installed and configured otherwise pound signs (#) will be replace characters/glyphs in IBM® Engineering Test Management.

Before you begin

The system in which Engineering Test Management is installed must contain the required fonts for the target PDF language, the font must be installed in the system's font directory, and the font must be a true type font (.ttf) file, not a true type collection (.ttc) file.

About this task

Note: If a font is missing a character/glyph, it is replaced with the "#" symbol when viewing the PDF. Your browser window should be set to the language to use for the PDF file when exporting the test artifact.

The Jazz Server Administrator must specify the required font for each locale that will be generating PDFs in the Advanced Properties page of Engineering Test Management as follows:

Procedure

  1. Query the English font name to determine the font used by the server for the language you wish to print the pdf. For example, if you want the PDF file in Chinese and Jazz server is installed in linux, you would execute command 'fc-list :lang=zh' to query which Chinese font is installed in the current server.
  2. Click the Administration (Administration) icon in the banner and select Manage Application.
  3. Click on the Advanced Properties entry under Configuration.
  4. In the Advanced Properties tab, scroll down to the com.ibm.rqm.print.render.fop.FopDocumentRenderingService section and click Edit
  5. In the field for the particular language you want, set the default font using the English font name.
    The name that is specified must be the True Type font name in English for a given font, and the font must contain the necessary glyphs.
    For example, if you want the PDF file in Japanese, you would set the Default font for Default Japanese Font to MS Gothic.
  6. Click Save in the Advanced Properties page.
    Note: Your browser window should be set to the language to use for the PDF file when exporting the test artifact.

Results

The generated PDF files should now contain the correct characters for the language.