Ejemplo: Extraer páginas de Commerce Composer

Este ejemplo muestra cómo extraer páginas y contenido de páginas de Commerce Composer, como por ejemplo información de SEO, diseños, plantillas de diseño y widgets. Este ejemplo utiliza el Programa de utilidad de extracción de datos para extraer los datos de Commerce Composer para una tienda específica. 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 páginas y contenido de páginas entre instancias o tiendas.

En la infraestructura de Commerce Composer, una página es un URL específico en el escaparate. Cada página puede incluir información de SEO específica y se le puede asignar uno o varios diseños para visualizar widgets en la página. Para obtener más información sobre páginas, consulte Páginas y creación de páginas.

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 página 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 las páginas y los datos relacionados con páginas 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.

Los datos relacionados con la página extraída incluyen toda la información de SEO que están disponible para las páginas extraídas. Esta información incluye información de SEO que está disponible en varios idiomas. El programa de utilidad también extrae datos para plantillas de diseño, diseños y asignaciones de diseño para las páginas.

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:
  • Linuxutilities_root/samples/DataExtract/CommerceComposer
  • HCL Commerce DeveloperWCDE_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 que el programa de utilidad los utilice para una tienda.
  • Los valores de entorno de base de datos, incluido el tipo, el nombre y el esquema de base de datos.
wc-dataextract-page.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 de salida 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
Se utilizan dos archivos wc-extract-registerWidgetdef.xml en este ejemplo para configurar el programa de utilidad. Un archivo se utiliza para configurar el programa de utilidad para extraer datos de suscripción de widgets. El otro archivo se utiliza para configurar el programa de utilidad para extraer datos de suscripción de contenedor de plantilla. 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.
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: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-page.xml
Este archivo se utiliza para configurar el programa de utilidad para que extraiga datos de página básicos para las páginas de Commerce Composer 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 page.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar los datos para crear páginas en una tienda. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada page.
wc-extract-seopage.xml
Este archivo configura el programa de utilidad para extraer los datos de la propiedad Optimización de motor de búsqueda personalizada (SEO) para páginas de contenido. El programa de utilidad extrae estos datos de las siguientes tablas de base de datos:El programa de utilidad genera el archivo de salida seopage.xml de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar la propiedad SEO personalizada para las páginas correspondientes en otra tienda o instancia. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte seopage archivo de entrada.
wc-extract-seopagedesc.xml
Este archivo configura el programa de utilidad para extraer información descriptiva de SEO para las páginas de contenido en el idioma que se especifique en el contexto de negocio del archivo de configuración de entorno. El programa de utilidad extrae estos datos de las siguientes tablas de base de datos:El programa de utilidad genera el archivo de salida seopagedesc.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar la información descriptiva de SEO para las páginas correspondientes en otra tienda o instancia. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte seopagedesc archivo de entrada
wc-extract-seopagedesc-MultiLanaguages.xml
Este archivo configura el programa de utilidad para extraer información descriptiva de SEO para las páginas de contenido 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 seopagedescWithMultiLanguages.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar información descriptiva de SEO 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 la información de SEO esté disponible. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte seopage archivo de entrada.
wc-extract-layoutAssignment.xml
Este archivo configura el Programa de utilidad de extracción de datos para extraer datos que asignan diseños a las páginas. El programa de utilidad extrae estos datos de las siguientes tablas de base de datos:El programa de utilidad genera el archivo de salida layoutAssignment.csv de modo que incluya los datos extraídos. Este archivo podrá utilizarse para cargar al relación para asignar diseños a páginas. Para obtener más información sobre los datos que pueden incluirse en este archivo, consulte Archivo de entrada layoutAssignment.

Procedimiento

  1. Copie los archivos y directorios de configuración de ejemplo en un directorio local.
  2. 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.
  3. HCL Commerce DeveloperEn una línea de mandatos, vaya al directorio WCDE_installdir\bin.
  4. 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.
  5. Escriba el siguiente mandato para ejecutar la configuración de orden de extracción de datos de ejemplo para extraer los datos de página en archivos de salida CSV:
    • Linux./dataextract.sh ../samples/DataExtract/CommerceComposer/wc-dataextract-page.xml
    • HCL Commerce Developerdataextract ..\samples\DataExtract\CommerceComposer\wc-dataextract-page.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 todas las páginas que existen para el ID de tienda configurado. De forma predeterminada, los archivos se generan en el siguientes directorio y subdirectorios de salida:
  • Linuxutilities_root/samples/DataExtract/CommerceComposer/output
  • HCL Commerce DeveloperWCDE_installdir\samples\DataExtract\CommerceComposer\output

Verificación del resultado

  1. Vaya al directorio que ha configurado como directorio de salida. Si no ha configurado un directorio de salida, vaya al siguiente directorio:
    • Linuxutilities_root/samples/DataExtract/CommerceComposer/output
    • HCL Commerce DeveloperWCDE_installdir\samples\DataExtract\CommerceComposer\output
  2. Verifique que se generan los siguientes archivos de salida CSV:
    • template/registerWidgetdef.csv
    • template/subscribeWidgetdef.csv
    • widget/subscribeWidgetdef.csv
    • template/template.csv
    • template/slotDefinition.csv
    • widget/layout.csv
    • page/page.csv
    • page/seopage.csv
    • page/seopagedesc.csv
    • page/layoutAssignment.csv
    • page/MultiLanguages/seopagedescWithMultiLanguages.csv
  3. Abra los archivos CSV de salida para revisar el contenido del archivo.
  4. Verifique que el contenido del archivo coincide con los datos de la base de datos para las páginas 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 solamente los datos de página, consulte Ejemplo: Carga de páginas 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 páginas de SEO en varios idiomas, cargue primero la información de SEO para el idioma de tienda predeterminado. A continuación, cargue la información de SEO para varios idiomas. Al cargar primero la información en el idioma predeterminado, se podrá reducir el riesgo de que se produzcan errores durante la operación de carga. Puede especificar el idioma predeterminado en el contexto de negocio del archivo de configuración de entorno. Para ver un ejemplo que muestra cómo cargar información de SEO en varios idiomas, consulte Ejemplo: Cargar información de SEO de páginas de Commerce Composer en varios idiomas. Cuando siga este 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.

.