Step 1: Configuring bootstrap files

In this step of the tutorial, you will perform two tasks:

In order to create a multicultural store, first have the bootstrap files to support the new languages and currencies.

Update main bootstrap files and load

WebSphere Commerce comes with many languages ready to be used by a store. Each language is associated with a particular country. Fortunately for purposes of this example, the product is not readily available for Canadian languages or Canadian currency. This allows us to load a new set of Canadian languages and currencies from scratch. The first step will be to identify the wcs.bootstrap_base.xml file within the WCDE_installdir\schema\xml\ directory and include the newly introduced store languages. For this example, Canadian English and Canadian French will be added. This will be easy as there is already an entry in the file that can be re-used:
<language language_id="-1" localename="en_US" language="en" country="US" encoding="UTF-8" mimecharset="iso-8859-1" />

From this entry, the following attributes will need to be updated for each Canadian language:

The resulting language entries for Canada are as follows:

<language language_id="124" localename="en_CA" language="en" country="CA" encoding="UTF-8" mimecharset="iso-8859-1" />
<language language_id="125" localename="fr_CA" language="fr" country="CA" encoding="UTF-8" mimecharset="iso-8859-1" />

The following steps are required to update and re-load the main WebSphere Commerce bootstrap file:

  1. Open the WC_installdir\schema\xml\ directory, and locate the file wcs.bootstrap_base.xml
  2. Make a backup of this file and name the backup wcs.bootstrap_base.xml.original
  3. Open the file for editing, and search for the following element:
    • <language language_id="-1" localename="en_US" language="en" country="US" encoding="UTF-8" mimecharset="iso-8859-1" />
  4. After that line, create two new language element entries in order to allow separate bootstrap files to make references to language primary keys:
    • <language language_id="124" localename="en_CA" language="en" country="CA" encoding="UTF-8" mimecharset="iso-8859-1" />
    • <language language_id="125" localename="fr_CA" language="fr" country="CA" encoding="UTF-8" mimecharset="iso-8859-1" />
  5. Save this file
  6. Within the WC_installdir\schema\xml\ directory, locate the file wcs.dtd
  7. Make a backup of this file and call it wcs.dtd.original
  8. Open the wcs.dtd file and locate the reference to <!ENTITY en_US "-1">
  9. Create additional lines after that line to include new entries <!ENTITY en_CA "124"> and <!ENTITY fr_CA "125">
  10. Save this file
  11. Download and extract the zip file included in this tutorial, and locate the env.bat file.
  12. Open the fileenv.batin a text editor and update the file to represent your environment, specifically theWCSHOMEandToolKitHomeproperties
  13. Open a command prompt, browse to the directory where you extracted the included zip file.
  14. Run the script massload_main.bat

Create multi-language bootstrap files

Once the language entries are added to the file wcs.bootstrap_base.xml, two new files need to be referenced:

These two files represent language-specific data for each locale. Each file can be easily created by reusing existing files provided by default. Let's start with making new copies of those files and setting appropriate data elements as follows:

  1. Within the WC_installdir\schema\xml\ directory, locate the file wcs.bootstrap_multi_en_US_base.xml
  2. Make a copy of this file and name the copy wcs.bootstrap_multi_en_CA_base.xml
  3. Open this file for editing and perform a search/replace function to replace all references of &en_US; to 124 (value used in language_id)
  4. Search for entries for the languageds element
  5. Find the following line in the file:
    <languageds language_id="124" description="United States English" language_id_desc="-1" />
  6. Create two languageds element entries after that line in order to allow the Canadian English language to translate other language data as follows: 
    <languageds language_id="124" description="Canadian English" language_id_desc="124" />
<languageds language_id="124" description="Canadian French" language_id_desc="125" />

    Note: The description value of this entry is used to show up in the starter store and WebSphere Commerce Accelerator tools when users select their language of choice.

  7. Now we need to create all other languageds element entries in order to allow other languages to have a translation for this locale. Instead of updating every single wcs.bootstrap_multi_<locale>_base.xml file, we instead provide an entry for each locale within the Canadian English locale file. Copy the following lines into the same file for the 124 Canadian English locale: 
    <languageds language_id="-1" description="Canadian English" language_id_desc="124" />
<languageds language_id="-2" description="Canadian English" language_id_desc="124" /> 
<languageds language_id="-3" description="Canadian English" language_id_desc="124" /> 
<languageds language_id="-4" description="Canadian English" language_id_desc="124" /> 
<languageds language_id="-5" description="Canadian English" language_id_desc="124" /> 
<languageds language_id="-6" description="Canadian English" language_id_desc="124" /> 
<languageds language_id="-7" description="Canadian English" language_id_desc="124" /> 
<languageds language_id="-8" description="Canadian English" language_id_desc="124" /> 
<languageds language_id="-9" description="Canadian English" language_id_desc="124" /> 
<languageds language_id="-10" description="Canadian English" language_id_desc="124" />
  8. Save this file
  9. Make a copy from wcs.bootstrap_multi_en_US.xml and rename to wcs.bootstrap_multi_en_CA.xml
  10. Open this file for editing and perform a search/replace function to replace all references from en_US to en_CA (this change references the new locale multi base file)
  11. Save this file
  12. Within the WC_installdir\schema\xml\ directory, locate the file wcs.bootstrap_multi_fr_FR_base.xml
  13. Make a copy of this file and name the copy wcs.bootstrap_multi_fr_CA_base.xml
  14. Open this file for editing and perform a search/replace function to replace all references of &fr_FR; to 125 (value used in language_id)
  15. Search for the following line:
    <languageds description="Anglais (Etats-Unis)" language_id="125" language_id_desc="-1"/>
  16. Create two languageds element entries under that line in order to allow the Canadian English language to translate other language data as follows: 
    <languageds language_id="125" description="Canadian English" language_id_desc="124" />
<languageds language_id="125" description="Canadian French" language_id_desc="125" />

    Note: The description value of this entry is used to show up in the starter store and WebSphere Commerce Accelerator tools when users select their language of choice.

  17. Now we need to create all other languageds element entries in order to allow other languages to have a translation for this locale. Instead of updating every single wcs.bootstrap_multi_<locale>_base.xml file, we instead provide an entry for each locale within the Canadian French locale file. Enter the following lines into the same file for the 125 Canadian French locale: 
    <languageds language_id="-1" description="Canadian French" language_id_desc="125" />
<languageds language_id="-2" description="Canadian French" language_id_desc="125" />
<languageds language_id="-3" description="Canadian French" language_id_desc="125" />
<languageds language_id="-4" description="Canadian French" language_id_desc="125" />
<languageds language_id="-5" description="Canadian French" language_id_desc="125" />
<languageds language_id="-6" description="Canadian French" language_id_desc="125" />
<languageds language_id="-7" description="Canadian French" language_id_desc="125" />
<languageds language_id="-8" description="Canadian French" language_id_desc="125" />
<languageds language_id="-9" description="Canadian French" language_id_desc="125" />
<languageds language_id="-10" description="Canadian French" language_id_desc="125" />
  18. Save this file.
  19. Make a copy from wcs.bootstrap_multi_fr_FR.xml and rename to wcs.bootstrap_multi_fr_CA.xml
  20. Open this file for editing and perform a search/replace function to replace all references of fr_FR to fr_CA (this change references the new locale multi base file)
  21. Save this file.

After successfully loading these two new language bootstrap files into the database, WebSphere Commerce can include related multi-cultural data into the system. To load the new language bootstrap files, follow these steps:

  1. Open a command prompt, browse to the directory where you extracted the included zip file.
  2. Run the script massload_en_CA.batandmassload_fr_CA.bat

You have now updated the main bootstrap to include your new languages, and created new language specific bootstrap files to support the new languages.

In the next step of the tutorial you will learn how to include the new languages in your WebSphere Commerce instance.

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