Overview

SAS Web Report Studio provides font selection lists for use with objects such as headers, footers, text objects, graphs, and tables. The selection of fonts provided for use with each object depends on the object and the contents of the following five files.

Note: This SAS note does not explain how to configure the display of special fonts in PDF reports. For information on that topic, see SAS Note 49401.

Prepare the local font files

You can make the following customizations to the font selection lists in SAS Web Report Studio.

• add fonts
• suppress fonts that are provided by the ServerFonts.xml and ClientFonts.xml files

Note: You cannot remove any of the fonts that are provided by the styles.xml file.

• localize fonts

To make these changes, you modify the LocalClientFonts.xml and LocalServerFonts.xml files. To create these local font files, navigate to the customer folder in the installation directory for SAS Web Report Studio. A typical location is SAS-configuration-directory \Lev1\Web\Applications\SASWebReportStudio4.x\customer

Depending on which font selection list that you want to customize, perform one or both of these tasks:

• Make a copy of the file named LocalServerFonts.xml.sample and name the copy LocalServerFonts.xml
• Make a copy of the file named LocalClientFonts.xml.sample and name the copy LocalClientFonts.xml.

Open the new file in a plain text editor, and make changes as explained in the next three sections.

After saving your changes, restart your web application server.

Add fonts

To add a font, you enter a new font element just above the </fonts> tag at the bottom of the local font file. Following is an example of a new font element.

The following table explains the font element attributes.

Suppress fonts

Each local font file includes in its comments a list of the predefined server or client fonts, depending on which local font file that you are editing. Use this list to determine which name to use in the suppress element. The name of the font is case sensitive.

To suppress a single font, you use the following syntax

To suppress multiple fonts, separate the font names with a comma.

To suppress all of the predefined fonts, you use the following syntax:

Localize the font selection list for headers, footers, text, tables, and graph titles

The font elements in the ClientFonts.xml file do not include a locale attribute, which means that all of the fonts in the file are used to populate the font selection lists for headers, footers, text, tables, and graph titles for all locales in which SAS Web Report Studio is running.

If you add a font element to the LocalClientFonts.xml file that includes a locale attribute, then only those font elements that also specify that locale attribute are subsequently used to populate the font selection lists. For this reason, you typically do not include the locale attribute when adding fonts to the LocalClientFonts.xml file.

If you do specify a locale attribute, then you must also include font elements for any font in the ClientFonts.xml file that you want to continue to use. For example, say that you want to add MS Gothic with a locale attribute and you also want to keep the predefined fonts Century Gothic and Tahoma. Your addition to the LocalClientFonts.xml file might look like this:

After you restart your web application server, the font selection lists for headers, footers, text, tables, and graph titles will include MS Gothic, Century Gothic, Tahoma, and the fonts from the localized styles.xml files.

Note: The fonts specified by the styles.xml file are always included, regardless of locale.

Localize the font selection list for graphs

Some of font elements in the ServerFonts.xml file do include the locale attribute. For example, here are two of the font elements from the ServerFonts.xml file:

So, if you are running in the Japanese ("ja,ja_JP") locale, then MS Mincho is stored with the report when you select Courier New from the font selection list. However, if you are running in the Chinese ("zh,zn_CN") or Chinese Singapore ("zh_SG) locale, then NSimSun is stored with the report when you select Courier New.

When adding a font element to the LocalServerFonts.xml file, be sure to specify the correct locale value for your environment. For example, if you are running in a Japanese locale, then the locale attribute value for your new font should be "ja,ja_JP".

Note: The fonts specified by the styles.xml file are always included, regardless of locale.

Font substitution

For the client fonts, if either the display font or the actual font is not available to the browser (for example, it is not installed or it is not installed in the expected location), then the browser chooses a substitution font. For the server fonts, Java manages the substitution.

Operating System and Release Information