Configuration des fichiers d'amorçage

Dans cette leçon, vous configurez les fichiers d'amorçage requis pour prendre en charge les nouvelles langues dans votre instance de HCL Commerce. Vous devez mettre à jour le fichier d'amorçage principal et créer les fichiers d'amorçage multilingues, puis charger les fichiers pour ajouter la prise en charge de la langue.

Au cours de cette étape du tutoriel, vous réalisez les tâches suivantes : personnalisation des fichiers d'amorçage pour inclure un nouveau paramètre régional et création de fichiers d'amorçage multilingues. La liste des langues prises en charge est définie dans la table LANGUAGE. Pour prendre en charge une nouvelle langue, vous devez d'abord l'ajouter à la table. Le fichier wcs.bootstrap_base.xml inclut des entrées correspondant aux langues de tous les paramètre régionaux disponibles dans HCL Commerce.
Remarque : Les fichiers d'amorçage sont des fichiers XML utilisés pour remplir les tables de base de données avec des informations une fois le schéma créé.

Pourquoi et quand exécuter cette tâche

HCL Commerce est fourni avec de nombreuses langues prêtes à l'emploi dans un magasin. Chaque langue est associée à un pays particulier. Dans ce tutoriel, vous allez charger les langues du Canada et la monnaie du Canada. Recherchez en premier le fichier wcs.bootstrap_base.xml dans le répertoire WCDE_installdir\schema\data\xml et incluez les nouvelles langues du magasin. Vous pouvez réutiliser une entrée dans le fichier :
<language language_id="&en_US;" localename="en_US" language="en" country="US" encoding="UTF-8" mimecharset="iso-8859-1" />
Remarque : Lorsque vous indiquez l'ID language_id de la nouvelle langue, utilisez une valeur numérique négative qui commence à -1000. N'utilisez pas de valeurs entre -1 et -999, car ces valeurs sont réservées à l'utilisation d'IBM.
Mettez à jour les attributs pour prendre en compte l'anglais du Canada et le français du Canada.
id_langue
Identificateur unique du format d'affichage.
langue
Le nom de la langue, où en représente l'anglais et fr représente Français.
country
Pays ou région où la langue est pratiquée. CA représente Canada.
localename
Un paramètre régional Java représentant une entité politique, géographique ou culturelle disposant d'une langue et de coutumes de mise en page propres. Il s'agit du code langue ISO 639 à deux lettres, suivi du code pays ISO 3166 à deux lettres, séparés par un trait de soulignement. La valeur de l'attribut language (langue et celle de l'attribut country (pays), séparées par un trait de soulignement (_).
codage
Le codage utilisé par le navigateur pour afficher la page dans cette langue. La valeur est généralement la même que la valeur d'encodage utilisée dans vos fichiers de propriété (UTF-8).
mimecharset
Codage de caractères utilisé pour la messagerie MIME. Cette valeur est différente de celle utilisée par les navigateurs. Par exemple, le codage de caractères utilisé de facto pour la messagerie MIME au Japon est iso-2022-jp, alors que le codage de caractères le plus fréquent dans toutes les autres applications est Shift_JIS. Dans cet exemple, le jeu de caractères MIME suivant est utilisé.
iso-8859-1
iso-8859-15
Les entrées de langue résultantes pour le Canada sont donc 
 <language language_id="&en_CA;" localename="en_CA" language="en" country="CA" encoding="UTF-8" mimecharset="iso-8859-1" /> 
 <language language_id="&fr_CA;" localename="fr_CA" language="fr" country="CA" encoding="UTF-8" mimecharset="iso-8859-15" />

Voici les étapes à suivre pour mettre à jour et recharger le fichier d'amorçage principal de HCL Commerce :

Procédure

  1. Créez les fichiers d'amorçage de vos nouvelles langues.
    Dans la procédure qui suit, utilisez le nom du paramètre régional, par exemple en_CA ou fr_CA, pour la variable myLang.
    1. Accédez au répertoire suivant :
      • WCDE_installdir\schema\data\xml
    2. Créez un fichier d'amorçage appelé wcs.bootstrap_myLang.xml et ouvrez le fichier pour le modifier.
    3. Ajoutez le code suivant : 
      <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE import SYSTEM "wcs.dtd" [
<!ENTITY bootbase SYSTEM "./wcs.bootstrap_myLang_base.xml">

]>
<import>
&bootbase;

</import>
    4. Enregistrez et fermez le fichier.
    5. Créez un fichier d'amorçage appelé wcs.bootstrap_myLang_base.xml et ouvrez le fichier pour le modifier.
    6. Ouvrez le wcs.bootstrap_base.xml.
    7. Recherchez l'élément suivant dans le fichier wcs.bootstrap_base.xml : 
       <language language_id="&en_US;" localename="en_US" language="en" country="US" encoding="UTF-8" mimecharset="iso-8859-1" />
    8. Dans le nouveau fichier wcs.bootstrap_myLang_base.xml, créez deux entrées d'élément de langue basées sur la langue indiquée dans votre fichier wcs.bootstrap_base.xml.
      Cette mise à jour permet aux fichiers d'amorçage de faire référence aux langues par leur clé primaire : 
      <language language_id="&en_CA;" localename="en_CA" language="en" country="CA" encoding="UTF-8" mimecharset="iso-8859-1" />
      <language language_id="&fr_CA;" localename="fr_CA" language="fr" country="CA" encoding="UTF-8" mimecharset="iso-8859-15" />
    9. Recherchez l'élément suivant dans le fichier wcs.bootstrap_base.xml : 
      <langpair storeent_id="-1" language_id="&en_US;" language_id_alt="&en_US;" sequence="100" />
    10. Dans le nouveau fichier wcs.bootstrap_myLang_base.xml, créez deux entrées d'élément de paire de langues basées sur la langue indiquée dans votre fichier wcs.bootstrap_base.xml. 
      <langpair storeent_id="-1" language_id="&en_CA;" language_id_alt="&en_US;" sequence="100" />
      <langpair storeent_id="-1" language_id="&fr_CA;" language_id_alt="&en_US;" sequence="100" />
    11. Vérifiez les résultats :
      • Votre fichier wcs.bootstrap_en_CA_base.xml ressemble au fragment suivant :
        <language language_id="&en_CA;" localename="en_CA" language="en" country="CA" encoding="UTF-8" mimecharset="iso-8859-1" />
<langpair storeent_id="-1" language_id="&en_CA;" language_id_alt="&en_US;" sequence="100" />
      • Votre fichier wcs.bootstrap_fr_CA_base.xml ressemble à l'extrait suivant :
        <language language_id="&fr_CA;" localename="fr_CA" language="fr" country="CA" encoding="UTF-8" mimecharset="iso-8859-15" />
<langpair storeent_id="-1" language_id="&fr_CA;" language_id_alt="&en_US;" sequence="100" />
    12. Enregistrez vos modifications sur les fichiers wcs.bootstrap_myLang_base.xml et fermez les fichiers.
  2. Editez le fichier wcs.dtd :
    1. Accédez au répertoire suivant et recherchez le fichier wcs.dtd :
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Sauvegardez le fichier et renommez la sauvegarde wcs.dtd.original.
    3. Ouvrez le fichier wcs.dtd. Trouvez la ligne : 
      <!ENTITY en_US "-1">
    4. Ajoutez ces entrées : 
      <!ENTITY en_CA "-24">
<!ENTITY fr_CA "-25">
    5. Sauvegardez ce fichier.
  3. Créez des fichiers d'amorçage multilingues pour l'anglais canadien :
    1. Accédez au répertoire suivant et recherchez le fichier wcs.bootstrap_multi_en_US_base.xml :
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Faire une copie de ce fichier et nommer la copie wcs.bootstrap_multi_en_CA_base.xml
    3. Ouvrez le fichier wcs.bootstrap_multi_en_CA_base.xml. Remplacez toutes les références &en_US; par &en_CA;.
      Cette modification change les références au nouveau fichier de base contenant les paramètres régionaux.
    4. Rechercher <languageds language_id="&en_CA;" description="United States English" language_id_desc="-1" />
    5. Créez deux entrées d'élément languageds.
      La valeur de la description s'affiche dans les pages de magasin et dans les outils HCL Commerce lorsqu'un utilisateur sélectionne une langue.
      <languageds language_id="&en_CA;" description="Canadian English" language_id_desc="-24" />
<languageds language_id="&en_CA;" description="Canadian French"  language_id_desc="-25" />
    6. Ajoutez les descriptions de langue de toutes les autres langues prises en charge pour que ces autres langues disposent d'une traduction dans cet environnement local : 
      <languageds language_id="-1" description="Canadian English" language_id_desc="&en_CA;" />
<languageds language_id="-2" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-3" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-4" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-5" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-6" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-7" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-8" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-9" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-10" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-20" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-21" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-22" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-23" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-24" description="Canadian English" language_id_desc="&en_CA;" /> 
<languageds language_id="-25" description="Canadian English" language_id_desc="&en_CA;" />
      Remarque : Alternativement, ajoutez des langues prises en charge dans chacun des fichiers wcs.bootstrap_multi_locale_base.xml.
    7. Sauvegardez ce fichier.
  4. Créez des fichiers d'amorçage multilingues pour le français canadien :
    1. Accédez au répertoire suivant et recherchez le fichier wcs.bootstrap_multi_fr_FR_base.xml :
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Faire une copie de ce fichier et nommer la copie wcs.bootstrap_multi_fr_CA_base.xml
    3. Ouvrez le fichier wcs.bootstrap_multi_fr_CA_base.xml. Remplacez toutes les références &fr_FR; par &fr_CA; (valeur utilisée dans language_id).
    4. Rechercher <languageds language_id="&fr_CA;" description="Français" language_id_desc="-2" />
    5. Créez deux entrées d'élément languageds afin qu'une traduction dans les autres langues soit disponible pour les noms de langue dans l'environnement anglais canadien : 
      <languageds language_id="&fr_CA;" description="Canadian English" language_id_desc="-24" />
<languageds language_id="&fr_CA;" description="Canadian French" language_id_desc="-25" />
    6. Ajoutez les descriptions de langue de toutes les autres langues prises en charge pour que ces autres langues disposent d'une traduction dans cet environnement local.
      Au lieu de mettre à jour chaque fichier wcs.bootstrap_multi_locale_base.xml, vous devez fournir une entrée pour chaque paramètre régional dans le fichier du paramètre régional du français canadien.
      <languageds language_id="-1" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-2" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-3" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-4" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-5" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-6" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-7" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-8" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-9" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-10" description="Canadian French" language_id_desc="&fr_CA;" />
<languageds language_id="-20" description="Canadian French" language_id_desc="&fr_CA;" /> 
<languageds language_id="-21" description="Canadian French" language_id_desc="&fr_CA;" /> 
<languageds language_id="-22" description="Canadian French" language_id_desc="&fr_CA;" /> 
<languageds language_id="-23" description="Canadian French" language_id_desc="&fr_CA;" /> 
<languageds language_id="-24" description="Canadian French" language_id_desc="&fr_CA;" /> 
<languageds language_id="-25" description="Canadian French" language_id_desc="&fr_CA;" />
    7. Sauvegardez ce fichier.
  5. Créez les autres fichiers d'amorçage multilingues restants de l'anglais canadien.
    1. Accédez au répertoire suivant :
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Recherchez le fichier wcs.bootstrap_multi_en_US.xml.
    3. Faites une copie du fichier et renommez wcs.bootstrap_multi_en_US.xml en wcs.bootstrap_multi_en_CA.xml.
    4. Ouvrez le fichier créé à l'étape précédente en édition et remplacez toutes les occurrences de en_US par en_CA.
    5. Sauvegardez le fichier.
    6. Recherchez tous les fichiers restants qui commencent par wcs.bootstrap_multi_en_US_*.xml (à l'exclusion de wcs.bootstrap_multi_en_US_base.xml, car ce fichier a déjà été créé et mis à jour dans les étapes précédentes) :
      • wcs.bootstrap_multi_en_US_contract.xml
      • wcs.bootstrap_multi_en_US_epromotion.xml
      • wcs.bootstrap_multi_en_US_member.xml
      • wcs.bootstrap_multi_en_US_order.xml
      • wcs.bootstrap_multi_en_US_return.xml
      • wcs.bootstrap_multi_en_US_runtime.xml
      • wcs.bootstrap_multi_en_US_tickler.xml
    7. Faites une copie de chaque fichier qui se trouve dans l'étape précédente et renommez wcs.bootstrap_multi_en_US_*.xml en wcs.bootstrap_multi_en_CA_*.xml :
      • wcs.bootstrap_multi_en_CA_contract.xml
      • wcs.bootstrap_multi_en_CA_epromotion.xml
      • wcs.bootstrap_multi_en_CA_member.xml
      • wcs.bootstrap_multi_en_CA_order.xml
      • wcs.bootstrap_multi_en_CA_return.xml
      • wcs.bootstrap_multi_en_CA_runtime.xml
      • wcs.bootstrap_multi_en_CA_tickler.xml
    8. Ouvrez chacun des fichiers créés à l'étape précédente pour les éditer, et remplacez toutes les références de &en_US; par &en_CA; (valeur utilisée dans language_id).
    9. Sauvegardez tous les fichiers.
  6. Créez les autres fichiers d'amorçage multilingues restants du français canadien.
    1. Accédez au répertoire suivant :
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Recherchez le fichier wcs.bootstrap_multi_fr_FR.xml.
    3. Faites une copie du fichier et renommez wcs.bootstrap_multi_fr_FR.xml en wcs.bootstrap_multi_fr_CA.xml.
    4. Ouvrez le fichier créé à l'étape précédente en édition et remplacez toutes les occurrences de fr_FR par fr_CA.
    5. Sauvegardez le fichier.
    6. Recherchez tous les fichiers restants qui commencent par wcs.bootstrap_multi_fr_FR_*.xml (à l'exclusion de wcs.bootstrap_multi_en_US_base.xml, car ce fichier a déjà été créé et mis à jour dans les étapes précédentes) :
      • wcs.bootstrap_multi_fr_FR_contract.xml
      • wcs.bootstrap_multi_fr_FR_epromotion.xml
      • wcs.bootstrap_multi_fr_FR_member.xml
      • wcs.bootstrap_multi_fr_FR_order.xml
      • wcs.bootstrap_multi_fr_FR_return.xml
      • wcs.bootstrap_multi_fr_FR_runtime.xml
      • wcs.bootstrap_multi_fr_FR_tickler.xml
    7. Faites une copie de chaque fichier qui se trouve dans l'étape précédente et renommez wcs.bootstrap_multi_fr_FR_*.xml en wcs.bootstrap_multi_fr_CA_*.xml :
      • wcs.bootstrap_multi_fr_CA_contract.xml
      • wcs.bootstrap_multi_fr_CA_epromotion.xml
      • wcs.bootstrap_multi_fr_CA_member.xml
      • wcs.bootstrap_multi_fr_CA_order.xml
      • wcs.bootstrap_multi_fr_CA_return.xml
      • wcs.bootstrap_multi_fr_CA_runtime.xml
      • wcs.bootstrap_multi_fr_CA_tickler.xml
    8. Ouvrez chacun des fichiers créés à l'étape précédente pour les éditer, et remplacez toutes les références de &fr_FR; par &fr_CA; (valeur utilisée dans language_id).
    9. Sauvegardez tous les fichiers.
  7. Créez les fichiers d'amorçage de fonctions pour vos deux nouvelles langues.
    1. Accédez au répertoire suivant :
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Recherchez les fichiers wcs.features_bootstrap_en_US.xml et wcs.features_bootstrap_fr_FR.xml.
    3. Faites une copie des fichiers et renommez-les pour refléter vos paramètres régionaux. C'est-à-dire, wcs.features_bootstrap_en_CA.xml et wcs.features_bootstrap_fr_CA.xml.
    4. Ouvrez les fichiers créés dans l'étape précédente pour les modifier ; remplacer toutes les références des anciens noms de paramètres régionaux par les nouveaux noms de paramètres régionaux. C'est-à-dire, remplacez toutes les références &en_US; par &en_CA; pour le fichier de l'anglais canadien, et &fr_FR; par &fr_CA; pour le fichier du français canadien (valeur utilisée dans language_id).
    5. Créez le fichier wcs.features_bootstrap.xml et incluez wcs.features_bootstrap_en_CA.xml. Faites une copie de WCDE_installdir\schema\data\xml\wcs.features_bootstrap.xml.template nommée wcs.features_bootstrap.xml. Mettez à jour ce fichier avec le contenu suivant :
       <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE import SYSTEM "wcs.dtd" [<!ENTITY boot_en_CA SYSTEM "./wcs.features_bootstrap_en_CA.xml">]>
   <import>
         &boot_en_CA;
   </import>
      Pour le français canadien, mettez à jour le fichier à l'aide de fr_CA.
    6. Enregistrez les fichiers.
  8. Chargez les fichiers d'amorçage principaux :
    L'utilitaire massload a été déprécié dans HCL Commerce version 9 en faveur de dataload. L'utilitaire a besoin de trois fichiers XML pour les anglais canadien et français canadien :
    • wcs.bootstrap_en_CA.xml/wcs.bootstrap_fr_CA.xml
    • wcs.bootstrap_multi_en_CA.xml/wcs.bootstrap_multi_fr_CA.xml
    • wcs.features_en_CA.xml/wcs.features_fr_CA.xml
    Avant d'utiliser l'utilitaire dataload, définissez WCDE_installdir\dataload\massload\wc-dataload-env.xml en fonction de l'environnement. Voici un exemple qui met à jour les informations <_config:Database avec db2. 
    <_config:Database type="db2" name="mall" user="<user>" password="<encryped password>" server="<hostname>" schema="<schema>" >
         <_config:property name="port" value="${port,50000}" />
   </_config:Database>.
    Pour charger l'amorçage principal pour l'anglais canadien :
    1. Editez le fichier de configuration WCDE_installdir\dataload\massload\wc-dataload.xml. Modifiez <_config:DataSourceLocation et définissez le fichier de chargement sur wcs.bootstrap_en_CA.xml.Par exemple :
      <_config:DataSourceLocation location="../../schema/data/xml/wcs.bootstrap_en_CA.xml " />
    2. Ouvrez une invite de commande et exécutez l'utilitaire dataload. Voir Exécution des utilitaires à partir de Utility server Docker container.
      WCDE_installdir\bin>dataload.bat ..\dataload\massload\wc-dataload.xml 
      Répétez ces deux étapes pour charger l'amorçage principal pour le français canadien.
  9. Chargez les fichiers d'amorçage multilingues pour ajouter la prise en charge de la langue pour HCL Commerce :
    1. Modifiez le fichier de configuration <_config:DataSourceLocation> de WCDE_installdir\dataload\massload\wc-dataload.xml et définissez le fichier de chargement sur wcs.bootstrap_multi_en_CA.xml. Par exemple : 
      <_config:DataSourceLocation location="../../schema/data/xml/wcs.bootstrap_multi_en_CA.xml" />
    2. Ouvrez une invite de commande et exécutez l'utilitaire dataload. Voir Exécution des utilitaires à partir de Utility server Docker container. 
      WCDE_installdir\bin>dataload.bat ..\dataload\massload\wc-dataload.xml
    3. Pour le français canadien, répétez ces deux étapes.
    Après avoir chargé les fichiers d'amorçage de la nouvelle langue dans la base de données, HCL Commerce peut inclure des données multiculturelles connexes dans le système.
  10. Comme pour l'étape précédente, chargez les fichiers d'amorçage des fonctions pour les deux nouvelles langues, wcs.features_bootstrap_en_CA.xml et wcs.features_bootstrap_fr_CA.xml.
    1. Modifiez le fichier de configuration <_config:DataSourceLocation> de WCDE_installdir\dataload\massload\wc-dataload.xml et définissez le fichier de chargement sur wcs.features_bootstrap.xml. Par exemple : 
      <_config:DataSourceLocation location="../../schema/data/xml/wcs.features_bootstrap.xml" />
    2. Ouvrez une invite de commande et exécutez l'utilitaire dataload. Voir Exécution des utilitaires à partir de Utility server Docker container. 
      WCDE_installdir\bin>dataload.bat ..\dataload\massload\wc-dataload.xml
    3. Pour le français canadien, remplacez le nom du fichier <!ENTITY par wcs.features_bootstrap_fr_CA.xml dans wcs.features_bootstrap.xml répétez les étapes a-b.
  11. Indexez les nouvelles langues dans HCL Commerce Search, de sorte que les utilitaires de recherche, la vitrine et Management Center puissent les reconnaître.

Résultats

Votre amorçage principal est mis à jour pour inclure vos nouvelles langues et les nouveaux des fichiers d'amorçage spécifiques aux nouvelles langues. Dans l'étape suivante du tutoriel, vous découvrez comment inclure les nouvelles langues dans votre instance de HCL Commerce.