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