Skip to main content

Localizing a UI form

3 Aufgaben

45 Min.

 Visible to: All users
Mittel
Pega Platform '24.2
User Experience
Englisch
Prüfen Sie die Version, um sicherzustellen, dass Sie mit dem richtigen Inhalt arbeiten, oder schließen Sie die neueste Version ab.

Szenario

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!
Hinweis: 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.

Sie müssen zum Abschließen dieser Challenge Ihre eigene Pega-Instanz starten.

Die Initialisierung kann bis zu 5 Minuten dauern, bitte haben Sie Geduld.

Challenge-Schritte

Genaue Übungsschritte

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).
    Hinweis: 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.
    Hinweis: 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
    Hinweis: 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.
    Hinweis: 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.
    Hinweis: 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

Arbeit überprüfen

  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.
    Hinweis: 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.
    Hinweis: This challenge does not have autograding validations.

In dieser Challenge üben Sie, was Sie im folgenden Modul gelernt haben:

In der folgenden Mission verfügbar:

Zur Mission zurückkehren Mission fortsetzen
Wenn Probleme mit den Lerninhalten auftreten, lesen Sie bitte die Pega Academy Support FAQs.

Fanden Sie diesen Inhalt hilfreich?

Ja
Nein

Möchten Sie uns dabei helfen, diesen Inhalt zu verbessern?
Änderung vorschlagen

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