Ejemplo: Extraer plantillas de diseño de Commerce Composer
Este ejemplo muestra cómo extraer las plantillas de diseño 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 las plantillas entre instancias o tiendas.
Una plantilla de diseño es un punto de partida reutilizable que puede utilizarse para crear un diseño. Una plantilla de diseño es un mapa esquemático que incluye una disposición específica de las ranuras. Para crear un diseño, se asignan widgets a estas ranuras. Para obtener más información sobre plantillas de diseño, consulte Diseños, plantillas de diseño y diseños predeterminados.
Antes de empezar
- Verifique que la tienda de la que desea extraer datos incluye datos de plantilla de diseño de Commerce Composer para extraer.
Acerca de este ejemplo
Al ejecutar este ejemplo, el Programa de utilidad de extracción de datos se configura para extraer las plantillas de diseño 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.
utilities_root/samples/DataExtract/CommerceComposer
WCDE_installdir\samples\DataExtract\CommerceComposer
Archivos de configuración de ejemplo
- 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-template.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
- Este archivo se utiliza para configurar el programa de utilidad para que extraiga datos de suscripción de contenedor de plantilla de 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 subscribeWidgetdef.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar los datos para suscribir contenedores de plantilla de diseño para una tienda. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada subscribeWidgetdef.
- 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
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 plantilla en archivos de salida CSV:
./dataextract.sh ../samples/DataExtract/CommerceComposer/wc-dataextract-template.xml
dataextract ..\samples\DataExtract\CommerceComposer\wc-dataextract-template.xml
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
- 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 las plantillas 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 plantilla, consulte Ejemplo: Cargar plantillas de diseño 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.