EP: Language Settings & Language Issues – Overview & Solutions
When using the SAP Enterprise Portal (EP) within an NW Environment in a large organizational landscape business requirements may require different linguistic and language settings for multiple user bases.
Portal Languages & How They Are Maintained
Now regarding this scenario and the languages used in the Enterprise Portal there are a few important points to highlight. The language that the portal is displayed in depends on the following hierarchy, with the languages at the top of the list taking precedence over those at the bottom.
- Component (iview) language (defined in the portalapp.xml)
- Portal Mandatory language (defined in the prtDefault.properties)
- User language (defined in the user#s profile).
- Request language (defined by the browser).
- Portal Default language (defined in the prtDefault.properties)
- System Default language (default locale defined by the OS).
So for example, if you have your portal user language (as in point 3) set to German, but the language of the iView that is the logon page (as in point 1) set to English, that logon page will be displayed in English.
Wanting the Portal to use only one Language…keeping it simple
From a high level perspective let us refer to a sample scenario in which you want to keep configurations simple and use only one pre-defined user language base for all users e.g. English. (This can always be changed down the line if required).
- Login to the Portal Server.
- Navigate to the following path in the SAP installation directory \\usr\sap\SID\JID\j2ee\cluster\server0\apps\sap.com\irj\servlet_jsp\irj\root\WEB-INF\portal\system\properties
- Open the file ‘prtDefault.properties‘.
- Deactivate the default language settings of the portal by adding ‘#’ before the parameters as below.
- Add the following parameters to the file
- Save the file and restart the portal
The parameter ‘request.mandatorylanguage=en‘ will override the browser language settings of the end users and will display the contents in ‘en’ (English) only.
Defining & Installing Languages
The Enterprise Portal can holster and translate multiple strings and elements from the “default” out of the box language into a different language which is defined as “supported” in the locale service.
- To view the locale you can logon to the SAP NWA (Netweaver Administrator).
- Find and view the Portal Application & Service:
- From this point of access you can determine and configuration the language values for all relevant properties.
- Use NLS supported language abbreviations
- Enter abbreviations in lower case
- Use comma (,), semicolon (;), or space as separators.
- Any changes made require a restart of the service to come into affect.
- Restart the com.sap.portal.admin.wizardframework application.
Portal – Which Languages are supported?
The number of supported languages is diverse and lengthily and includes English, German, French, Dutch, Polish. You can view the full listing in the official help guidance documentation below:
- Supported Languages & Code Pages (Non-Unicode) http://help.sap.com/saphelp_nw73/helpdata/en/c1/ae563cd2ad4f0ce10000000a11402f/content.htm
I have a language translation issue…what do I need to check?
As with all issue scenarios the first process of troubleshooting follows the concept of simplification
If you encounter a language based issue there are a few avenues of analysis to follow.
- One key point to check and review is whether the issue is confined to one particular web browser platform. If you are able to reproduce the issue across all browsers e.g. IE, Chrome, Mozilla etc then this would signify the “Language Setting” itself needs troubleshooting as opposed to the environment in which it functions.
Is the issue for all users?
- Is adequate language translation not occurring for all users or a select few? If the issue is confined to a small user base here we could be dealing with language personalization setups
Some Elements of the Portal – Not Translated
In some cases across the Portal Landscape and through applications you might notice some elements and strings not being translated and this may be due to hard-coding. The recommendation here would be to analyze and review potential note fixes to determine if it is a noted issue.
Browser Overriding Portal Language.
In some instances upon logging into the Enterprise Portal (EP), LDAP Users without an explicitly defined language setting are presented with the incorrect language display for Portal elements. Instead the language returned by the Portal is derived from the Web Browser Platform.
The cause of such an occurrence would be browser caching and the recommendation would be to clear the Portal Caches and retest the behavior once the mandatory language steps (as above) have been followed correctly.
Remember when you are defining the language setting(s) for the Portal there are a wide range of difference factors and properties to consider. When we consider the Portal as a central conduit means of access to a vast collection of information, data and applications language setting discrepancies can come into affect quite easily if the right diligence is not pursued.
The first point of language setting and review comes into affect at the point of logging on so this can be used as a cross-reference point:
- Determining the Logon Language: https://help.sap.com/saphelp_nw74/helpdata/en/b3/f72651c294256ee10000000a445394/content.htm
If you face an issue with a language feel free to reach out to me:
Active SCN Forum Contributor – Follow Me @ http://scn.sap.com/people/troy.cronin2
hi Tony ,
nice article, need some small info , can we have and add local country specific languages also here,kindly let us know
Many thanks for the feedback.
In terms of country specific languages yes you can indeed.
The core note for supported languages is that of SAP Note: 1013521 - Configuration ofsupported languages within the portal.
You can find the full language over in terms of regions in the link below:
Let me know if you have anymore questions
Thanks. The user profile is the profile of portal or the backend system? please let me know
I also have to implent languge option on Sap Ep 7.3 logon page and once language selected by user and after authentication it should show the content in the same language selected at logon page for ex : English, Spanish and Portuguese.
Do you have step by step development approach pls suggest?
Thanks and Regards,
Ram Krishna Mishra
Thanks for your effort for sharing such good post.
My requirement is to implement multi-language in Portal (i.e English & Hindi).
However as per the above blog couple of questions raised, requesting your valuable inputs on this.
Defining Language Support in the Locale Service & Configuring the List of Available Languages.
Apart of this in do we need to do any changes in "prtDefault.properties" in WEB-INF folder or the above steps will suffice implementation of multi-language portal.