Oracle Business Intelligence Infrastructure Installation and Configuration Guide > Localizing Oracle Business Intelligence Deployments > Adding Converted Fonts to the Charting Image Server >

Adding Additional Converted Fonts to the Charting Image Server

This task shows how to enable additional fonts for charting.

The file OracleBI_HOME\web\config\chartfontmapping.xml specifies the name of a charting font to choose for any specified locale. The structure of this file is as follows:

   <fontMapping name="[display name]">
      <choose>
         <when locale="en*"><font name="[font name]"/></when>
      </choose>
   </fontMapping>

The parameters in the chartfontmapping.xml file are defined as follows:

• Locale (in quote marks). The locale code (see the topic LOCALE).
• Font name. The name given during the procedure "To convert a font using the Corda Font Converter."
• fontMapping name. The display name of the font Family; for example: Arial.

The following examples show how this file can be used:

   <fontMapping name="Arial">
      <choose>
         <when locale="en*"><font name="Helvetica"/></when>
      </choose>
   </fontMapping>
   
   <fontMapping name="Courier New">
      <choose>
         <when locale="en*"><font name="Courier"/></when>
      </choose>
   </fontMapping>
   
   <fontMapping name="Garamond">
      <choose>
         <when locale="en*"><font name="Lucida Bright"/></when>
   </choose>
   </fontMapping>

Wildcards can be used to specify more than one fontMapping name or locale, as shown in this example:

   <fontMapping name="*">
      <choose>
         <when locale="en*"><font name="Helvetica"/></when>
         <when locale="zh-tw"><font name="Albany WT TC"/></when>
         <when locale="zh*"><font name="Albany WT SC"/></when>
         <when locale="ja*"><font name="Albany WT J"/></when>
         <when locale="ko*"><font name="Albany WT K"/></when>
         <when locale="*"><font name="Albany WT"/></when>
      </choose>
   </fontMapping>

The preceding example means that for any fontMapping name, the given fonts defaults when the locale is one of the first five locales listed; for all other locales, the default font is Albany WT.

Another example of specifying a particular font for a specific locale is the following:

   <fontMapping name="*">
       <choose>
          <when locale="en*"><font name="Helvetica"/></when>
          <when locale="ja"><font name="JPNFont"/></when>
          <when locale="*"><font name="Unicode"/></when>
      </choose>
   </fontMapping>

The following procedure shows how to modify the chartfontmapping.xml to add specific charting fonts for specified locales.

To add a converted font to the image server

1. In a text or XML editor, open the chartfontmapping.xml file.
2. Add the locale code, font name, and font mapping name as shown in the preceding examples.
3. Save and close the chartfontmapping.xml file.
4. Stop and restart the Oracle BI Presentation Services and the Oracle BI Java Host services in order to see the changes.