Ejemplo: Extraer widgets de Commerce Composer

Este ejemplo muestra cómo extraer los widgets 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 widgets entre instancias o tiendas.

Un widget, también llamado widget de diseño, es un marco que muestra un tipo específico de contenido de la tienda, como anuncios, recomendaciones de productos o enlaces de navegación. Para obtener más información sobre widgets, consulte Widgets para Commerce Composer.

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 widget 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 widgets y los datos relacionados con widgets 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 los widgets asignados a los diseños para la tienda especificada. Los datos extraídos incluyen toda la información que necesita para registrar y suscribir los widgets a una tienda en otra instancia de HCL Commerce. Esta información incluye toda la información descriptiva de widgets que está disponible para los widgets. Esta información incluye información descriptiva que está disponible en varios idiomas.

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:

utilities_root/samples/DataExtract/CommerceComposer
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-widget.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

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 registro de contenedor de plantilla de diseño y widgets. El programa de utilidad extrae los datos para los dos tipos de objetos de las siguientes tablas de base de datos:

El programa de utilidad genera dos archivos registerWidgetdef.csv para incluir los datos extraídos. Estos archivos pueden utilizarse para cargar datos para registrar un nuevo widget o contenedor de plantilla dentro de la herramienta Commerce Composer.

El archivo registerWidgetdef.csv en el directorio widget incluye datos de suscripción de widgets.
El archivo registerWidgetdef.csv en el directorio template incluye datos de suscripción de contenedor de plantilla de diseño.

Para obtener más información sobre los datos que pueden incluirse en estos archivos, 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:

PLSTOREWIDGET

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 widget 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.

Para obtener más información sobre los datos que pueden incluirse en estos archivos, 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:

PAGELAYOUT

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:

PLWIDGETSLOT

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-registerWidgetdef-MultiLanaguages.xml

Este archivo se utiliza para configurar el programa de utilidad para extrae datos de registro de widget que están en varios idiomas. El programa de utilidad extrae estos datos de las siguientes tablas de base de datos:

El programa de utilidad genera el archivo de salida registerWidgetDefWithMultiLanguages.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar los datos de registro en varios idiomas. Este archivo incluye información para el idioma que se especifique en el contexto de negocio del archivo de configuración de entorno y para cualquier otro idioma donde los datos de registro estén disponibles. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada registerWidgetdef.

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.

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 widget en archivos de salida CSV:
- ./dataextract.sh ../samples/DataExtract/CommerceComposer/wc-dataextract-widget.xml
- dataextract ..\samples\DataExtract\CommerceComposer\wc-dataextract-widget.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 widgets que existen para el ID de tienda configurado. Estos archivos también incluyen los datos para plantillas de diseño y todos los datos de relación para los widgets asignados a 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:
- widget/registerWidgetdef.csv
- widget/subscribeWidgetdef.csv
- widget/layout.csv
- widget/layoutWidgetRelationship.csv
- widget/MultiLanguages/registerWidgetdefWithMultiLanguages.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 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 widgets, 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.

Si desea cargar información descriptiva de widgets en varios idiomas, cargue primero la información para el idioma de tienda predeterminado. A continuación, cargue la información para varios idiomas. Puede especificar el idioma predeterminado en el contexto de negocio del archivo de configuración de entorno. Al cargar primero la información en el idioma predeterminado configurado, se podrá reducir el riesgo de que se produzcan errores durante la operación de carga. Para ver un ejemplo que muestra cómo cargar información descriptiva de widgets en varios idiomas, consulte Ejemplo: Cargar información de SEO de páginas de Commerce Composer en varios idiomas. Cuando siga el ejemplo, utilice el enfoque de archivo único y edite el archivo de configuración de orden de carga para especificar el archivo CSV que ha generado el Programa de utilidad de extracción de datos.