Defining Font Mappings

BI Publisher's Font Mapping feature enables you to map base fonts in RTF or PDF templates to target fonts to be used in the published document.

Font Mappings can be specified at the site or report level. Font mapping is performed only for PDF output and PowerPoint output.

There are two types of font mappings:

  • RTF Templates — for mapping fonts from RTF templates and XSL-FO templates to PDF and PowerPoint output fonts

  • PDF Templates — for mapping fonts from PDF templates to different PDF output fonts.

Making Fonts Available to BI Publisher

BI Publisher provides a set of Type1 fonts and a set of TrueType fonts. You can select any of the fonts in these sets as a target font with no additional setup required.

For a list of the predefined fonts see BI Publisher Predefined Fonts.

The predefined fonts are located in $JAVA_HOME/jre/lib/fonts. To map to another font, place the font in this directory to make it available to BI Publisher at run time. If the environment is clustered, then you must place the font on every server.

Setting Font Mapping at the Site Level or Report Level

A font mapping can be defined at the site level or the report level.

  • To set a mapping at the site level, select the Font Mappings link from the Administration page.

  • To set a mapping at the report level, view the Properties for the report, then select the Font Mappings tab. These settings apply to the selected report only.

The report-level settings take precedence over the site-level settings.

Creating a Font Mapping

From the Administration page, under Runtime Configuration, select Font Mappings.

To create a Font Mapping:
  1. Under RTF Templates or PDF Templates, select Add Font Mapping.

  2. Enter the following on the Add Font Mapping page:

    • Base Font — enter the font family to map to a new font. Example: Arial

    • Select the Style: Normal or Italic (Not applicable to PDF Template font mappings)

    • Select the Weight: Normal or Bold (Not applicable to PDF Template font mappings)

    • Select the Target Font Type: Type 1 or TrueType

    • Enter the Target Font

      If you selected TrueType, you can enter a specific numbered font in the collection. Enter the TrueType Collection (TTC) Number of the desired font.

      For a list of the predefined fonts see BI Publisher Predefined Fonts.

BI Publisher Predefined Fonts

The following Type1 fonts are built-in to Adobe Acrobat and BI Publisher provides a mapping for these fonts by default.

You can select any of these fonts as a target font with no additional setup required.

The Type1 fonts are listed in the table below.

Number Font Family Style Weight Font Name

1

serif

normal

normal

Time-Roman

1

serif

normal

bold

Times-Bold

1

serif

italic

normal

Times-Italic

1

serif

italic

bold

Times-BoldItalic

2

sans-serif

normal

normal

Helvetica

2

sans-serif

normal

bold

Helvetica-Bold

2

sans-serif

italic

normal

Helvetica-Oblique

2

sans-serif

italic

bold

Helvetica-BoldOblique

3

monospace

normal

normal

Courier

3

monospace

normal

bold

Courier-Bold

3

monospace

italic

normal

Courier-Oblique

3

monospace

italic

bold

Courier-BoldOblique

4

Courier

normal

normal

Courier

4

Courier

normal

bold

Courier-Bold

4

Courier

italic

normal

Courier-Oblique

4

Courier

italic

bold

Courier-BoldOblique

5

Helvetica

normal

normal

Helvetica

5

Helvetica

normal

bold

Helvetica-Bold

5

Helvetica

italic

normal

Helvetica-Oblique

5

Helvetica

italic

bold

Helvetica-BoldOblique

6

Times

normal

normal

Times

6

Times

normal

bold

Times-Bold

6

Times

italic

normal

Times-Italic

6

Times

italic

bold

Times-BoldItalic

7

Symbol

normal

normal

Symbol

8

ZapfDingbats

normal

normal

ZapfDingbats

The TrueType fonts are listed in the table below. All TrueType fonts are subset and embedded into PDF.

Number Font Family Name Style Weight Actual Font Actual Font Type

1

Albany WT

normal

normal

ALBANYWT.ttf

TrueType (Latin1 only)

2

Albany WT J

normal

normal

ALBANWTJ.ttf

TrueType (Japanese flavor)

3

Albany WT K

normal

normal

ALBANWTK.ttf

TrueType (Korean flavor)

4

Albany WT SC

normal

normal

ALBANWTS.ttf

TrueType (Simplified Chinese flavor)

5

Albany WT TC

normal

normal

ALBANWTT.ttf

TrueType (Traditional Chinese flavor)

6

Andale Duospace WT

normal

normal

ADUO.ttf

TrueType (Latin1 only, Fixed width)

6

Andale Duospace WT

bold

bold

ADUOB.ttf

TrueType (Latin1 only, Fixed width)

7

Andale Duospace WT J

normal

normal

ADUOJ.ttf

TrueType (Japanese flavor, Fixed width)

7

Andale Duospace WT J

bold

bold

ADUOJB.ttf

TrueType (Japanese flavor, Fixed width)

8

Andale Duospace WT K

normal

normal

ADUOK.ttf

TrueType (Korean flavor, Fixed width)

8

Andale Duospace WT K

bold

bold

ADUOKB.ttf

TrueType (Korean flavor, Fixed width)

9

Andale Duospace WT SC

normal

normal

ADUOSC.ttf

TrueType (Simplified Chinese flavor, Fixed width)

9

Andale Duospace WT SC

bold

bold

ADUOSCB.ttf

TrueType (Simplified Chinese flavor, Fixed width)

10

Andale Duospace WT TC

normal

normal

ADUOTC.ttf

TrueType (Traditional Chinese flavor, Fixed width)

10

Andale Duospace WT TC

bold

bold

ADUOTCB.ttf

TrueType (Traditional Chinese flavor, Fixed width)

Managing Custom Fonts

BI Publisher includes a standard set of fonts. Using manage custom fonts you can upload external fonts apart from the BI Publisher's inbuilt fonts.

To manage custom fonts
  1. Navigate to the Manage Custom Fonts section in Administration > Font Mappings page.
  2. Click Choose File and select the external font file.
    You have the option to either overwrite or delete the font files.
  3. To use the new font, define the font mapping for RTF or PDF template. See Defining Font Mappings.