Ejemplo: Extraer diseños de Commerce Composer
Este ejemplo muestra cómo extraer los diseños de Commerce Composer para una tienda con el Programa de utilidad de extracción de datos. Entonces podrá utilizar el Programa de utilidad de carga de datos para cargar los datos extraídos en otra instancia o tienda de HCL Commerce para copiar rápidamente los diseños entre instancias o tiendas.
Un diseño es una disposición de widgets de diseño dentro de una plantilla de diseño que se utiliza para representar una página de tienda. Un diseño contiene uno o más widgets que se colocan en espacios específicos de la plantilla. Las propiedades (pares nombre-valor) de cada widget dentro de un diseño se establecen en valores específicos. Para obtener más información sobre diseños, consulte Diseños, plantillas de diseño y diseños predeterminados.
Antes de empezar
Asegúrese de llevar a cabo las siguientes tareas:
- Verifique que la tienda de la que desea extraer datos incluye datos de diseño de Commerce Composer para extraer.
Nota: Si tiene previsto cargar los datos extraídos en otra instancia, la tienda en la que desea cargar datos debe tener habilitada la herramienta Commerce Composer. La tienda de inicio Aurora está habilitada para utilizar la herramienta Commerce Composer.
Acerca de este ejemplo
Al ejecutar este ejemplo, el Programa de utilidad de extracción de datos se configura para extraer los diseños solo para la tienda que se especifique. Puede especificar la tienda en el archivo de configuración de entorno o directamente en la línea de mandatos cuando ejecute el programa de utilidad.
Al ejecutar este ejemplo, el programa de utilidad también extrae los datos de plantilla de diseño y los datos de relación para todos los widgets asignados a los diseños para la tienda especificada. No se extraen los datos para los widgets de diseño que se han registrado o suscrito a una tienda. Debe extraer estos datos de widget en una operación independiente. Para obtener más información sobre cómo extraer estos datos de widget, consulte Ejemplo: Extraer widgets de Commerce Composer.
Los archivos de configuración de ejemplo que se utilizan para configurar el Programa de utilidad de extracción de datos están en el siguiente directorio y subdirectorios:
WCDE_installdir\samples\DataExtract\CommerceComposer
Archivos de configuración de ejemplo
Los siguientes archivos de configuración se utilizan para configurar el Programa de utilidad de extracción de datos para que extraiga datos en archivos de salida CSV.
- wc-dataextract-env.xml
- El archivo de configuración de entorno. Este archivo incluye las variables de entorno para la instancia de HCL Commerce . Estas variables incluyen la siguiente información:
- Las variables de contexto de negocio, incluidos el identificador de tienda, el identificador de catálogo y el idioma y la moneda predeterminados para la tienda.
- Los valores de entorno de base de datos, incluido el tipo, el nombre y el esquema de base de datos.
- wc-dataextract-layout.xml
- El archivo de configuración de orden de extracción de datos. Este archivo especifica las vías de acceso al archivo de configuración de entorno y a los archivos de configuración de objeto de negocio para extraer los datos para cada tipo de objeto. El archivo de configuración de orden también identifica el orden en el que Programa de utilidad de extracción de datos extrae datos e identifica los archivos de salida que el programa de utilidad genera para incluir los datos extraídos.
- wc-extract-business-object.xml
- El archivo de configuración de objeto de negocio. Este archivo define cómo el programa de utilidad identifica los datos que se van a extraer y define el mediador de objetos de negocio para que el programa de utilidad lo utilice para transformar los datos extraídos. En este ejemplo, todos los archivos de configuración de objeto de negocio configuran el programa de utilidad para que utilice el siguiente mediador de objetos de negocio:
com.ibm.commerce.foundation.dataload.businessobjectmediator.AssociationObjectMediator
Los siguientes archivos de configuración de objeto de negocio se utilizan para configurar el Programa de utilidad de extracción de datos para este ejemplo:- wc-extract-registerWidgetdef.xml
- Este archivo se utiliza para configurar el programa de utilidad para que extraiga datos de registro de contenedor de plantilla de diseño. El programa de utilidad extrae estos datos de las siguientes tablas de base de datos:El programa de utilidad genera el archivo registerWidgetdef.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar datos para registrar un nuevo contenedor de plantilla de diseño dentro de la herramienta Commerce Composer. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada registerWidgetdef
- wc-extract-subscribeWidgetdef.xml
- Hay dos archivos wc-extract-registerWidgetdef.xml que se utilizan en este ejemplo. Estos archivos se utilizan para configurar el programa de utilidad para extraer datos de suscripción de contenedor de plantilla de diseño y widgets. El programa de utilidad extrae los datos para los dos tipos de objetos de la siguiente tabla de base de datos:El programa de utilidad genera 2 archivos de salida subscribeWidgetdef.csv de modo que incluya los datos extraídos. Estos archivos podrán utilizarse para cargar los datos para suscribir widgets y contenedores de plantilla de diseño para una tienda.
- El archivo subscribeWidgetdef.csv en el directorio layout incluye datos de suscripción de widgets.
- El archivo subscribeWidgetdef.csv en el directorio template incluye datos de suscripción de contenedor de plantilla de diseño.
- wc-extract-template.xml
- Este archivo se utiliza para configurar el programa de utilidad para que extraiga los datos de plantilla de diseño básico. El programa de utilidad extrae estos datos de la siguiente tabla de base de datos:El programa de utilidad genera el archivo de salida template.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar los datos para crear plantillas de diseño en la herramienta Commerce Composer. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada template.
- wc-extract-slotDefinition.xml
- Este archivo se utiliza para configurar el programa de utilidad para extraer las definiciones de ranura de mapa esquemático para las plantillas de diseño. Cada ranura de mapa esquemático se define con las coordenadas X e Y y se utiliza para organizar widgets dentro de un diseño. El programa de utilidad extrae estos datos de la siguiente tabla de base de datos:El programa de utilidad genera el archivo de salida slotdefinition.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar los datos para asignar las coordenadas de mapa esquemático a una plantilla. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada slotDefinition
- wc-extract-pagelayout.xml
- Este archivo se utiliza para configurar el programa de utilidad para que extraiga datos de diseño básicos para los diseños que existen para una tienda. El programa de utilidad extrae estos datos de las siguientes tablas de base de datos: El programa de utilidad genera el archivo de salida layout.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar los datos para crear diseños en una tienda. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada layout.
- wc-extract-widget.xml
- Este archivo se utiliza para configurar el programa de utilidad para extraer los datos de relaciones para asignar contenedores de plantilla de diseño y widgets a los diseños. El programa de utilidad extrae estos datos de las siguientes tablas de base de datos: El programa de utilidad genera el archivo layoutWidgetRelationship.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para asignar widgets a diseños en otra tienda o instancia. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada layoutWidgetRelationship.
- wc-extract-widgetnvp.xml
- Este archivo se utiliza para configurar el programa de utilidad para que extraiga datos de las propiedades de pares nombre-valor de los widgets asignados a diseños. El programa de utilidad extrae estos datos de la siguiente tabla de base de datos:El programa de utilidad genera el archivo widgetnvp.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para configurar las propiedades para widgets que se asignan a los diseños para una tienda. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte widgetnvp archivo de entrada.
Procedimiento
- Copie los archivos y directorios de configuración de ejemplo en un directorio local.
- Edite la copia del archivo de configuración de entorno de ejemplo para establecer las variables de configuración para su entorno. El archivo de configuración de ejemplo que se utiliza en este ejemplo incluye valores para un entorno de HCL Commerce Developer predeterminado que utiliza una base de datos de Apache Derby. Si sus valores de entorno son distintos, debe cambiar los valores configurados en el archivo de configuración de entorno de modo que coincidan con el entorno. Para obtener más información sobre cómo actualizar el archivo de configuración de entorno, consulte Configurar los valores de entorno de carga de datos.
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 la configuración de orden de extracción de datos de ejemplo para extraer los datos de diseño en archivos de salida CSV:
./dataextract.sh ../samples/DataExtract/CommerceComposer/wc-dataextract-layout.xml- dataextract ..\samples\DataExtract\CommerceComposer\wc-dataextract-layout.xml
Cuando el programa de utilidad finaliza el proceso de extracción, el programa de utilidad genera los archivos de salida CSV dentro del directorio y los subdirectorios de salida configurados. Estos archivos incluyen datos para todos los diseños que existen para el ID de tienda configurado. Estos archivos también incluyen los datos para las plantillas de diseño que utilizan los diseños y los datos de relación para todos los widgets asignados a los diseños. De forma predeterminada, los archivos se generan en el siguientes directorio y subdirectorios de salida:
- utilities_root/samples/DataExtract/CommerceComposer/output
- WCDE_installdir\samples\DataExtract\CommerceComposer\output
Verificación del resultado
- Vaya al directorio que ha configurado como directorio de salida. Si no ha configurado un directorio de salida, vaya al siguiente directorio:
- utilities_root/samples/DataExtract/CommerceComposer/output
- WCDE_installdir\samples\DataExtract\CommerceComposer\output
- Verifique que se generan los siguientes archivos de salida CSV:
- template/registerWidgetdef.csv
- template/subscribeWidgetdef.csv
- template/template.csv
- template/slotDefinition.csv
- layout/subscribeWidgetdef.csv
- layout/layout.csv
- layout/layoutWidgetRelationship.csv
- layout/widgetnvp.csv
- Abra los archivos CSV de salida para revisar el contenido del archivo.
- Verifique que el contenido del archivo coincide con los datos de la base de datos para los diseños que pertenecen a la tienda especificada.
Qué hacer a continuación
Puede cargar los datos extraídos en otra instancia de HCL Commerce con el Programa de utilidad de carga de datos . Para ver un ejemplo que muestra cómo cargar los datos de diseño, consulte Ejemplo: Cargar diseños de Commerce Composer. Cuando siga este ejemplo, edite el archivo de configuración de orden de carga para especificar los archivos CSV generados por el Programa de utilidad de extracción de datos.