Running PDF or PS Reports with International Fonts in App Studio

How to:

Some international languages such as Chinese, Hebrew, and Thai require specific type-1 fonts in order to display NLS characters correctly in a PDF or PS report. The WebFOCUS Reporting Server uses the LANG=XXX value to read the pdfXXX.fmp file instead of the default pdf.fmp file so that the proper international PDF font that supports the NLS characters is used.

However, when you execute a procedure from an App Studio canvas, StyleSheet information is added to the request and the default font name in the associated StyleSheet (*.sty) file is used. The FONT attribute from the default StyleSheet overrides the PDF font information from the WebFOCUS Reporting Server, and therefore NLS characters may not display correctly. This can be corrected by changing the font from the App Studio tool, or editing the StyleSheet file.

Additionally, the embedded PDF viewer for a browser may not display NLS characters correctly. If the StyleSheet is already set to use an NLS compatible font, but NLS characters still do not display correctly, you can use font embedding with the fontuser.xml file, as described in Unicode PDF Output. Alternatively, you can configure your browser to use Adobe Reader instead of the native PDF viewer.

Procedure: How to Display NLS Characters Correctly in a PDF or PS Report in App Studio

To display NLS characters correctly in PDF or PS reports you execute from App Studio, you must edit the font attribute in the StyleSheet file, or change the font directly from the App Studio tool.

To change the font for a StyleSheet file (affects all reports that use the StyleSheet):

  1. Open the associated StyleSheet in a text editor.

    Unless you have selected a specific StyleSheet for a report, the default StyleSheet is always warm.sty.

    Note: StyleSheet files (*.sty) are located in the drive:\ibi\WebFOCUSnn\ibi_html\ibi_themes and drive:\ibi\AppStudionn\ibi_html\ibi_themes directories, where nn is your WebFOCUS release number.

  2. Find and change the "FONT=" line.

    The following image shows the default StyleSheet file (warm.sty) and the FONT attribute.


    StyleSheet file in Notepad showing FONT parameter

Procedure: How to Change the Font for a Specific Report in App Studio

  1. On the Report tab, in the Style group, with the Scope set to Report, change the font.
    The report should update immediately on the canvas with the selected font.

WebFOCUS

Feedback