17 Translating Catalog Objects, Data Models, and Templates

This chapter describes translating BI Publisher catalog objects, data models, and templates using the Export XLIFF function that is available at the catalog level.

This chapter includes the following sections:

17.1 Overview

This chapter describes how to use the Export XLIFF function that is available at the catalog level.

When you select a folder and choose this option, a single XLIFF file is generated that contains the translatable strings from the catalog objects contained in the folder; and the RTF and XPT templates contained in the folder. See the following section for the detailed list of what is translatable.

The target strings in the generated XLIFF file can be translated into the desired language. The XLIFF can then be uploaded back to the BI Publisher repository and assigned the appropriate locale. The translated strings from the XLIFF are displayed when a user selects the target language as their UI language (for catalog object strings) or selects the target language as their Report Locale (for report template strings).

If BI Publisher is integrated with Oracle Business Intelligence Enterprise Edition, then BI Publisher catalog object string translation (folder and report, data model, style template and sub template names) is ignored. The Oracle BI Enterprise Edition catalog translation mechanism is applied instead. See "Localizing Oracle Business Intelligence Deployments" in Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition for information about components that can be translated in an integrated catalog.

17.2 What Can Be Translated?

Table 17-1 shows what strings can be translated.

Table 17-1 Strings That Can Be Translated

Object What Can Be Translated Preference That Determines Translation Displayed

Folder

Name Description

UI Language (applies to all)

Data Model

Name Description Data Display Name

UI Language (applies to all)

Report

Name Description Layout Names Data Model Reference Parameter Name

UI Language (applies to all)

Style Template

Name Static text in the template

UI Language Report Locale

Sub Template

Name Static text in the template

UI Language Report Locale

BI Publisher Layouts (.xpt)

Static text in the layout

Report Locale

RTF Layouts

Static text in the layout

Report Locale


17.2.1 About Source Language Limitations

For catalog translation, the source language is limited to "en". You must create catalog and data model objects in English locale to be able to translate them.

17.3 Exporting the XLIFF File

To export an XLIFF file for a catalog folder:

  1. Select the folder in the catalog.

  2. Click the Translation toolbar button and then click Export XLIFF, as shown in Figure 17-1.

    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.

17.4 Identifying and Updating the Object Tags

For information on how to manually update the XLIFF files with translation strings, see Section 15.2.1, "What Is an XLIFF?"

In the XLIFF file generated for a catalog object, the source-language and target-language attributes contain values for the two-letter language code only, as shown in Figure 17-2.

Figure 17-2 Values for Two-Letter Language Code

Description of Figure 17-2 follows
Description of "Figure 17-2 Values for Two-Letter Language Code"

17.5 Importing the XLIFF File

When the target tags have been translated you are ready to import the XLIFF file back to BI Publisher.

To import an XLIFF file:

  1. Navigate to the folder from which the XLIFF file was generated.

  2. From the toolbar, click the Translation button and select Import XLIFF. This launches the Upload dialog shown in Figure 17-3.

    Figure 17-3 Upload Dialog

    Description of Figure 17-3 follows
    Description of "Figure 17-3 Upload Dialog"

  3. Click Browse to locate the translated file and then select the appropriate locale from the list.

  4. Click Upload.