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 top right portion of the banner and select Jazz Team Server Home.
  3. Click Jazz Team Server - Server Administration.
  4. Click on the Advanced Properties entry under Configuration.
  5. In the Advanced Properties tab, scroll down to the XSFLO Component section and click Edit
  6. 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 PDF rendering (Japanese) to MS Gothic.
  7. Click Save in the Advanced Properties page (at the top).
    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.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki