Performing Translations
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Objectives
After completing this module, you should be able to do the
following:
• Describe the types of translations and options available
within BI Publisher for performing translations
• Create a localized template for translations by using
Template Builder
• Create a translation file by using the BI Publisher
Enterprise Edition
10 - 2
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Introducing Translation Types
•
Two types of translations:
– Localized Template (or Layout): A separate, translated RTFbased template
– XML Localization Interchange File Format (XLIFF):
Generated from the original template
•
File types that can be translated include:
–
–
–
–
10 - 3
RTF layout files
Style Templates
Sub Templates
BI Publisher layout files (.xpt)
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Translating by Using a Localized Template
RTF Localized
Template Option
10 - 4
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Using the Localized Template Option: Process
Overview
1. Design the localized RTF layout template, Sub Template,
or Style Template.
2. Upload the localized file to Template Manager.
10 - 5
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Step 1: Designing the Localized Template
Edit the report and
make the appropriate
entries.
10 - 6
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Step 2: Uploading the Localized File to Template
Manager
1
10 - 7
2
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Translating by Using an XLIFF
XLIFF File Option
10 - 8
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
The Structure of an XLIFF File
Excerpt from an
XLIFF file that
has not been
translated
10 - 9
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
XLIFF File Attributes
Source/targetlanguage
codes
Table of
translations
example
Translation
(Language/Territory)
source-language
examples
target-language examples
From English/US to
English/Canada
en-US
en-CA
From English/US to
Chinese/China
en-US
zh-CN
From Japanese/Japan to
French/France
ja-JP
fr-FR
10 - 10
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
XLIFF File Embedded Data Fields
10 - 11
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
XLIFF File Elements
Original example
updated with
Chinese translation
Original example:
<source> and
<target>
10 - 12
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Using the XLIFF Option: Process Overview
1. Generate the XLIFF from the RTF or BI Publisher (XPT)
template.
– Two methods for generating the XLIFF for a single template
file:
—
—
Generate the XLIFF by using Template Builder for MS Word
(not supported for XPT templates)
Generate the XLIFF from the Layout Properties page
2. Translate the strings.
3. Preview by using Template Builder.
4. Upload the translation.
10 - 13
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Step 1: Generating the XLIFF by Using Template
Builder (Method 1)
1
2
3
10 - 14
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Step 1: Generating the XLIFF from the Layout
Properties Page (Method 2)
1
3
2
4
10 - 15
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Step 2: Translating the Strings
10 - 16
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Step 3: Previewing by Using Template Builder
10 - 17
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Step 3: Previewing by Using Template Builder
10 - 18
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Step 4: Uploading the Translation
1
2
3
10 - 19
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Managing XLIFF Translations on BI Publisher
Server
Two methods:
• Template translation: Extract and upload a separate
localized translation for RTF Templates.
• Catalog translation: Extract and upload translations for all
objects in a selected Catalog folder, into a single XLIFF
file.
10 - 20
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
The Overall Translation Process
1. You extract translatable strings for a Catalog or template
translation.
2. BI Publisher creates an XLIFF file.
3. Strings are translated locally.
4. Upload the translated XLIFF file to the Catalog or template.
5. Assign the appropriate locale.
10 - 21
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Catalog Translations
Use the Export XLIFF command at the Catalog level to export
the following objects:
• Folder
• Data Model
• Report Style Templates
• Sub Templates
• BI Publisher Layouts (XPT)
• RTF Layouts
10 - 22
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
User Preferences
Based on Report
Locale and UI
Language
10 - 24
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Exporting the XLIFF File for a Catalog Folder
2
1
3
10 - 25
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Viewing the Exported XLIFF File
10 - 26
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Importing the XLIFF File for a Catalog Folder
2
1
3
10 - 27
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Locale Selection Logic at Run Time
Translation is applied based on the user’s selected Report
Locale as follows:
Match on
an RTF
localespecific
template, if
no match
10 - 28
Match on
localespecific
XLIFF file,
if no match
Match on
languagespecific
XLIFF file,
if no match
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Use default
template
Summary
In this module, you should have learned how to:
• Describe the types of translations and options available
within BI Publisher for performing translations
• Create a localized template for translations by using
Template Builder
• Create a translation file by using the BI Publisher
Enterprise Edition
10 - 29
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Practice 10: Overview
This practice covers the following topics:
• Uploading a localized template to Template Manager
• Generating and uploading and XLIFF translation
10 - 30
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Quiz: Overview
This quiz examines your knowledge of the concepts discussed
in the lesson.
10 - 31
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Quiz
You use Catalog translation when you only need the final report
documents translated.
a. True
b. False
10 - 32
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Quiz
When you extract the translatable strings for a Catalog or
template translation, BI Publisher creates an XLIFF file that
contains the strings to be translated.
a. True
b. False
10 - 33
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Quiz
BI Publisher applies a translation based on the user's Report
Locale setting. BI Publisher tries to match an RTF template
named for the locale, followed by an attempt to match an XLIFF
file named for the locale.
a. True
b. False
10 - 34
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.
Quiz
Catalog translation enables the extraction of translatable strings
from all objects contained in a selected Catalog folder into a
single translation file.
a. True
b. False
10 - 35
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.