Skip to main content

Localizing a UI form

Archived

3 Tasks

45 mins

Visible to: All users
Beginner
Pega Platform 8.6
User Experience
English
This content is now archived and is no longer updated. Progress is not calculated. Pega Cloud instances are disabled, and badges are no longer awarded. Click here to continue your progress in the latest version.

Scenario

GoGoRoad stakeholders have a requirement to translate the New vendor case type to Spanish.

Use the Localization wizard to localize the New vendor case type of the GoGoRoad application, export the files, translate properties on a UI form into Spanish, import the files, set the locale settings, and test the translated form.

The following table provides the credentials you need to complete the challenge.

Role User name Password
System Architect author@gogoroad pega123!
Note: Your practice environment may support the completion of multiple challenges. As a result, the configuration shown in the challenge walkthrough may not match your environment exactly.

Challenge Walkthrough

Detailed Tasks

1 Run the Localization wizard

  1. In the header of Dev Studio, click Configure > User Interface > Application readiness > Localization> Translate to new language to start the translation process.
  2. In the Select a Language drop-down list, select Spanish ES, and click Add.
  3. Click Next to proceed to the next step.
  4. Click Next.
    Note: If a No unlocked rulesets available message displays, close the message window and deselect and select the GoGoRoad ruleset.
  5. Click Enable records for translation to set the localize flag on each record.
    Enable records for translation
    Note: Translation script completion may take a few minutes. The count of enabled records may vary as your practice environment supports the completion of multiple challenges.
  6. Click Next.
  7. Click Download for translation to create the translation pack.
    Note: This may take several minutes. The translation pack automatically downloads to your default Downloads folder.
  8. Click Next.
  9. Save the Work ID of the translation in progress into a text editor for further reference and click Close to close the Localization wizard.

    Note: If the application is translated into multiple languages or if the wizard is executed more than once, you will need the Work ID because there will be more than one Work ID to choose from when you import the translation pack.

2 Edit the TextToTranslate.xml file

  1. Extract the contents of the translation package to your local drive. The translation package decompresses to a folder named Translation_<LanguageSelectedForTranslation>_<DateArchiveCreated>_<TimeStamp> (for example,Translation_Spanish_2021-03-05_15-37-29).
  2. In the TranslationFiles folder, open the TextToTranslate.xml file.
    Note: Using Microsoft Excel 2003 or later, you can edit this file by clicking the Enable Editing button when the spreadsheet first opens.
  3. Enter the Spanish text in column B (Translation) for the labels listed in the following table.
    English terms Spanish term
    Name Nombre
    Street Calle
    City Ciudad
    State Estado
    Latitude Latitud
    Longitude Longitud
  4. Save the TextToTranslate.xml file to commit your translations.
    Note: Do not change the name of the TextToTranslate.xml file. The translation wizard looks for this exact name during the import process.
  5. After the desired translations are complete, repackage the parent folder as a .zip archive.

3 Import the translation pack

  1. In the header of Dev Studio, click Configure > User Interface > Application readiness > Localization> Translations in progress to upload your file.
  2. Select the appropriate translation Work ID that you noted when running the Translation wizard.
  3. Select the GoGoRoad (Spanish) and enter 01-01-01 as the ruleset version to which you want to save the translations.
    Note: If you pick a non-localized ruleset, the wizard creates a new localized ruleset and version. If the ruleset already exists, the wizard imports translations to the existing localized ruleset.
  4. For the HTML paragraphs, correspondences, and Correspondence Fragments, enter 01-01-01 as the ruleset version.
  5. Click Next.
  6. Click Choose File and select the updated translation package you created in the previous steps.
  7. Click Next to import the translation pack.
    Note: It may take several minutes to import the translation file.
  8. Click Finish and then click Close to close the Localization wizard.

Confirm your work

  1. In the header of Dev Studio, click Configure > User Interface > Application readiness > Localization > Locale Settings.
  2. From the Use Locale drop-down list, select Spanish (Spain) and click Update.
  3. Return to the GoGoRoad application and create a New vendor case. When the UI form is displayed, verify the field labels are translated as shown in the following image.
    New vendor localized screen
               
  4. Change the Locale Settings back to ingles (Estados Unidos) and click Update.
  5. Create a new Vendor case and verify the field labels are in English.

      



Available in the following missions:

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice