Ejemplo: Cargar plantillas de diseño de Commerce Composer

Este ejemplo muestra cómo cargar las plantillas de diseño de Commerce Composer para utilizarlas al crear diseños con la Herramienta Commerce Composer.

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:

Acerca de este ejemplo

Una plantilla de diseño es un punto de partida reutilizable que puede utilizarse al crear un diseño. Una plantilla de diseño es un mapa esquemático que incluye una disposición específica de las ranuras. Cuando un usuario crea un diseño en la Herramienta Commerce Composer, los widgets se asignan a estas ranuras.

Al cargar los archivos de entrada CSV de ejemplo para este ejemplo, se crean las siguientes plantillas de diseño en la Herramienta Commerce Composer
  • Ejemplo de cualquier página, cinco ranuras, barra lateral derecha
  • Ejemplo de cualquier página, una ranura
  • Ejemplo de departamento
  • Ejemplo de página de inicio
Puede cargar la información para este 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:
  • Linuxutilities_root/samples/DataLoad/CommerceComposer/template
  • HCL Commerce DeveloperWCDE_installdir\samples\DataLoad\CommerceComposer\template

Si está utilizando este ejemplo como ayuda para crear plantillas de diseño 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 plantillas. Puede utilizar el Programa de utilidad de extracción de datos para extraer los datos de plantilla 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 plantillas, consulte Ejemplo: Extraer plantillas de diseño de Commerce Composer.

Archivos de origen de entrada para cargar plantillas de diseño de Commerce Composer. Esta tabla también lista los mediadores de objetos de negocio que utiliza el programa de utilidad de carga de datos para cargar los datos de plantillas.
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 para registrar un contenedor de plantilla para utilizarlo al crear la plantilla.

El programa de utilidad de carga de datos carga la información del archivo 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 de ejemplo para cargar esta información:
  • Linuxutilities_root/samples/DataLoad/CommerceComposer/wc-loader-registerWidgetdef.xml
  • HCL Commerce DeveloperWCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-registerWidgetdef.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 de ejemplo carga información para definir las ranuras dentro de un contenedor para una plantilla. Cada ranura se define con las coordenadas X e Y.

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
  • Linuxutilities_root/samples/DataLoad/CommerceComposer/wc-loader-widgetslot.xml
  • HCL Commerce DeveloperWCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-widgetslot.xml
CSV
  • subscribeWidgetdef.csv
XML
  • subscribeWidgetdef.xml

Para obtener más información sobre los datos que se incluyen en este archivos, consulte Archivo de entrada subscribeWidgetdef

Este archivo de entrada de ejemplo carga información para suscribir un contenedor de plantilla a una tienda.

El programa de utilidad de carga de datos carga la información del archivo 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
  • Linuxutilities_root/samples/DataLoad/CommerceComposer/wc-loader-subscribeWidgetdef.xml
  • HCL Commerce DeveloperWCDE_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 de ejemplo carga información que define la plantilla.

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
  • Linuxutilities_root/samples/DataLoad/CommerceComposer/wc-loader-template.xml
  • HCL Commerce DeveloperWCDE_installdir\samples\DataLoad\CommerceComposer\wc-loader-template.xml

Procedimiento

  1. HCL Commerce DeveloperEn una línea de mandatos, vaya al directorio WCDE_installdir\bin.
  2. LinuxAbra 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.
  3. Escriba el siguiente mandato para ejecutar el archivo de orden de carga de datos de ejemplo para una plantilla de diseño de Commerce Composer y cargar la información para este ejemplo:
    • Linux./dataload.sh ../samples/DataLoad/CommerceComposer/template/wc-dataload-template.xml
    • HCL Commerce Developerdataload ..\samples\DataLoad\CommerceComposer\template\wc-dataload-template.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 página de Herramienta Commerce Composer se ha cargado al revisar 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 HCL Commerce:
select * from PLWIDGET where PAGELAYOUT_ID in (select PAGELAYOUT_ID from PAGELAYOUT where name like 'Sample%');
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%');
select * from PAGELAYOUT where name like 'Sample%';
select * from PLWIDGETREL where PLWIDGET_ID_CHILD in (select PLWIDGET_ID 
 from PLWIDGET where PAGELAYOUT_ID in (select PAGELAYOUT_ID from PAGELAYOUT where name like 'Sample%'));
select * from PLWIDGETSLOT where PAGELAYOUT_ID in (select PAGELAYOUT_ID from PAGELAYOUT where name 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 la plantilla de diseño de Herramienta Commerce Composer mediante la Creación de un diseño para una página. Cuando se crea el diseño, seleccione una plantilla para utilizarla para su diseño. Asegúrese de que las plantillas que se han cargado están en la ventana Nueva selección de plantilla de diseño. La siguiente imagen muestra las nuevas plantillas de diseño dentro de la ventana Nueva selección de plantilla de diseño. VentanaNueva selección de plantilla de diseño que contiene plantillas 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:
  • Linuxutilities_root/samples/DataLoad/CommerceComposer/template
  • HCL Commerce DeveloperWCDE_installdir\samples\DataLoad\CommerceComposer\template
Desde un indicador de mandatos, conéctese a la base de datos con su ID de usuario y contraseña. Ejecute el mandato siguiente:
DB2
  • Linuxdb2 -tvf ../samples/DataLoad/CommerceComposer/template/Cleanup.sql
Oracle
  • Linuxsqlplus user_name/password@ database_name@ ../samples/DataLoad/CommerceComposer/template/Cleanup.sql