Internationalization of the Portal

Internationalization can be achieved by providing translations of the following text elements:

• labels
• content of combo boxes
• messages

Elements of the Stardust Portal views are identified via entries in their according resource bundles. The resource bundle which is used depends on the preferred language set for your browser.

Resource Bundles

Resource bundles for languages are supplied for the Stardust Portal. They reside in the according portal JAR files, either in the add-ons/ipp-portal/lib folder of your Stardust installation, in case you set up your working environment as described in chapter Installing Stardust Features, or in the lib folder of the org.eclipse.stardust.ide.wst.facet.portal_xxx plugin:

• ipp-business-control-center.jar - for the Control Center Perspective
• ipp-administration-perpective.jar - for the Administration Perspective
• ipp-workflow-perspective.jar - for the Workflow Perspective
• stardust-web-modeler.jar - for the Modeling perspective
• ipp-views-common.jar - for the common views messages
• ipp-portal-common.jar - for the common Portal messages
• stardust-rules-manager.jar - for the Rules Manager
• stardust-web-reporting.jar - for the Reporting perspective
• stardust-reporting-rt.jar - for Web Reporting messages
• stardust-mobile-workflow.jar - for the Stardust Mobile usage

Unzip the according portal JAR file, copy the existing resource bundles and add the according language locale to the name (e.g. "_de"). E.g. for adapting messages displayed in the Control Center perspective:

1. Unzip the ipp-business-control-center.jar file.
2. Copy the business-control-center-messages.properties file and rename the copy to business-control-center-messages_locale.properties, whereby locale is the locale for the language you like to use. (Translated resource bundles are already provided for Chinese and German.)
3. Edit the business-control-center-messages_locale.properties and translate the entries accordingly.
4. Save the resource bundle and add it to the ipp-business-control-center.jar file.

Determine the locale to use for your Stardust Portal by setting the preferred language used for your browser.

Retrieving predefined Resource Bundles as JAR from the Artifactory

The Stardust artifactory provides a stardust-product-nls.jar file, which contains all available specific languages bundles for the different components. You can download this file from the following location:

https://infinity.sungard.com/repository/ipp-releases/org/eclipse/stardust/product/stardust-product-nls/

https://infinity.sungard.com/repository/ipp-releases/com/infinity/bpm/ipp-product-nls/

You can modify all containing property files and add these either as a new JAR file to the WEB-INF/lib folder or into WEB-INF/classes folder of your Web project if you like to overwrite an existing language. Putting the JAR file to the WEB-INF/classes folder ensures that the property files are loaded first, before the JAR files are scanned for the corresponding property files.

Using Languages with Multibyte Character Sets

In case you like to display your Stardust Portal in a language using multibyte character sets, like Chinese or Japanese, you have to perform some additional steps.

For example in case you like the Portal to be displayed in Chinese language code, perform the following steps:

1. Unzip the files from your according portal JAR file.
2. Translate the properties from the xxx.properties file to Chinese and add them to a new properties file called xxx_cn_source.properties.
3. Execute the following command:

   native2ascii -encoding gb2312 
       xxx_cn_source.properties BusinessControlCenterMessages_cn.properties