Skip Headers
Oracle® Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher
11g Release 1 (11.1.1)

Part Number E22254-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

16 Translating Individual Templates

This chapter describes how to create and upload translated template files to provide translations for specific templates.

This chapter includes the following sections:

16.1 Overview

The following template types can be translated individually:

This chapter describes how to create and upload translated template files when you want to provide translations only for specific templates.

To translate the layouts within the broader scope of the catalog, see Chapter 17, "Translating Catalog Objects, Data Models, and Templates."

16.2 Types of Translations

There are two options for adding translations for templates:

Use the first option if the translated template requires a different layout from the original template

If you require only translation of the text strings of the template layout, then use the XLIFF option.

The diagrams in Figure 16-1 illustrate the translation concepts.

Figure 16-1 Translation Concepts

Description of Figure 16-1 follows
Description of "Figure 16-1 Translation Concepts"

16.3 Using the XLIFF Option

The following sections describe using the XLIFF option to translate files:

16.3.1 Generating the XLIFF from a Template

There are two methods for generating an XLIFF for a single template file, as described in the following sections:

16.3.1.1 Generating the XLIFF from the Template Builder

Note:

This procedure assumes that you have installed the BI Publisher Template Builder for Microsoft Word. See "Get Started," in the Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Publisher for information on downloading the add-in for Microsoft Word.

To generate an XLIFF from the Template Builder:

  1. Open the template in Microsoft Word with the Template Builder for Word installed.

  2. On the Template Builder tab, in the Tools group, click Translation, and then click Extract Text.

    BI Publisher extracts the translatable strings from the template and exports them to an XLIFF (.xlf file).

  3. Save the XLIFF to a local directory.

16.3.1.2 Generating the XLIFF from the Layout Properties Page

You can generate the XLIFF file for report layout templates or for style templates and subtemplates.

To generate the XLIFF file for report layout templates:

  1. Navigate to the report in the catalog and click Edit to open it for editing.

  2. From the thumbnail view of the report layouts, click the Properties link of the layout (RTF or XPT) to open the Layout Properties page.

  3. In the Translations region, click Extract Translation.

    BI Publisher extracts the translatable strings from the template and exports them to an XLIFF (.xlf) file.

  4. Save the XLIFF file to a local directory.

To generate the XLIFF file for style templates and subtemplates:

  1. Navigate to the style template or sub template in the catalog and click Edit to open the Template Manager.

  2. In the Translations region, click Extract Translation.

    BI Publisher extracts the translatable strings from the template and exports them to an XLIFF (.xlf) file.

  3. Save the XLIFF file to a local directory.

16.3.2 Translating the XLIFF

When you have downloaded the XLIFF file, it can be sent to a translation provider, or using a text editor, you can enter the translation for each string. See Section 15.2.2, "Structure of the XLIFF File" for instructions on how to edit the XLIFF file.

A "translatable string" is any text in the template that is intended for display in the published report, such as table headers and field labels. Text supplied at runtime from the data is not translatable, nor is any text that you supply in the Microsoft Word form fields.

You can translate the template XLIFF file into as many languages as desired and associate these translations to the original template. See Section 16.3.3, "Uploading the Translated XLIFF to BI Publisher."

16.3.3 Uploading the Translated XLIFF to BI Publisher

To upload the translated XLIFF:

  1. Navigate to the report, subtemplate, or style template in the catalog and click Edit to open it for editing.

    For reports only:

    From the thumbnail view of the report layouts, click the Properties link of the layout to open the Template Manager.

  2. In the Translations region, click the Upload toolbar button.

  3. In the Upload Translation File dialog (shown in Figure 16-2), locate the file in a local directory and select the Locale for this translation.

    Figure 16-2 Upload Translation File Dialog

    Description of Figure 16-2 follows
    Description of "Figure 16-2 Upload Translation File Dialog"

  4. Click OK to upload the file and view it in the Translations table.

16.4 Using the Localized Template Option

If you must design a different layout for the reports that you present for different localizations, then you can create a new RTF file that is designed and translated for the locale and upload this file to the Template Manager.

Note:

The localized template option is not supported for XPT templates.

The following sections describe using the localized template option:

16.4.1 Designing the Localized Template File

Use the same tools that you used to create the base template file, translating the strings and customizing the layout as desired for the locale.

16.4.2 Uploading the Localized Template to BI Publisher

To upload the localized template:

  1. Navigate to the report, subtemplate, or style template in the catalog and click Edit to open it for editing.

    For reports only:

    From the thumbnail view of the report layouts, click the Properties link of the layout to open the Template Manager.

  2. In the Templates region, click the Upload toolbar button.

  3. In the Upload Template File dialog (shown in Figure 16-3), locate the file in a local directory, select rtf as the Template Type and select the Locale for this template file.

    Figure 16-3 Upload Template File Dialog

    Description of Figure 16-3 follows
    Description of "Figure 16-3 Upload Template File Dialog"

  4. Click OK to upload the file and view it in the Templates table.