Using Genesys Localization Software
This topic describes how to localize WFM 8.1.1 and later, by using the Genesys localization software. If you are deploying WFM 8.1.0 and want to localize it, contact a Genesys representative to obtain localized software.
This topic includes the following sections:
- User and System Locales on Windows
- Preparing WFM for Genesys Localization
- Installing the Language Packs
Starting in release 8.1.1, WFM uses Language Packs (LP) to provide localized resources for the end user. The Language Pack is a separate IP, which is installed over the component IP. It contains only localized resources, which replace the resources in the original product IP. The Language Pack contains resources for a single language, so every language requires a separate LP. If you are installing more than one LP, you must install them one at a time. Only one Language Pack can be used over one component IP at one time.
WFM has LPs for the following components:
- WFM Web
- WFM Daemon
- WFM Server
- WFM Data Aggregator
- WFM Builder
WFM Configuration Utility does not have an LP. It requires the full localized product IP to be deployed, just as it did prior to release 8.1.1.
Context Information in Localization Kits
WFM localization kits now include context information. The kits contain resources for translation that appear in the product. The information about how the resource is used by the product, can be used to improve translation. In addition, context information simplifies verification testing, enabling the tester to easily find and check the effects of translated content.
User and System Locales on Windows
The WFM server (Server, Builder, and Data Aggregator) services choose the installed Language Pack according to the locale. It uses the exact language match or, if it is unavailable, the Language Pack for the same language group.
WFM servers checks the user or system account locale of the operating system on which it is running. By default it is either the user account (Windows 2003) or system account (Windows 2008). To adjust the user and system account settings, see the procedures Adjusting the System Account Locale (Windows 2008), Adjusting the User Account Locale (Windows 2003), and Verifying the Locale in the Windows Registry.
After checking the locale, WFM servers attempt to load a Language Pack whose language (or language group) matches this locale. For example, if the user account locale or system account locale is French (Canada) and the French (Canada) Language Pack is not installed, then the French (France) Language Pack is used. If the process is run as a service (which is usually the case), then the system account locale must be adjusted.
Important Information About Changing Locales on Windows with Java Applications Installed
An incompatibility was detected when WFM Web and Daemon applications are running on Windows operating systems with Java 7 relating to the rules that govern locale settings. (See article #4700857 on the vendor website www.oracle.com.)
Changes to the WFM local settings are made in different locations, depending which Java version you are using. In Java 7, the Display language settings determine the locale settings. In Java 6, the Regional Settings dialog in Control Panel determine the locale settings.
Also, if you are installing WFM on Windows versions earlier than Windows Vista—for example, Windows 2003 or Windows XP—you cannot set the display language, because the these OSs always use the language that is selected during installation meaning, the local settings cannot be changed.
You can use one of two workarounds to set a different locale setting for WFM applications:
- Select the appropriate display language that contains the locale settings you want to use.
- If step 1 cannot be done, complete one or both of following steps:
- Revert Java 7 to Java 6 behavior—Set the -Dsun.locale.formatasdefault Java 7 option to true and then, set the locale settings in the Regional Settings in Control Panel to the locale you want to use.
- On any version of Java—Explicitly override the locale setting for the JVM by changing the -Duser.language, -Duser.region, -Duser.country Java options.
Preparing WFM for Genesys Localization
The following information and links to procedures will help you to prepare WFM for localization. Complete all of these procedures or only the ones that are required to complete your WFM localization.
Task Summary: Preparing WFM for Genesys Localization
|Adjust and verify the system account locale.|
|Adjust the user account locale.||Adjusting the User Account Locale (Windows 2003)|
|Change the date format in WFM e-mail notifications.||Changing the Date Format in E–mail Notifications|
|Adjust WFM Web to display the weekday in the correct language.||Adjusting WFM Web to Display Weekday in the Correct Language|
|Read about how to prepare the Web interfaces.||Preparing the WFM Web Interfaces|
|Configure the date/time format and your language
preference in the WFM Web interfaces.
Installing the Language Packs
Click the red arrow to view simple procedures that will help you to install the Language Packs for each of the WFM components. Complete all of the procedures to localize your WFM deployment. <multistep>
|-| Installing the Web Language Pack=
Purpose: To localize WFM Web by installing the Web Language Pack.
Prerequisite: The WFM Web IP is installed on the host.
Start of Procedure
- Start the Web Language Pack IP for the language you are installing and follow the steps in the Installation Wizard.
- If WFM Web is already deployed in the servlet container, undeploy it using the servlet container-specific instructions.
- Deploy the WFM Web wfm.war file that was updated by the Language Pack IP, by using the servlet container specific instructions.
WFM Web uses localized resources from the Language Pack.
End of Procedure
|-| Installing the Daemon Language Pack=
Purpose: To localize WFM Daemon by installing the Daemon Language Pack.
Prerequisite: The WFM Daemon IP is installed on the host.
Start of Procedure
- Stop the WFM Daemon process.
- Start the WFM Daemon Language Pack IP for the language you are installing and follow the steps in the Installation Wizard.
- Start the WFM Daemon process.
The WFM Daemon uses localized resources from the Language Pack.
End of Procedure
|-| Installing the Server, Builder, and Data Aggregator Language Pack=
Purpose: To localize WFM Server, Builder, or Data Aggregator by installing the associated Language Pack.
- The WFM Server, Builder, or Data Aggregator IP is installed on the host.
- The user account locale is adjusted to match the Language Pack that is being installed. See Adjusting the User Account Locale (Windows 2003) or Adjusting the System Account Locale (Windows 2008).
Start of Procedure
- Stop the WFM Server, Builder, or Data Aggregator process.
- Start the WFM Server, Builder, or Data Aggregator Language Pack IP for the language you are installing and follow the steps in the Installation Wizard.
- Start the WFM Server, Builder, or Data Aggregator process.
End of Procedure