Configuración de archivos de rutina de carga

En esta lección, va a configurar los archivos de rutina de carga necesarios para dar soporte a los nuevos idiomas para la instancia de HCL Commerce. Debe actualizar el archivo de rutina de carga principal, crear los archivos de rutina de carga de varios idiomas y cargar dichos archivos para añadir soporte para idiomas.

En este paso de la guía de aprendizaje, realizará las siguientes tareas: personalizar archivos de rutina de carga para incluir un nuevo entorno local y crear archivos de rutina de carga en varios idiomas. La lista de idiomas admitidos se define en la tabla LANGUAGE. Para dar soporte a un nuevo idioma, primero debe añadir el idioma a esta tabla. El archivo wcs.bootstrap_base.xml incluye elementos de entrada de idioma para todos los entornos locales disponibles en HCL Commerce.
Nota: Los archivos de rutina de carga son archivos XML que se utilizan para llenar las tablas de base de datos con información, después de crear el esquema.

Por qué y cuándo se efectúa esta tarea

HCL Commerce se suministra con muchos idiomas preparados para que los utilice una tienda. Cada idioma está asociado con un país en concreto. En esta guía de aprendizaje va a cargar los idiomas y la moneda canadienses. En primer lugar, localice el archivo wcs.bootstrap_base.xml en el directorio WCDE_installdir\schema\data\xml e incluya los nuevos idiomas de la tienda. Puede volver a utilizar una entrada en el archivo:
<language language_id="&en_US;" localename="en_US" language="en" country="US" encoding="UTF-8" mimecharset="iso-8859-1" />
Nota: Cuando especifique el valor de language_id para el nuevo idioma, utilice un valor numérico negativo que inicia en -1000. No utilice los valores de -1 a -999 porque estos valores están reservados para uso de IBM.
Actualice atributos para los idiomas inglés de Canadá y francés de Canadá.
id_idioma
Un identificador que identifica de forma exclusiva el formato de visualización.
idioma
El nombre del idioma, donde en representa el inglés y fr representa el francés.
country
El país o región para el idioma. CA representa a Canadá.
localename
Un entorno local Java que se utiliza para representar una región política, geográfica o cultural que tiene un idioma y costumbres diferentes para el formato. El nombre de entorno local es el código de idioma ISO 639 de dos letras, seguido por el código de país ISO 3166 de dos letras, separado por un subrayado. El valor de idioma y el valor de país separados por un subrayado (_).
encoding
El valor de codificación de caracteres que utiliza el navegador para mostrar la página para este idioma. El valor es normalmente el mismo valor de codificación utilizado en los archivos de propiedades (UTF-8).
mimecharset
Codificación de caracteres utilizada para la mensajería MIME. Este valor es distinto del valor utilizado por los navegadores. Por ejemplo, el carácter de codificación para la mensajería MIME en Japón es de hecho iso-2022-jp, mientras que el carácter que se utiliza comúnmente en todas las demás aplicaciones es Shift_JIS. En este ejemplo, se utiliza el siguiente conjunto de caracteres de mime.
iso-8859-1
iso-8859-15
Las entradas de idioma resultantes para Canadá son 
 <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" />

Se necesitan los siguientes pasos para actualizar y volver a cargar el archivo de rutina de carga de HCL Commerce principal:

Procedimiento

  1. Cree los archivos de rutina de carga para los nuevos idiomas.
    En estos pasos, para la variable myLang, utilice el nombre de entorno local, por ejemplo, en_CA y fr_CA.
    1. Vaya al directorio siguiente:
      • WCDE_installdir\schema\data\xml
    2. Cree un archivo de rutina de carga denominado wcs.bootstrap_myLang.xml y abra el archivo para editarlo.
    3. Añada el código siguiente: 
      <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE import SYSTEM "wcs.dtd" [
<!ENTITY bootbase SYSTEM "./wcs.bootstrap_myLang_base.xml">

]>
<import>
&bootbase;

</import>
    4. Guarde y cierre el archivo.
    5. Cree un archivo de rutina de carga denominado wcs.bootstrap_myLang_base.xml y abra el archivo para editarlo.
    6. Abra la wcs.bootstrap_base.xml.
    7. Busque el elemento siguiente en el archivo wcs.bootstrap_base.xml: 
       <language language_id="&en_US;" localename="en_US" language="en" country="US" encoding="UTF-8" mimecharset="iso-8859-1" />
    8. En el nuevo archivo wcs.bootstrap_myLang_base.xml, cree dos entradas de elemento de idioma modeladas según el idioma en el archivo wcs.bootstrap_base.xml.
      Esta actualización permite que los archivos de rutina de carga hagan referencia a las claves primarias de idioma: 
      <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. Busque el elemento siguiente en la wcs.bootstrap_base.xml: 
      <langpair storeent_id="-1" language_id="&en_US;" language_id_alt="&en_US;" sequence="100" />
    10. En el nuevo archivo wcs.bootstrap_myLang_base.xml, cree dos entradas de elemento par de idioma modeladas según el idioma en el archivo 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. Compruebe los resultados:
      • El archivo wcs.bootstrap_en_CA_base.xml es parecido al fragmento de código siguiente:
        <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" />
      • El archivo wcs.bootstrap_fr_CA_base.xml es parecido al fragmento de código siguiente:
        <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. Guarde los cambios en los archivos wcs.bootstrap_myLang_base.xml y cierre los archivos.
  2. Edite el archivo wcs.dtd.
    1. Vaya al directorio siguiente y localice el archivo wcs.dtd:
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Realice una copia de seguridad del archivo y cambie el nombre de la copia de seguridad wcs.dtd.original.
    3. Abra el archivo wcs.dtd. Busque la línea: 
      <!ENTITY en_US "-1">
    4. Añada estas entradas: 
      <!ENTITY en_CA "-24">
<!ENTITY fr_CA "-25">
    5. Guarde este archivo.
  3. Cree archivos de rutina de carga en varios idiomas para el inglés canadiense:
    1. Vaya al directorio siguiente y localice el archivo wcs.bootstrap_multi_en_US_base.xml:
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Haga una copia de este archivo y asigne un nombre a la copia wcs.bootstrap_multi_en_CA_base.xml
    3. Abra el archivo wcs.bootstrap_multi_en_CA_base.xml. Sustituya todas las referencias de &en_US; por &en_CA;.
      Este cambio hace referencia al nuevo archivo multi base del nuevo entorno local.
    4. Buscar <languageds language_id="&en_CA;" description="United States English" language_id_desc="-1" />
    5. Cree dos entradas de elemento languageds.
      El valor de la descripción se muestra en las páginas de la tienda y en las herramientas de HCL Commerce cuando un usuario selecciona un idioma.
      <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. Añada descripciones de idioma para todos los idiomas admitidos para que otros idiomas puedan tener una traducción para este entorno 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;" />
      Nota: De forma alternativa, añada idiomas admitidos en cada uno de los archivos wcs.bootstrap_multi_locale_base.xml.
    7. Guarde este archivo.
  4. Cree archivos de rutina de carga en varios idiomas para el francés canadiense:
    1. Vaya al directorio siguiente y localice el archivo wcs.bootstrap_multi_fr_FR_base.xml:
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Haga una copia de este archivo y asigne un nombre a la copia wcs.bootstrap_multi_fr_CA_base.xml
    3. Abra el archivo wcs.bootstrap_multi_fr_CA_base.xml. Sustituya todas las referencias de &fr_FR; por &fr_CA; (valor utilizado en language_id).
    4. Buscar <languageds language_id="&fr_CA;" description="Français" language_id_desc="-2" />
    5. Cree dos entradas de elemento de languageds a fin de permitir que el idioma "inglés de Canadá" se traduzca a otros idiomas: 
      <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. Añada descripciones de idioma para todos los idiomas admitidos para que otros idiomas puedan tener una traducción para este entorno local.
      En lugar de actualizar cada archivo wcs.bootstrap_multi_locale_base.xml, debe proporcionar una entrada para cada entorno local dentro del archivo del entorno local de francés de Canadá.
      <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. Guarde este archivo.
  5. Cree los archivos de rutina de arranque de varios idiomas restantes para el inglés de Canadá.
    1. Vaya al directorio siguiente:
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Localice el archivo wcs.bootstrap_multi_en_US.xml
    3. Haga una copia del archivo y cambie el nombre de wcs.bootstrap_multi_en_US.xml a wcs.bootstrap_multi_en_CA.xml.
    4. Abra el archivo creado en el paso anterior para editarlo; sustituya todas las referencias de en_US a en_CA.
    5. Guarde el archivo.
    6. Localice todos los archivos restantes que empiecen con wcs.bootstrap_multi_en_US_*.xml (excluido wcs.bootstrap_multi_en_US_base.xml, ya que este archivo se ha creado y actualizado en los pasos anteriores):
      • 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. Haga una copia de cada archivo encontrado en el paso anterior y cambie el nombre de wcs.bootstrap_multi_en_US_*.xml a 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. Abra cada uno de los archivos creados en el paso anterior para editarlo y sustituya todas las referencias de &en_US; a &en_CA; (valor utilizado en language_id).
    9. Guarde todos los archivos.
  6. Cree los archivos de rutina de arranque de varios idiomas restantes para el francés de Canadá.
    1. Vaya al directorio siguiente:
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Localice el archivo wcs.bootstrap_multi_fr_FR.xml
    3. Haga una copia del archivo y cambie el nombre de wcs.bootstrap_multi_fr_FR.xml a wcs.bootstrap_multi_fr_CA.xml.
    4. Abra el archivo creado en el paso anterior para editarlo; sustituya todas las referencias de fr_FR a fr_CA.
    5. Guarde el archivo.
    6. Localice todos los archivos restantes que empiecen con wcs.bootstrap_multi_fr_FR_*.xml (excluido wcs.bootstrap_multi_en_US_base.xml, ya que este archivo se ha creado y actualizado en los pasos anteriores):
      • 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. Haga una copia de cada archivo encontrado en el paso anterior y cambie el nombre de wcs.bootstrap_multi_fr_FR_*.xml a 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. Abra cada uno de los archivos creados en el paso anterior para editarlo y sustituya todas las referencias de &fr_FR; a &fr_CA; (valor utilizado en language_id).
    9. Guarde todos los archivos.
  7. Cree las características de archivos de rutina de carga para los nuevos idiomas.
    1. Vaya al directorio siguiente:
      • HCL Commerce DeveloperWCDE_installdir\schema\data\xml
    2. Localice los archivos wcs.features_bootstrap_en_US.xml y wcs.features_bootstrap_fr_FR.xml.
    3. Haga una copia de los archivos y cambie su nombre para que refleje sus entornos locales. Es decir, wcs.features_bootstrap_en_CA.xml y wcs.features_bootstrap_fr_CA.xml.
    4. Abra los archivos que se han creado en el paso anterior para editarlos y sustituya todas las referencias de los nombres de entorno local anteriores por los nuevos nombres de entorno local. Es decir, sustituya todas las referencias de &en_US; a &en_CA; para el archivo en inglés de Canadá y de &fr_FR; a &fr_CA; para el archivo en francés de Canadá (valor utilizado en language_id).
    5. Cree el archivo wcs.features_bootstrap.xml e incluya wcs.features_bootstrap_en_CA.xml. Haga una copia del archivo WCDE_installdir\schema\data\xml\wcs.features_bootstrap.xml.template denominado wcs.features_bootstrap.xml. Actualice este archivo con el contenido siguiente:
       <?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>
      Para francés de Canadá, actualice el archivo con fr_CA.
    6. Guarde los archivos.
  8. Cargue los archivos de rutina de carga:
    El programa de utilidad massload ha quedado en desuso en HCL Commerce Versión 9 en favor de dataload. El programa de utilidad necesita tres archivos XML para cada uno de los idiomas inglés de Canadá y francés de Canadá:
    • 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
    Antes de utilizar el programa de utilidad dataload, establezca WCDE_installdir\dataload\massload\wc-dataload-env.xml según el entorno. El siguiente es un ejemplo que actualiza la información de <_config:Database con 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>.
    Para cargar el programa de arranque principal para el Inglés de Canadá:
    1. Edite el archivo de configuración de WCDE_installdir\dataload\massload\wc-dataload.xml. Modifique <_config:DataSourceLocation y establezca el archivo de carga en wcs.bootstrap_en_CA.xml. Por ejemplo:
      <_config:DataSourceLocation location="../../schema/data/xml/wcs.bootstrap_en_CA.xml " />
    2. Abra una ventana de indicador de mandatos y ejecute el programa de utilidad dataload. Consulte Ejecución de programas de utilidad desde Utility server Docker container.
      WCDE_installdir\bin>dataload.bat ..\dataload\massload\wc-dataload.xml 
      Repita estos dos pasos para cargar el programa de arranque principal para francés de Canadá.
  9. Cargue los archivos de rutina de arranque de varios idiomas para añadir el soporte de idioma para HCL Commerce:
    1. Edite el archivo de configuración <_config:DataSourceLocation> de WCDE_installdir\dataload\massload\wc-dataload.xml  y defina el archivo de carga como wcs.bootstrap_multi_en_CA.xml. Por ejemplo: 
      <_config:DataSourceLocation location="../../schema/data/xml/wcs.bootstrap_multi_en_CA.xml" />
    2. Abra una ventana de indicador de mandatos y ejecute el programa de utilidad dataload. Consulte Ejecución de programas de utilidad desde Utility server Docker container. 
      WCDE_installdir\bin>dataload.bat ..\dataload\massload\wc-dataload.xml
    3. Para francés de Canadá, repita estos dos pasos.
    Tras cargar los nuevos archivos de rutina de carga de idioma en la base de datos, HCL Commerce puede incluir datos multiculturales relacionados en el sistema.
  10. Al igual que sucede con el paso anterior, cargue las características archivos de rutina de carga para los nuevos idiomas wcs.features_bootstrap_en_CA.xml y wcs.features_bootstrap_fr_CA.xml.
    1. Edite el archivo <_config:DataSourceLocation> de configuración de WCDE_installdir\dataload\massload\wc-dataload.xml y defina el archivo de carga como wcs.features_bootstrap.xml. Por ejemplo: 
      <_config:DataSourceLocation location="../../schema/data/xml/wcs.features_bootstrap.xml" />
    2. Abra una ventana de indicador de mandatos y ejecute el programa de utilidad dataload. Consulte Ejecución de programas de utilidad desde Utility server Docker container. 
      WCDE_installdir\bin>dataload.bat ..\dataload\massload\wc-dataload.xml
    3. Para francés de Canadá, cambie el nombre de archivo <!ENTITY por wcs.features_bootstrap_fr_CA.xml en wcs.features_bootstrap.xml y repita los pasos a y b.
  11. Indexe los nuevos idiomas en la búsqueda de HCL Commerce, para que los programas de utilidad de búsqueda, el escaparate y el Management Center puedan reconocerlos.

Resultados

La rutina de carga principal se actualiza para incluir los nuevos idiomas y los nuevos archivos de rutina de carga específicos del idioma creados. En el siguiente paso de la guía de aprendizaje ha aprendido a incluir los idiomas nuevos en su instancia de HCL Commerce.