Page Comparison

Instead of searching through a list of locale keys, you can add the query string parameter ?langdebug=true to your EmpowerID web application URL , and interactively create or edit keys directly on the text as it appears in on the page.

Once enabled, the Locale Key Editor Enabled info box provides you with information on how to use the editor.

There are three things that you can accomplish using this editor.

• Create new keys — – This is for use by developers who are adding add new text to the UI. Developers can use this shortcut to add a key to correspond with a value in their code.

• Edit localized values for existing keys — keys – This is for use by administrators or authorized users who are adding translations of add the value for to other languages or editing edit existing translations.

• Edit localized values and add keys — – This is for use by administrators or authorized or authorized users who are adding add translations of the value for other languages when keys do not yet exist in the database.

In this topic, we explore how to add or edit localized text for existing keys and how to add keys for existing localized text. We cover how to create new keys in the developer documentation.

How to enable the Locale Key Editor

1. Navigate to the EmpowerID page with the text that you want to localize, and insert the query string parameter ?langdebug=true in the URL between /UI and #

1. in place of the slash. For example:
   
   https://sso.empoweriam.com/UI/#Common/Find/Person becomes https://sso.empoweriam.com/UI?langdebug=true#Common/Find/Person
   

2. The Locale Key Editor Enabled info box appears, and all localized strings are highlighted in yellow

1. or in orange if a localized value exists in the code

1. but no key exists in the database. 
   

Image Removed

1. Image Added

2. To see the locale key, hover your mouse over any text that is localized (highlighted in yellow).
   

   Image Modified

   
   

How to add or edit localized text for existing keys

1. While pressing the Ctrl key, click any yellow highlighted text.
   You should see the clicked text highlight change to green and an “Edit an existing locale key” dialog open.
   

   Image Modified

2. The default locale is English, so the Localized Value here is "People." You can customize this value. For example, your organization might prefer the term "Associate." Do do that simply replace the Localized Value with the preferred term and click Save. Do not change the Key Name field, as this is what connects the value to the proper place in the UI.
   

   Image Modified

   
   

3. To provide a translated value for another language, click the Locale drop-down and select the desired language.
   

   Image Modified

4. In the Localized Value box, enter your translation and click Save.

5. Once that language has a translation, you can choose another locale to translate. When you are finished, click Close. The translated text is highlighted green to show that it was the last edited key.

How to localize a value and add the key to the database

1. While pressing the Ctrl key, click any orange highlighted text.
   

Image Removed

1. Image Added

   
   The clicked text

1. highlights changes to green to indicate that it is being edited, and the Change or update a locale key dialog appears.
   

   Image Modified

2. Click Save. The localized text should now be in the database/

How to close the Locale Key Editor

1. Replace the query string parameter ?langdebug=true with a slash: / and press Enter. (Or simply navigate to another page.)

2. The Locale Key Editor Enabled info box disappears

1. , removing the highlights

1. from the text.