Skip to main content

Localizing a UI form

3 Tasks

45 mins

 Visible to: All users
Intermediate
Pega Platform '24.2
User Experience
English

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
Application Developer author@gogoroad pega123!
Note: The challenge walkthrough video is coming soon.

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Detailed Tasks

1 Create a translation pack

  1. In the Pega instance for the challenge, enter the following credentials:
    1. In the User name field, enter author@gogoroad.
    2. In the Password field, enter pega123!.
  2. In navigation pane of App Studio, click Settings > Localization
  3. On the Localization landing page, on the Translation packs tab, click New to create a new translation pack.
  4. In the New translation dialog box, click Add language.
    New translation dialog box
  5. In the language list, select Spanish ES (United States).
    Note: If you have Pega GenAI enabled, a second checkbox will display for the selected language. Select the Localize with GenAI checkbox to pre-translate your content using generative AI. For more information on using Pega GenAI in localization, see Pre-translating your application with GenAI in Constellation. 
  6. Click Next to proceed to the next step.
    New translation dialog box Spanish
  7. Once the translation pack has been created, click Download > Download as Excel to download the zip file.
    New translation dialog box download excel
  8. Click Done to close the dialog box. The Spanish ES (United States) language pack appears in the Translated packs tab.

2 Edit the translation package

  1. Extract the contents of the translation package to your local drive. The translation package decompresses to a folder named <LanguageSelectedForTranslation>_Translation_excel (for example, es-US_Translation_excel).
  2. In the decompressed folder, open the GoGoRoad-es-US.xlsx file.
    Note: If using Microsoft Excel 2003 or later, you can edit this file by clicking the Enable Editing button when the spreadsheet first opens.
  3. In the spreadsheet file, locate each English-language field value and rule key pair that is listed in the following table, and enter the Spanish text in the Translated string es-US column:
    Field Value Rule Key Spanish text
    Name GOGO-GOGOROAD-WORK-NEWVENDOR!VIEW!CREATE Nombre
    Street GOGO-GOGOROAD-WORK-NEWVENDOR!VIEW!CREATE Calle
    City GOGO-GOGOROAD-WORK-NEWVENDOR!VIEW!CREATE Ciudad
    State GOGO-GOGOROAD-WORK-NEWVENDOR!VIEW!CREATE Estado
    Note: If you do not have access to Microsoft Excel, you can use an alternative spreadsheet editor or download the JSON file instead.
  4. Save the Excel file to commit your translations.
  5. After the desired translations are complete, repackage the parent folder as a .zip archive.
    Note: The localization wizard does not allow uploading .zip folders with spaces in the folder name.

3 Import the translation pack

  1. In the Localization landing page, in the Translation packs tab, to the right of the Spanish ES (United States) translation pack, click Actions > Import translation to upload your file.
  2. In the Import translation dialog box, click Choose a file and select the updated translation package you created in the previous steps.
  3. Click Next to import the translation pack.
    Note: It may take several minutes to import the translation file.
  4. Click Done to close the Import translation dialog box. The status of the translation changes to Resolved.
    Resolved translation

Confirm your work

  1. In the navigation pane of Dev Studio, click the User icon > Operator to open the author@gogoroad operator record.
  2. In the Localization section, in the Default locale field, enter es_US to change the locale settings for the current operator.
  3. Click Save.
    Note: You may need to log out and log back into the application for the locale change to take effect.
  4. 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 case with Spanish fields
  5. In the author@gogoroad operator record, change the Default locale to en_US and click Save.
  6. Create a new Vendor Case and verify the field labels are in English.
    Note: This challenge does not have autograding validations.

This Challenge is to practice what you learned in the following Module:

Available in the following mission:

Return to mission
If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

Yes
No

Want to help us improve this content?
Suggest an edit

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