Ejemplo: Cargar información descriptiva de widgets de Commerce Composer en varios idiomas

Este ejemplo muestra cómo cargar información descriptiva para Commerce Composer en varios idiomas para utilizarla en el Management Center y el escaparate.

Antes de empezar

Este ejemplo requiere una tienda publicada que esté basada en la tienda de inicio Aurora y la Herramienta Commerce Composer. Asegúrese de completar las tareas siguientes:

Revise los Métodos recomendados para la carga de datos de Commerce Composer. Siga estos métodos recomendados al cargar elementos de Commerce Composer con el programa de utilidad de carga de datos.

Acerca de este ejemplo

Si tiene widgets de Commerce Composer para la tienda, puede utilizar el programa de utilidad de carga de datos para cargar información descriptiva para los widgets en más idiomas. Este ejemplo carga la información descriptiva para un widget en dos idiomas, inglés (en_US) y francés (fr_FR). Para obtener más información sobre los idiomas que están soportados de forma predeterminada, consulte Soporte de la globalización.

Para poder cargar información descriptiva para un widget, el widget se debe crear, registrar y suscribir a una tienda. Para obtener más información sobre la creación de widgets, consulte Creación de widgets de Commerce Composer. Para obtener más información sobre cómo cargar información para registrar y suscribir widgets a una tienda, consulte Ejemplo: Cargar widgets de Commerce Composer.

Puede cargar esta información de ejemplo en ambos archivos de entrada con formato CSV o XML. Sin embargo, el siguiente procedimiento carga solamente los archivos de entrada CSV. Si prefiere trabajar con datos dentro de los archivos con formato XML, puede editar los archivos de configuración de ejemplo para que utilicen los archivos XML. Los archivos de entrada de ejemplo se encuentran dentro del siguiente directorio:

utilities_root/samples/DataLoad/CommerceComposer/widget/MultiLanguages
WCDE_installdir\samples\DataLoad\CommerceComposer\widget\MultiLanguages

Para cargar este ejemplo, puede cargar la información de idiomas en distintos archivos o dentro de un único archivo.

Para cargar la información en un solo archivo, cargue el archivo de configuración de orden de carga de datos wc-dataload-widgetdefdesc-one-step-lang.xml. Al ejecutar este archivo de orden de carga, el programa de utilidad de carga de datos carga la información dentro del archivo de entrada de ejemplo registerWidgetdefdescWithTwoLanguages.csv. El archivo registerWidgetdefdescWithTwoLanguages.csv contiene varias columnas de nombre de visualización y descripción. Ambas columnas de descripción se correlacionan con la misma columna de base de datos. Las dos columnas de visualización también se correlacionan con la misma columna. Sin embargo, el archivo de configuración de objeto de negocio configura el programa de utilidad de carga de datos para que cree entradas distintas para el widget dentro de la base de datos, una para cada idioma.
Nota: La configuración que maneja la carga de información en varios idiomas para esta opción se define en el archivo de configuración de objeto de negocio.
Para cargar la información de varios idiomas en archivos separados, cargue el archivo wc-dataload-widgetdefdesc-two-step-lang.xml. Al ejecutar este archivo de orden de carga, el programa de utilidad de carga de datos carga la información dentro del archivo de entrada de ejemplo registerWidgetdefLanguageOne.csv y registerWidgetdefdescLanguageTwo.csv. El archivo registerWidgetdefLanguageOne.csv incluye la información para registrar la información del widget y del idioma predeterminado (inglés). El archivo registerWidgetdefdescLanguageTwo.csv incluye la información para cargar la información para el widget en francés.
Nota: Cuando se utiliza el método de archivos separados, la configuración que identifica el idioma que se está cargando dentro se define en el archivo de configuración de orden de carga de datos.

Si utiliza este ejemplo como ayuda para cargar información de widgets de Commerce Composer que existen en otra instancia, puede utilizar el Programa de utilidad de extracción de datos para generar los archivos de entrada para cargar los datos de widgets. Puede utilizar el Programa de utilidad de extracción de datos para extraer los datos de registro de widgets existentes. Después podrá editar archivos de configuración para que este ejemplo cargue los archivos generados por el Programa de utilidad de extracción de datos. Para ver un ejemplo que muestra cómo utilizar elPrograma de utilidad de extracción de datos para extraer datos de widgets, consulte Ejemplo: Extraer widgets de Commerce Composer. Dado que los archivos de ejemplo del Programa de utilidad de extracción de datos extraen la información descriptiva de widgets para todos los idiomas en un solo archivo, utilice el método de un solo archivo para cargar los datos extraídos.

La siguiente tabla lista los archivos de entrada de ejemplo que se usan para cargar los datos en este ejemplo. La tabla también identifica los mediadores de objetos de negocio y los archivos de configuración de objeto de negocio que el programa de utilidad de carga de datos utiliza para cargar los datos de ejemplo.
Archivo de entrada de ejemplo	Descripción:
CSV registerWidgetdefLanguageOne.csv XML registerWidgetdefLanguageOne.xml Para obtener más información sobre el tipo de datos dentro del archivo de entrada, consulte Archivo de entrada registerWidgetdef	El programa de utilidad de carga de datos carga la información para registrar un widget para utilizarlo en la Herramienta Commerce Composer. El programa de utilidad de carga de datos carga la información descriptiva dentro de los archivos de entrada en las tablas de base de datos PLWIDGETDEF y PLWIDGETDEFDESC. El programa de utilidad de carga de datos utiliza el siguiente mediador de objetos de negocio y el archivo de configuración de objeto de negocio para cargar los datos dentro de este archivo de entrada: Mediador de objetos de negocio com.ibm.commerce.pagelayout.dataload.mediator.RegisterWidgetDefMediator Archivo de configuración de objeto de negocio `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-registerWidgetdef.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-registerWidgetdef.xml`
CSV registerWidgetdefdescLanguageTwo.csv XML registerWidgetdefdescLanguageTwo.xml Para obtener más información sobre el tipo de datos dentro del archivo de entrada, consulte Archivo de entrada registerWidgetdefdesc	El programa de utilidad de carga de datos carga la información descriptiva de un widget en varios idiomas. El programa de utilidad de carga de datos carga la información descriptiva dentro de los archivos de entrada en las tablas de base de datos PLWIDGETDEF y PLWIDGETDEFDESC. El programa de utilidad de carga de datos utiliza el siguiente mediador de objetos de negocio y el archivo de configuración de objeto de negocio para cargar los datos dentro de este archivo de entrada: Mediador de objetos de negocio com.ibm.commerce.pagelayout.dataload.mediator.RegisterWidgetDefMediator Archivo de configuración de objeto de negocio `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-registerWidgetdefdesc.xml` `WCDE_installdir\samples/DataLoad/CommerceComposer/wc-loader-registerWidgetdefdesc.xml`
CSV registerWidgetdefdescWithTwoLanguages.csv XML registerWidgetdefdescWithTwoLanguages.csv	Este archivo de entrada de ejemplo contiene la información para registrar el widget y la información descriptiva del widget dentro de un solo archivo. Este archivo de ejemplo incluye el contenido de los archivos de entrada de ejemplo registerWidgetdefLanguageOne.csv y registerWidgetdefdescLanguageTwo.csv. Mediador de objetos de negocio com.ibm.commerce.pagelayout.dataload.mediator.RegisterWidgetDefMediator Archivo de configuración de objeto de negocio `utilities_root/samples/DataLoad/CommerceComposer/widget/MultiLanguages/wc-loader-registerWidgetdefdesc-two-langs.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\widget\MultiLanguages\wc-loader-registerWidgetdefdesc-two-langs.xml`

Procedimiento

En una línea de mandatos, vaya al directorio WCDE_installdir\bin.
Abra una línea de mandatos en . Cambie el directorio a utilities_root/bin. Para obtener información sobre cómo entrar y salir de los contenedores, consulte Ejecución de programas de utilidad desde Utility server Docker container.
Escriba el siguiente mandato para ejecutar el archivo de orden de carga de datos de ejemplo para cargar la información descriptiva de widget en varios idiomas:
- Para cargar la información descriptiva dentro de un único archivo de entrada de ejemplo:
  - ./dataload.sh ../samples/DataLoad/CommerceComposer/widget/MultiLanguages/wc-dataload-widgetdefdesc-one-step-lang.xml
  - dataload ..\samples\DataLoad\CommerceComposer\widget\MultiLanguages\wc-dataload-widgetdefdesc-one-step-lang.xml
- Para cargar la información descriptiva dentro de archivos de entrada de ejemplo separados:
  - ./dataload.sh ../samples/DataLoad/CommerceComposer/widget/MultiLanguages/wc-dataload-widgetdefdesc-two-step-lang.xml
El archivo de configuración de orden de carga identifica el orden en el que el programa de utilidad de carga de datos carga los archivos CSV de ejemplo. El archivo de orden de carga también identifica el archivo de configuración de objeto de negocio adecuado que se debe utilizar para cargar cada archivo de entrada. Para obtener más información sobre los archivos de configuración de orden de carga, consulte Configuración del orden de carga de datos.
Para obtener más información sobre la configuración y ejecución del programa de utilidad de carga de datos, consulte Configuración y ejecución del programa de utilidad de carga de datos.

Verificación del resultado

Verifique que la información de widgets de Herramienta Commerce Composer se ha cargado revisando el informe de resumen de carga de datos. Para obtener más información sobre la ubicación y el contenido de este informe de resumen, consulte Verificar los resultados de la carga de datos.

También puede verificar que los datos de ejemplo se hayan cargado ejecutando las sentencias SQL siguientes en la base de datos de :

select * from PLWIDGETDEF where IDENTIFIER like 'Sample%';
select * from PLWIDGETDEFDESC where PLWIDGETDEF_ID in (select PLWIDGETDEF_ID from PLWIDGETDEF where IDENTIFIER
like 'Sample%');
select * from PLSTOREWIDGET where PLWIDGETDEF_ID in (select PLWIDGETDEF_ID from PLWIDGETDEF where IDENTIFIER
like 'Sample%');

Asegúrese de que los datos de los archivos de entrada de ejemplo existen en las tablas de base de datos adecuadas.

En el Management Center, verifique que los usuarios pueden ver la descripción en el idioma francés para el widget en la Herramienta Commerce Composer. Inicie la sesión en el centro de Gestión en el idioma francés y cree un diseño para una página. Cuando se crea el diseño, seleccione una ranura de plantilla para añadir un widget a la ranura. Asegúrese de que la descripción de idioma adecuado para el widget aparece en la ventana Añadir widgets a ranuras.

Eliminar los datos de ejemplo de la base de datos de HCL Commerce

Para eliminar los datos de ejemplo de la base de datos, vuelva a ejecutar el ejemplo pero con el valor para la columna de supresión para todas las entradas de los archivos establecido en 1. Al establecer el valor para esta columna en 1, el programa de utilidad de carga de datos suprime de la base de datos los datos que se identifican en el archivo CSV.