Module Quiz

Localizing Constellation DX components

Provide multi-language support for your Constellation DX component by integrating it with out-of-the-box Constellation localization features.

Note: To complete the knowledge check and module quiz, you must go through the links mentioned in this topic.

When developing Constellation DX components, the components have static data embedded in their code that must be translated into the languages that the application supports. Because of this need, it is important to integrate your Constellation DX components with the default localization wizard in App Studio. Doing this provides a clean separation between your application's localization needs and your component implementation, enabling the addition of new translations without requiring your component to be updated and redeployed.

Localizing a Constellation DX component

Note: The following content, referenced from Pega Documentation, is included here to help you better achieve the module learning objectives.

Provide multi-language support for your standalone Constellation DX component by integrating it with out-of-the-box Constellation localization features.

To ensure that your standalone Constellation DX components are properly localized,

integrate your component with the appropriate localization APIs
externalize your static string data into a component-specific localizations.json file

Your localizations.json file must be added to your component’s root folder to ensure that it is packaged with your component when the component is published.

The following code contains an example of a localizations.json file:

{
  "fields": {
    "Edit": "Edit",
    "Navigate to step": "Navigate to step"
  }
}

For more information about localizing your Constellation application, see Internationalization and localization.

Commonly used APIs for localization

The following APIs are commonly used to enable localization in your component:

Class	API	Description
Directly accessed	getPConnect().getLocalizedValue	Obtains the localized value of a string.
LocaleUtils	PCore.getLocaleUtils().getLocaleValue	Obtains the localized value of a string from the localization store.

Check your knowledge with the following interaction:

This Topic is available in the following Module:

Localization v1

Module Quiz

Get help

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

Did you find this content helpful?

Yes

Want to help us improve this content?

Suggest an edit

Localizing Constellation DX components

Localizing a Constellation DX component

Commonly used APIs for localization

This Topic is available in the following Module:

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