1. Configuring Oracle Analytics Cloud
  2. Advanced Configuration
  3. Customize and Configure Advanced Options
  4. Localize Custom Captions

Localize Custom Captions

You can localize custom captions for Classic catalog objects and for Data Visualization workbook captions.

Topics:

Localize Data Visualization Workbook Captions

You can localize the names of custom Data Visualization workbook captions. For example, you might localize a customized workbook name into Spanish and French.

See What languages does Oracle Analytics support?

To localize the names of Data Visualization workbook captions, you export captions for the Data Visualization workbook to a file, translate the captions, and then upload the translated captions back into the workbook. You must upload your translations to the same Oracle Analytics environment that you exported the captions from.

If you want to migrate caption localizations to a different Oracle Analytics environment, you can export your workbook captions to a snapshot and then import the snapshot on the target environment. Caption translations are included in the snapshot.

Topics:

Export Workbook Captions

You can export workbook captions so that they can be translated.

  1. On the Home page, click the Navigator, and then click Console.
  2. Click Translations.
  3. Click the Export tab.
  4. Expand Shared Folders, select the folder containing the Data Visualization workbook caption files to localize, for example, \Shared Folders\OAC_DV_SampleWorkbook.
  5. Click Export to download and save the exported captions.zip file, containing the .JS files that you want to localize, to the browser's download folder.

Localize Workbook Captions

After you have exported your Data Visualization workbook captions, you deliver the captions.zip file containing language-specific JS caption files for each supported language, to the localization team. For example, if you're localizing the French captions file, the file that you update might be named @/Shared/DataVizWorkbookFolderNameExample/WorkbookNameExample/NLS/fr/captions.js.

You and the localization team are responsible for resolving any errors in the translated text strings. Consider that the contents of the workbook are updated whenever objects are added, deleted, or modified.

  1. Browse to the workbook captions ZIP file that you exported, and extract the language-specific JS file that you want to update.
  2. Open the extracted language-specific JS file for editing.
  3. Enter translated names into the appropriate caption elements to replace the existing text strings.
    For example, if you created a visualization title caption in Canvas 2 named Sales performance by product category, you edit and replace the English text with the French translation which is Performance des ventes par categorie de produits.

    The French captions.js file before translation:
    Description of dv_localize_workbook_english.png follows
    Description of the illustration dv_localize_workbook_english.png

    The French captions.js file after translation:
    Description of dv_localize_workbook_french.png follows
    Description of the illustration dv_localize_workbook_french.png

  4. Save the updated language-specific JS file and then add it to the exported translated captions ZIP file.
  5. Optional: You can also use this method to import localized Classic catalog caption .XML files. You can add translated .XML files under the top level directory of the exported translated captions ZIP file. and zip them up together for import.
    For example:
    • ar/_shared_Common_captions.xml
    • cs/_shared_Common_captions.xml
    • ...
    • zh-TW/_shared_Common_captions.xml

Import Localized Workbook Captions

After you've localized your Data Visualization workbook captions in the required language, you deploy the language by uploading the translated ZIP file to the same Oracle Analytics environment that you exported the workbook captions from.

  1. In the Oracle Analytics Home page, click the Navigator, and then click Console.
  2. Click Translations and click the Import tab.
  3. Click Select a file or drop it here, and browse for, or drag and drop the ZIP file containing the translated JS file that you want to import.
  4. Click Import.
Oracle Analytics displays translated language-specific text strings in a browser that's suitably configured to use the correct captions file for the required language.

Localize Catalog Captions

You can localize the names of classic reporting objects that users create in the catalog. Object names are also known as captions. For example, you might localize the names of dashboards and analyses into Spanish and French.

See What languages does Oracle Analytics support?.

To localize captions for classic content, you export the captions from the catalog to a file, translate the captions, and then upload the localized captions back into the catalog. You must upload your translations to the same Oracle Analytics environment that you exported the captions from.

If you want to migrate caption localizations to a different Oracle Analytics environment, you can export your catalog to a snapshot and then import the snapshot on the target environment. Caption translations are included in the snapshot.

Export Captions from the Catalog

The following procedure describes how to export text strings in the catalog.

  1. In the Classic Home page, click the user profile icon and then click Administration.
  2. In the Manage Catalog Captions area, click Export Captions.
  3. Click Browse to display the Catalog browser, select the folder that contains the files you want to localize, and then click OK.
    For example, you might select \Shared Folders\Sample Report.
  4. In the Export Captions dialog, click OK to download and save the XML file in a local area.
    For example, if you select the file \Shared Folders\Sample Report, you’ll save a file locally named _shared_Sample Report_captions.xml.

Localize Your Captions

After you have exported your captions in an XML file, deliver the XML file to the localization team. For example, if you selected the Custom folder to download, you’ll deliver a file named _shared_Custom_captions.xml.

You and the localization team are responsible for resolving any errors in the translated text strings. Consider that the contents of the catalog are updated whenever objects are added, deleted, or modified.

The first illustration shows an extract from an exported caption XML file before translation. The file is named myfoldercaptions.xml. The second illustration shows an extract from the file after translation. The file is named myfoldercaptions_fr.xml.

Description of cat_exp_xml_en-png.png follows
Description of the illustration cat_exp_xml_en-png.png
Description of cat_exp_xml_fr-png.png follows
Description of the illustration cat_exp_xml_fr-png.png

Upload Localized Captions to the Catalog

After you've localized your captions in the required languages, you deploy the languages by uploading the translated XML files to the same Oracle Analytics environment that you exported the captions from. Use this procedure for each language.

  1. In the Classic Home page, click the user profile icon and then click Administration.
  2. In the Manage Catalog Captions area, click Import Captions.
  3. Click Browse, then navigate to and select the localized XML file, and click OK.
  4. Use the Select language option to select the language to which you’ve localized, then click OK.
    Imported XML files are copied to the MsgDb folder under the selected language.