Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Creating a translation package

Updated on December 13, 2022
Applicable to Theme Cosmos applications

Expand the user base of your application by translating it into different languages. By creating a translation package, you bundle all the text in your application into a single .zip file, which translators can then process more conveniently.

The system exports the majority of the text in your application to a TextToTranslate.xml file. The file does not include custom rules, such as correspondence rules and HTML fragments. For each of these rules, the system creates a separate folder with a pair of files called Translation.html and Base.html. Both files initially contain the same text, but during the localization process, the translator puts the target text into the Translation.html file.

Note: If you use a language pack, you typically translate only application layer rulesets, which saves translation effort. For more information, see Installing Pega language packs.
  1. In the header of Dev Studio, click ConfigureUser InterfaceApplication readinessLocalizationTranslate to new language.
  2. In the Select a Language list, pick a target language, and then click Add.
    You can select more than one language.
  3. If your application already has a translation, select the Re-translate existing translations? check box to overwrite the previous translation.
  4. Click Next.
  5. Select the rulesets that represent the text that you want to localize:
    Application-specific text
    1. Select the Include application layer ruleset check box.
    2. In the list of rulesets, select the rulesets that you want to include in the translation package.
    General Pega text: no language pack
    1. Select the Include all PegaRULES application rulesets check box.
    2. Select the Include Pega translation and export for custom translation check box.
    General Pega text: rewriting the language pack translation
    1. Select the Include all PegaRULES application rulesets check box.
    2. Select the Override Pega translation and export for custom translation check box.
    Text from another rulesetSelect Include field value from other rulesets, and then select the source ruleset.
  6. Click Next.
  7. Click Enable records for translation.
    The wizard might display a list of errors related to ruleset dependencies and custom code. You can click on a rule to open it in a new tab and resolve the error. For custom code, such as HTML fragments, you can use the getLocalizedTextForString(String, String) method to make the code translatable.
  8. Click Next.
  9. Select whether you want to include example files in the translation package.
  10. Click Download for translation, and then click Next.
  11. Note the Work ID number for the translation, and then click Close.
    The Work ID number helps you identify the translation task when the translation package is ready.
What to do next: Prepare the translation file for localization. For more information, see Preparing a translation package for a translator.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us