Enterprise Administration > Implementing Windchill ESI > Implementing Windchill ESI in an SAP Environment > Internationalization Considerations
  
Internationalization Considerations
This section describes the internationalization design considerations provided by Windchill ESI. You need to be aware of these when deploying Windchill ESI in an environment that traverses international boundaries.
Windchill ESI manages language data on a per transaction basis. Windchill ESI service detects an appropriate language fromWindchill PDMLink and communicates it to EAI software components via the JMS header property com_infoengine_locale that is sent with the Windchill ESI response message. Windchill EAI software components set this language for all subsequent sub-transaction requests toWindchill PDMLink or to the enterprise system. Windchill ESI Services get the language from the Change Administrator III's preferred language, if set, otherwise it uses the Windchill method server language.
Supported Languages and Locales
Windchill ESI supports eight languages and ten locales. These values map to nine unique SAP free text language key codes. All initialWindchill ESI messages are provided in theWindchill ESI supported languages listed in the following table. A systems integrator can localize these for additional locales and languages.
* 
All PTC-developed code-level language is in U.S. English only.
Country
Locale Description
Windchill Language
Windchill Locale Value (Setting for com_ infoengine_ locale)
SAP Language
SAP Language Value
United States
English
English
en_US
English
EN
Great Britain
English
English
en_GB
English
EN
Japan
Japanese
Japanese
ja
Japanese
JA
Taiwan
Chinese
Chinese
zh_TW
Chinese Trad
ZF
China (PRC)
Traditional Chinese
Chinese
zh_CN
Chinese
ZH
Korea
Simplified Korean
Korean
ko
Korean
KO
Italy
Italian
Italian
it
Italian
IT
France
French
French
fr
French
FR
Germany
German
German
de
German
DE
Spain
Castilian Spanish
Spanish
es
Spanish
ES
Brazil
Brazilian Portuguese
Portuguese
pt-br
Portuguese
pt_BR
Setup and Control of Locale Variables
The locale information is controlled in bothWindchill PDMLink and SAP distribution target at the user level. TheWindchill ESI business logic does not translate language, date, or currency. In theWindchill ESI business logic, textual elements are not hard-coded; instead, they are stored outside the source code and retrieved dynamically.
The following describes how the locale information is controlled betweenWindchill PDMLink and EAI components and between EAI components and the SAP distribution target.
Locale Communication Between Windchill PDMLink and EAI Components
The locale of the data being sent fromWindchill PDMLink to EAI components is set byWindchill PDMLink in a variable called com_infoengine_locale. This value is set in the custom header field of the JMS message sent fromWindchill PDMLink to Windchill business logic. Only one locale value can be set for each JMS message sent from Windchill PDMLink.Windchill ESI uses the following logic (in the order listed) to determine how to set the value for the com_infoengine_locale variable:
1. Determine if there is a locale value for the browser locale and set the com_infoengine_locale value based on this value.
* 
This functionality is not available in Windchill ESI; however, a placeholder has been created for customization purposes.
2. Determine if there is a locale value for the user in the LDAP server and set the com_infoengine_locale value based on this value
3. Determine theWindchill PDMLink server locale and set the com_infoengine_locale value to this.
Locale Communication Between EAI Components and SAP
Information on the locale and language of the data being sent from EAI software components to SAP is communicated through the following:
• The global variable ESISAPAdapter/Locale, which is set when configuring the TIBCO adapters for deployment. The default value is U.S. English (en_US). Refer to the section Global Variables for Adapter Instances for further details.
• The Adapter Locale value which is set in the TIBCO SAP adapter when deploying the adapter. Refer to "Configuring an Adapter Instance Deployment" in the Windchill Enterprise Systems Integration Installation and Configuration Guide - SAP for further details.
• The Adapter SAP Logon Language value which can be set only at design time. By default, it is set to English.
For materials and documents, there are ISO fields for languages in the SAP APIs that are also used to identify the language of the free text attributes being passed from the TIBCO adapters to the SAP distribution target.
BOM and CNs do not use these ISO fields. BOMs inherit free text descriptions from their BOMHeader part. CNs do not contain language keys for any free text fields so this setting does not affect them.
The following ISO values are used as defaults in these APIs. These fields can be configured by modifying the ESIDefaults.properties file. Refer to the ESIDefaults.properties description in the Windchill Enterprise Systems Integration Installation and Configuration Guide - SAP for details on this file. The values can be unique per system and locale. Refer to SAP API Structures in the Windchill Enterprise Systems Integration Installation and Configuration Guide - SAP for details on these ISO values.
API
API Field
API Field Description
Material
LANG_ISO
Material Description
Document
LANGUAGE_ISO
Document Description
The SAP language key for objects is set through different properties in theWindchill ESI business logic, depending on the object:
• Parts and Documents
A default value in ESIDefaults.properties file controls the language key of material description. The out-of-the-box value is EN.
• BOMs
BOM descriptions are derived from the material header. A default value in ESIDefaults.properties file controls the language key of material description. The out-of-the-box value is EN.
• CNs
No language keys are set for CNs. There is no associated language key for CN free text fields in SAP.
* 
SAP logon language cannot be changed per adapter. Thus, every adapter instance connects to SAP using one language.
Summary of Language and Locale Variables Used
The following figure summarizes all the language and locale variables used in internationalizing Windchill ESI.
Internationalization: Business Scenarios
This section describes two valid internationalization business scenarios, each followed by suggested locale and languages variables.
Business Scenario One
The following figure illustrates a business scenario where users create, modify, and view data in one language in Windchill PDMLink and SAP.
The following figure illustrates the suggested locales and languages to be used in the preceding business scenario.
Scenario Two
The following figure illustrates a business scenario where some users create, modify, or view data in one language inWindchill PDMLink and SAP, while other users create, modify, or view data in another language. The data created, modified, or viewed by each set of users is not shared inWindchill PDMLink and SAP.
The following figure illustrates the suggested locales and languages to be used in the preceding business scenario.