Using the XLIFF Option

The XLIFF option is used to translate files.

The following sections describe using the XLIFF option:

Generating the XLIFF from a Template

These sections describe the two methods for generating an XLIFF for a single template file.

Generating the XLIFF from the Template Builder

Follow these steps to generate the XLIFF from the template builder.

Note:

This procedure assumes that you have installed the BI Publisher Template Builder for Microsoft Word. See Creating RTF Templates Using the Template Builder for Word 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.

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.

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 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 Uploading the Translated XLIFF to BI Publisher.

Note:

Ensure that when you save your translated file, you save it with UTF-8 encoding.

Uploading the Translated XLIFF to BI Publisher

Once a XLIFF file is translated, it needs to be uploaded 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, locate the file in a local directory and select the Locale for this translation.
  4. Click OK to upload the file and view it in the Translations table.