Tasks for Localizing Oracle Business Intelligence Components

Localizing Oracle Business Intelligence 15-7

15.2.2 Localizing Oracle BI Presentation Catalog Captions

The Oracle BI Presentation Catalog stores objects that users create, such as analyses and dashboards. Text strings hold the names and descriptions of these objects. If you must localize text strings for the objects, then you can export the text strings from the catalog so that they can be translated. You then expose the strings when translation is complete. This section describes the steps in the process of localizing captions: ■ Section 15.2.2.1, Step 1: Understanding the Export Process ■ Section 15.2.2.2, Step 2: Exporting Text Strings in the Catalog ■ Section 15.2.2.3, Step 3: Editing Exported Strings in XML Files ■ Section 15.2.2.4, Step 4: Handling Duplicate Exported Text Strings ■ Section 15.2.2.5, Step 5: Exposing Text Strings in the Catalog

15.2.2.1 Step 1: Understanding the Export Process

The export process creates one XML file for every first-level subfolder in the shared folder, in the format foldernamecaptions.xml, where foldername is the name of the subfolder in the shared folder. Each XML file contains the text strings for all content in the corresponding first-level folder and its subfolders. For example, if the shared folder in the Oracle BI Presentation Catalog contains the first-level folders Marketing, Service, and Sales, then the export process creates three XML files: ■ marketingcaptions.xml ■ salescaptions.xml ■ servicecaptions.xml After the content is translated, you place these folders in their corresponding location in the following directory: ORACLE_ INSTANCE\bifoundation\OracleBIPresentationServicesComponent\coreapplication_ obipsn\msgdb\l_xx\captions The export process not only generates new XML files, but the process also modifies the catalog, inserting the appropriate message ID for each object. Presentation Services uses those message IDs to locate the newly translated text.

15.2.2.2 Step 2: Exporting Text Strings in the Catalog

The following procedure describes how to export text strings in the catalog. To export text strings in the catalog: 1. Back up the catalog before exporting from it. PostRequest Command PostRequest Y 5 Lang Profile Attribute LanguageCode Y 6 Table 15–1 Cont. Example of Settings in the Symbolic URL Parameters Applet Name Type Path Argument Value Append Sequence 15-8 System Administrators Guide for Oracle Business Intelligence Enterprise Edition Ensure that you run the export utility against the actual catalog, not against a copy of the catalog, because the export utility changes the properties of the objects in the catalog against which it runs. 2. In Catalog Manager, open the catalog in offline mode, because you might lack permission to modify all objects in online mode. 3. Select the folder that contains the strings to export. The utility runs against the files in that folder and all its subfolders. For example, the title Another Report in the analysis that is shown in Figure 15–1 can be exported for translation. Figure 15–1 Title in an Analysis for Export and Translation

4. From the Tools menu, select Export Captions.

5. Click Browse to select the location in which to write the output file, then click OK.

6. To export only new text strings and those that have been changed since the last export, select Only export new or changed strings.

7. To exclude the Description properties from the export, select Exclude

Descriptions .

8. Click OK.

The export process might take several minutes.

15.2.2.3 Step 3: Editing Exported Strings in XML Files

When the export process is complete, deliver the output XML file to the localization team. When editing XML files, use an editor that is designed for XML files. Ensure that you follow the encoding that is specified at the top of the XML file and that you escape