Ejemplo: Cargar widgets de Commerce Composer

Este ejemplo muestra cómo cargar información de widgets de Commerce Composer para registrar un widget y suscribir una tienda a un widget. Después de registrar y suscribir un widget con el programa de utilidad de carga de datos, los usuarios del Management Center pueden utilizar el widget para diseñar páginas de la tienda con la Herramienta Commerce Composer.

Nota: Este ejemplo carga widgets de Commerce Composer de ejemplo así como un diseño y una plantilla de diseño de ejemplo.

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

Al crear un widget de Commerce Composer, además de los elementos de escaparate que debe crear, debe utilizar el programa de utilidad de carga de datos para cargar y registrar la información de definición para el widget. También debe cargar la relación entre el widget y una tienda para suscribir la tienda para que utilice el widget. Una tienda debe suscribirse a un widget para que ese widget esté disponible para que los usuarios puedan incluirlo en una página de dicha tienda. El siguiente ejemplo carga la información necesaria para registrar un widget y hacer que una tienda se suscriba al widget. Al cargar esta información, cree dos widgets, un Widget de sitio de ejemplo y un Widget de tienda de ejemplo. Sin embargo, este ejemplo no crea el escaparate o la definición del Management Center para el widget. Para más información sobre cómo crear un widget, consulte Creación de widgets de Commerce Composer.

Puede cargar esta información de ejemplo en ambos archivos de entrada con formato CSV o XML. No obstante, el siguiente procedimiento carga únicamente los archivos de entrada CSV. Si prefiere trabajar con datos dentro de archivos con formato XML, puede crear los archivos XML y editar los archivos de configuración de ejemplo para cargar los archivos XML. Los archivos de entrada CSV de ejemplo se encuentran dentro del siguiente directorio:

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

Este ejemplo también carga archivos de entrada que se incluyen como parte de los ejemplos para cargar plantillas de diseño de Commerce Composer. Los archivos de entrada para cargar plantillas de diseño se encuentran en el siguiente directorio:

utilities_root/samples/DataLoad/CommerceComposer/template
WCDE_installdir\samples\DataLoad\CommerceComposer\template

Para obtener más información sobre el ejemplo de HCL Commerce para cargar plantillas de diseño de Commerce Composer, consulte Ejemplo: Cargar plantillas de diseño de Commerce Composer.

Si está utilizando este ejemplo como ayuda para crear widgets de Commerce Composer que existen en otra instancia, puede usar 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 suscripción y 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.

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 registerWidgetdef.csv XML registerWidgetdef.xml Para obtener más información sobre los datos que se incluyen en este archivos, consulte Archivo de entrada registerWidgetdef	El programa de utilidad de carga de datos utiliza este archivo de entrada de ejemplo para cargar información que registra contenedores y widgets de plantillas de diseño dentro de la base de datos de HCL Commerce y la infraestructura de Commerce Composer. Este ejemplo carga dos archivos de entrada registerWidgetdef.csv: El archivo registerWidgetdef.csv dentro del directorio widget carga la información para registrar widgets. El archivo registerWidgetdef.csv dentro del directorio template carga la información para registrar contenedores de plantilla para una plantilla. El archivo registerWidgetdef.csv que carga información de contenedor de plantilla también se carga como parte del ejemplo para cargar una plantilla de diseño de Commerce Composer. El orden en el que el programa de utilidad Carga de datos carga la información dentro de estos archivos de entrada se define en el archivo de configuración de orden de carga wc-dataload-widget.xml. El archivo registerWidgetdef.csv dentro del template carga antes el archivo dentro del directorio widget. El programa de utilidad de carga de datos carga la información de estos archivos de 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 estos archivos de entrada: Mediador de objetos de negocio com.ibm.commerce.pagelayout.dataload.mediator.registerWidgetdefMediator Archivo de configuración de objeto de negocio de ejemplo para cargar esta información: `utilities_root/samples/DataLoad/PageComposer/wc-loader-registerWidgetdef.xml` `WCDE_installdir\samples\DataLoad\PageComposer\wc-loader-registerWidgetdef.xml`
CSV subscribeWidgetdef.csv XML subscribeWidgetdef.xml Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada subscribeWidgetdef	Una vez que el programa de utilidad de carga de datos carga la información para registrar los widgets y contenedores, el programa de utilidad carga dos archivos subscribeWidgetdef.csv para suscribir los widgets y contenedores a una tienda. Una tienda debe suscribirse a widgets y contenedores específicos de modo que estos objetos puedan utilizarse en la Herramienta Commerce Composer para dicha tienda. Este ejemplo carga dos archivos subscribeWidgetdef.csv: El archivo subscribeWidgetdef.csv del directorio widget carga la información para suscribir widgets a una tienda. El archivo subscribeWidgetdef.csv del directorio template carga la información para suscribir una plantilla de diseño a una tienda. Este archivo subscribeWidgetdef.csv también se carga como parte del ejemplo para cargar una plantilla de diseño de Commerce Composer. El orden en el que el programa de utilidad Carga de datos carga la información dentro de estos archivos de entrada se define en el archivo de configuración de orden de carga wc-dataload-widget.xml. El archivo subscribeWidgetdef.csv dentro del template carga antes el archivo dentro del directorio widget. El programa de utilidad de carga de datos carga la información de estos archivos de entrada en la tabla de base de datos PLSTOREWIDGET. 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.SubscribeWidgetDefinitionMediator Archivo de configuración de objeto de negocio `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-subscribeWidgetdef.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-subscribeWidgetdef.xml`
CSV template.csv XML template.xml Para obtener más información sobre los datos que se incluyen en este archivos, consulte Archivo de entrada template	Este archivo de entrada carga información para crear la relación entre contenedores de plantilla y una plantilla. Este archivo también se carga como parte del ejemplo para cargar una plantilla de diseño de Commerce Composer. El programa de utilidad de carga de datos carga la información del archivo de entrada en la tabla de base de datos PAGELAYOUT. 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.WidgetMediator Archivo de configuración de objeto de negocio `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-template.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-template.xml`
CSV slotDefinition.csv XML slotDefinition.xml Para obtener más información sobre los datos que se incluyen en este archivos, consulte Archivo de entrada slotDefinition	Este archivo de entrada carga información para definir las ranuras dentro de un contenedor para una plantilla. Cada ranura se define con coordenadas x e y. Management Center utiliza esta información para dibujar el mapa esquemático para la plantilla dentro de la Herramienta Commerce Composer. El programa de utilidad de carga de datos carga la información del archivo de entrada en la tabla de base de datos PLWIDGETSLOT. 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.WidgetSlotsMediator Archivo de configuración de objeto de negocio `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-widgetslot.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-widgetslot.xml`
CSV layout.csv XML layout.xml Para obtener más información sobre los datos que se incluyen en este archivos, consulte Archivo de entrada layout	El programa de utilidad de carga de datos carga este archivo de entrada para cargar información de diseño en una tienda para que los usuarios del Management Center puedan utilizar los diseños en la Herramienta Commerce Composer. El programa de utilidad Carga de datos carga la información del archivo de entrada en las tablas de base de datos PAGELAYOUT y PLTEMPLATEREL. 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.LayoutMediator Archivo de configuración de objeto de negocio `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-pagelayout.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-pagelayout.xml`
CSV layoutWidgetRelationship.csv XML layoutWidgetRelationship.xml Para obtener más información sobre los datos que se incluyen en este archivos, consulte Archivo de entrada layoutWidgetRelationship	Este archivo de entrada carga información sobre la relación entre los widgets, contenedores y un diseño. Este archivo carga la información para asociar un contenedor y un widget con una plantilla de diseño para crear un diseño. El programa de utilidad de carga de datos carga la información del archivo de entrada en las tablas de base de datos PLWIDGET y PLWIDGETREL. 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.WidgetMediator Archivo de configuración de objeto de negocio `utilities_root/samples/DataLoad/CommerceComposer/wc-loader-widget.xml` `WCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-widget.xml`

Este ejemplo carga información de widget para un idioma único. Para obtener más información sobre cómo cargar información descriptiva de widgets en varios idiomas, consulte Ejemplo: Cargar información descriptiva de widgets de Commerce Composer en varios idiomas.

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 un widget de Commerce Composer y cargar la información para este ejemplo:
- ./dataload.sh ../samples/DataLoad/CommerceComposer/widget/wc-dataload-widget.xml
- dataload ..\samples\DataLoad\CommerceComposer\widget\wc-dataload-widget.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 utilizar el widget en la Herramienta Commerce Composer mediante la Creación de 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 los widgets que se han cargado aparecen en la ventana Añadir widgets a ranuras. La siguiente muestra el Widget de sitio de ejemplo y el Widget de tienda de ejemplo dentro de la ventana Añadir widgets a ranuras. Ventana Añadir widget a ranura que contiene widgets de ejemplo

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

Para eliminar los datos de ejemplo de la base, ejecute de nuevo el ejemplo, pero con el valor de la columna delete para todas las entradas dentro de los archivos establecidos en 1. Al establecer el valor de esta columna en 1, el programa de utilidad de carga de datos suprime los datos que se identifican en el archivo CSV de la base de datos.

De forma alternativa, puede ejecutar el archivo Cleanup.sql para este ejemplo de carga de datos. El archivo Cleanup.sql se encuentra en los directorios siguientes:

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

Desde un indicador de mandatos, conéctese a la base de datos con su ID de usuario y contraseña. Ejecute el siguiente mandato

db2 -tvf ../samples/DataLoad/CommerceComposer/widget/Cleanup.sql

sqlplus user_name/password@ database_name@ ../samples/DataLoad/CommerceComposer/widget/Cleanup.sql