Step 2: Including language data

In this step of the tutorial, you will learn how to include the language data you created in the previous step, into your WebSphere Commerce instance.

When you create a new WebSphere Commerce instance, the bootstrap files that were previously loaded should be listed on the Language screen. Simply select the new languages from the available languages and click the arrow directing the selected items into the Selected Languages screen. When the new instance is created, these newly added languages will be included in the instance configuration file.

If you already have an existing instance and would like to include new languages that were massloaded through the bootstrap files, then the instance configuration file must be updated. The following steps are required in order to update the instance configuration file and apply it to the existing WebSphere Commerce instance:

  1. Within theWC_installdir\instances\instance\xml\ directory, locate the fileinstance.xml(whereinstancecorresponds to the name of your instance. For Toolkit, locate the file wc-server.xml in WCDE_installdir\xml\config\).
  2. Make a copy of this file and name the copy instance.xml.orig (where instance corresponds to the name of your instance).
  3. Open this file for editing and perform a search function to search for references to the <instance> element.
  4. Within the instance element, find the attribute BootstrapMulti (a typical entry for this attribute would be "wcs.bootstrap_multi_en_US.xml,wcs.bootstrap_multi_fr_FR.xml".
  5. Append values to this entry as follows: ",wcs.bootstrap_multi_en_CA.xml,wcs.bootstrap_multi_fr_CA.xml".
  6. Again, within the instance element, find the attribute DefaultLang.
  7. Update this value to correspond to the default language you want for your instance. For example, DefaultLang="-1" can be updated to DefaultLang="124" to correspond to Canadian English as the default language for the instance in this example.
  8. Again, within the instance element, find the attribute SupportedLanguages.
  9. Update this value to support the languages you want for your instance. For example, SupportedLanguages="-1, 124, 125" will cause the WebSphere Commerce instance to support the locales: United States English, Canadian English and Canadian French.
  10. Save this file.
  11. Stop the WebSphere Commerce instance.
  12. Restart the WebSphere Commerce instance.
  13. Log into WebSphere Commerce Accelerator and select your published store for United States English.
    Note: the WebSphere Commerce Accelerator can be reached by entering the following URL into a Web browser:
    https://host_name/webapp/wcs/tools/servlet/ToolsLogon?XMLFile=common.mcLogon where host_name is the fully-qualified WebSphere Commerce development environment Web server host name. The host name may be a virtual host name on the Web server.
  14. Select Store > Change Profile.
  15. Under the Language Tab, select 'Canadian English' and 'Canadian French' from the Available Languages and point to the Selected Languages box.
  16. Once the 'Canadian English' language is in the Selected Languages box, highlight that entry and click the 'set as language default' button.
  17. Under the Currency Tab, select 'Canadian Dollar' from the Available currencies box and point to the Selected currencies box.
  18. Click OK.
  19. Make sure that the languages that appear in the drop-down list correspond to the new languageds entries for your bootstrap files.

You have now included the necessary language data into your WebSphere Commerce instance to view your new languages in the language selection screen of the WebSphere Commerce Accelerator.

In the next step you will create both property and image files for your new locales.

(C) Copyright IBM Corporation 1996, 2006. All Rights Reserved.