At a lower level than catalog translation, file translation allows you to translate only specific objects from the BI Publisher catalog. The objects you can translate are as follows:
RTF templates
Style templates
Subtemplates
BI Publisher templates (.XPT)
Using this technique, you will be able to provide translations in circumstances where the users want to consult only some reports in another language, or they want to send documents to the partners in different languages.
The way file translation is actually realized depends on another factor: whether the translated template needs another layout than the original template or not. In the first case, you must create another localized template, in the second case you'll use an XLIFF file, allowing you to translate only the text strings of the template.
This section will present concrete steps to follow in order to generate report translation for the cases listed as follows:
Same layout using BIP
Same layout using Template Builder for Word
Different layouts
Let's assume first that you only need the text strings of the layout template to be translated. In this case, follow the steps:
Open BI Publisher catalog.
Click on the Edit link under the report name you want to translate.
Click on the Properties link under the report layout to be translated, as shown in the following screenshot:
This will open the Properties page shown below:
Click on Extract translation to trigger the process that generates the XLIFF file.
Save the XLIFF file to a folder of your choice.
Update the XLIFF file by providing text between the
<target>
tags corresponding to the translated text from the<source>
tags as you can see in the following screenshot:Click on the Upload icon in the Translations section to get your translated XLIFF file into BIP:
In this way, when choosing Romanian as Report Locale, BI Publisher will apply the translation for this particular report layout template when viewing the report.
As mentioned earlier, the Template Builder for Word can be used to generate the XLIFF file. The steps required in this case are as follows:
Open the RTF layout template file using Word.
Go to the Translation | Extract Text... menu option on the toolbar. This will generate the XLIFF file.
Save the XLIFF file in a folder of your choice using the
.xlf
extension.Translate the text between the
<target>
tags providing translation for the text between the<source>
tags, and save your work:Go to the Translation | Preview Translation... menu option on the toolbar and choose the modified file to see the result, as shown in the following screenshot:
A good result means that your XLIFF file is correct and now you can proceed to upload it into BIP.
In BIP, click on the Upload icon in the Translations section, and browse for the saved XLIFF file in order to get your translation file into BIP.
Here are the steps to follow when different layouts are needed for different languages:
Design a brand new layout for your report. For example, here the columns have a different order than those in the original layout template and a column is missing. At the same time, the template text strings are translated:
Upload the template into BIP. Be careful to choose the appropriate Locale for your template, as shown in the following screenshot: