Extraer datos de Commerce Composer con el Programa de utilidad de extracción de datos

Puede configurar y ejecutar el Programa de utilidad de extracción de datos desde un programa de utilidad de línea de mandatos para extraer datos de Commerce Composer para una tienda en archivos de salida CSV. Entonces podrá utilizar el Programa de utilidad de carga de datos para cargar los datos extraídos en tiendas de otros entornos, como para realizar pruebas. Si utilizan estos programas de utilidad para copiar datos entre instancias, los usuarios de negocio no necesitarán crear manualmente los mismos elementos en varias instancias.

Antes de empezar

Asegúrese de llevar a cabo las siguientes tareas:

Verifique que la tienda de la que desea extraer datos incluye objetos de Commerce Composer para extraer. Si no hay datos para el objeto en la tienda, los archivos de salida que el programa de utilidad genera no incluyen ningún dato.

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.

Por qué y cuándo se efectúa esta tarea

Cuando está configurando el Programa de utilidad de extracción de datos para extraer datos de Commerce Composer, puede extraer datos para los siguientes tipos de objetos de Commerce Composer:

Diseños
Plantillas de diseño
Widgets
Información descriptiva multilingüe de widgets
Páginas
Información de SEO multilingüe de páginas

Los archivos de configuración de ejemplo se proporcionan para que pueda editarlos y utilizarlos para configurar rápidamente el programa de utilidad. Los archivos de configuración de ejemplo están en el siguiente directorio:

WCDE_installdir\samples\DataExtract\CommerceComposer

Estos archivos de ejemplo configuran el Programa de utilidad de extracción de datos para extraer datos en archivos de salida CSV. Los archivos de salida son compatibles con el Programa de utilidad de carga de datos para utilizarlos como archivos de entrada. Si es necesario, puede editar los otros archivos de configuración de ejemplo para cambiar cómo el programa de utilidad recupera, transforma y genera datos. Para obtener más información sobre los archivos de configuración de ejemplo y los datos que los archivos están configurados para extraer para cada tipo de objeto, consulte Ejemplo: Extraer datos de Commerce Composer.

Notes:

Los archivos de configuración de ejemplo configuran el programa de utilidad para extraer datos para un solo tipo de objeto de Commerce Composer en una sola operación. Para extraer datos para todos los tipos de objetos de Commerce Composer, debe ejecutar el programa de utilidad de forma repetida, una vez para cada tipo de objeto.
Si tiene previsto cargar datos extraíbles para varios tipos de objeto de Commerce Composer en otra instancia, los datos para un tipo de objeto pueden sobrescribir los datos para otro tipo de objeto. Esta sustitución de datos puede provocar que falten algunos tipos de objetos después de cargar los datos para todos los tipos de objetos. Para asegurarse de que todos los datos estén disponibles para la base de datos de destino, extraiga y cargue los datos para un tipo de objeto cada vez en la siguiente secuencia:
1. Diseños
2. Plantillas de diseño
3. Widgets
4. Información descriptiva multilingüe de widgets
5. Páginas
6. Información de SEO multilingüe de páginas
Cuando se utiliza el programa de utilidad con archivos de ejemplo para extraer información en varios idiomas, el programa de utilidad genera 2 archivos de salida. 1 archivo incluye los datos solo en el idioma de la tienda que se ha configurado en el atributo de contexto de negocio del archivo de configuración de entorno. El segundo archivo incluye los datos para el idioma configurado y todos los otros idiomas.
El Programa de utilidad de extracción de datos extrae datos únicamente para una sola tienda en cada operación de extracción. Puede especificar la tienda en el archivo de configuración de entorno.
Si el sitio utiliza un modelo de tienda de sitios ampliados, no puede extraer datos para todas las tiendas de sitios ampliados a la vez. Si desea extraer y cargar objetos de tienda con elementos en tiendas de sitios ampliados, debe cargar por separado los datos en cada tienda de sitio ampliado.
El archivo generado no incluye ninguna columna o valor para los ID exclusivos de objeto. Estos valores son específicos para la tienda o la instancia de la que se extrae el objeto. Durante una operación de extracción, el programa de utilidad puede sustituir algunos valores de claves primarias, como los ID exclusivos con el valor del identificador exclusivo externo correspondiente. Después el programa de utilidad generará el valor de identificador externo en lugar del número de ID exclusivo. Al cargar el archivo CSV en una tienda con el Programa de utilidad de carga de datos , el programa de utilidad resuelve el ID exclusivo para objetos a partir del valor de identificador externo. Puesto que el número de ID exclusivo puede ser distinto entre entornos, una operación de carga puede fallar si incluye valores de ID exclusivos en el archivo de entrada.
Los archivos de configuración de ejemplo configuran los programas de utilidad de carga de datos y de extracción de datos para extraer y cargar todos los datos para un tipo de objeto de Commerce Composer. Si desea cargar datos extraídos específicos para un tipo de objeto, puede configurar el programa de utilidad de carga de datos para cargar únicamente elementos de carga específicos. Utilice el parámetro -DLoadOrder cuando ejecute el Programa de utilidad de carga de datos para identificar el elemento o los elementos de carga específicos que se van a cargar. Si desea cargar varios elementos de carga, incluya la lista de nombres de elementos de carga en una lista separada por comas que se especifica entre caracteres de comillas dobles. Por ejemplo, si desea cargar solamente datos de grupos de restricciones de widgets extraídos, puede extraer todos los datos de plantillas de Commerce Composer y, a continuación, ejecutar el Programa de utilidad de carga de datos para cargar los datos de plantillas con los siguientes parámetros de configuración para cargar la definición de ranuras de mapa esquemático y los datos de registro de widgets: -DLoadOrder="RegisterWidgetDef, WidgetSlot"

Procedimiento

Configure el Programa de utilidad de extracción de datos.
Cuando configure el programa de utilidad, copie los directorios y archivos de configuración de ejemplo en otro directorio local. Edite y utilice su copia de los archivos de configuración de ejemplo. Estos archivos de ejemplo están en el siguiente directorio y subdirectorios:
- utilities_root/samples/DataExtract/CommerceComposer
- WCDE_installdir\samples\DataExtract\CommerceComposer
Hay un archivo de configuración de orden de datos distinto (wc-dataextract-business-object.xml) para cada tipo de objeto de Commerce Composer:
- Para los diseños, utilice el archivo de configuración wc-dataextract-layout.xml.
- Para plantillas de diseño, utilice el archivo de configuración wc-dataextract-template.xml.
- Para los widgets, utilice el archivo de configuración wc-dataextract-widget.xml.
- Para las páginas, utilice el archivo de configuración wc-dataextract-page.xml.
Ejecute el Programa de utilidad de extracción de datos para extraer los datos para el objeto de Commerce Composer para la tienda configurada.
1. Abra un programa de utilidad de línea de mandatos y vaya al directorio adecuado:
  - utilities_root/bin
  - WCDE_installdir\bin
2. Escriba el siguiente mandato para ejecutar el archivo de orden de datos de ejemplo y extraer la información.
  - ./dataextract.sh ../samples/DataExtract/CommerceComposer/wc-dataextract-object.xml
  - dataextract ..\samples\DataExtract\CommerceComposer\wc-dataextract-object.xml
  Cuando el programa de utilidad finaliza el proceso de extracción, el programa de utilidad genera los archivos de salida para el objeto dentro de la ubicación de salida de datos que se ha configurado en el archivo de configuración de orden de extracción de datos.
  Puede configurar el programa de utilidad incluyendo parámetros opcionales en el mandato. Para obtener más información sobre los parámetros disponibles, consulte Programa de utilidad de extracción de datos
Verifique que todos los archivos de salida se han generado satisfactoriamente.
1. Vaya a la ubicación de salida de datos y abra cada uno de los archivos de salida generados para el objeto y revise el contenido del archivo.
  De forma predeterminada, estos archivos se generan en el siguiente directorio y subdirectorios:
  - utilities_root/samples/DataExtract/CommerceComposer/output
  - WCDE_installdir\samples\DataExtract\CommerceComposer\output
  Dentro de cada archivo CSV de salida, la primera fila del archivo incluye las cabeceras de columna. Cada fila posterior incluye los datos para un solo objeto extraído. Las columnas dentro del archivo son las mismas que los archivos que son necesarios para cargar los datos de objeto con el Programa de utilidad de carga de datos .
  Nota: Si ha creado sus propios archivos de configuración, asegúrese de que los archivos de salida están configurados para incluir los nombres de columna sensibles a las mayúsculas y minúsculas correctos y los valores correspondientes. Por ejemplo, LanguageId no puede ser languageId en su archivo de salida. Si el archivo no incluye los nombres de columna sensibles a las mayúsculas y minúsculas correctos, es posible que el Programa de utilidad de carga de datos no realice la carga satisfactoriamente. Para obtener más información sobre los nombres de columna y los datos que pueden incluirse en cada archivo de salida, consulte Definiciones de archivos de entrada de objetos de Commerce Composer.
2. Compare el contenido del archivo con los datos en las tablas de base de datos de origen para verificar que se extraen los datos correctos.

Qué hacer a continuación

Puede utilizar los archivos de salida generados como archivos de entrada con el Programa de utilidad de carga de datos para cargar los datos en otra tienda o instancia de HCL Commerce para crear o sustituir rápidamente objetos de Commerce Composer en las otras tiendas o instancias. Por ejemplo, para configurar varios entornos de prueba que incluyan los mismos datos, como por ejemplo probar la visualización de la nueva funcionalidad de widgets y diseños en el escaparate. También puede cargar los datos para copiar objetos entre tiendas o instancias cuando los usuarios de negocio necesitan incluir estos objetos en páginas de tienda en las instancias o tiendas de destino. Al extraer y cargar objetos de Commerce Composer, los desarrolladores y usuarios de negocio no necesitan volver a crear los objeto con la herramienta Commerce Composer en cada tienda o instancia. Después de cargar los datos extraídos en un nuevo entorno, los objetos estarán disponibles en la herramienta Commerce Composer para la tienda especificada.

Notes:

Al cargar los datos de Commerce Composer extraídos, asegúrese de que los datos se cargan en la secuencia correcta.
Para la información de páginas y widgets que está en varios idiomas, cargue primero la información en el idioma de tienda predeterminado. A continuación, carga los datos en otros 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.
El Programa de utilidad de extracción de datos no extrae ningún elemento que esté asociado con objetos de Commerce Composer, tales como imágenes, contenido de marketing o multimedia. Si carga datos de Commerce Composer extraídos en otra instancia, copie o mueva todos los elementos asociados para los objetos de Commerce Composer en la instancia de destino. Si no copia o mueve los elementos, los objetos de Commerce Composer que se cargan puede que no se visualicen ni funcionen correctamente.

Consejo: Cuando haya finalizado de cargar los datos extraídos, haga una copia de seguridad del archivo antes de ejecutar otra operación de extracción para el mismo tipo de objeto. Puede que necesite el archivo anterior si necesita eliminar o volver a cargar los datos que ha cargado anteriormente. Cuando se ejecuta una extracción para el mismo tipo de objeto, el Programa de utilidad de extracción de datos sobrescribe el contenido del archivo de salida si el nombre de archivo y la ubicación del directorio permanecen sin cambios.

Para obtener ejemplos que muestran cómo cargar datos para cada tipo de objeto de Commerce Composer, consulte Ejemplos de Commerce Composer. Cuando siga estos ejemplos, edite los archivos de configuración de orden de carga para configurar el Programa de utilidad de carga de datos para que cargue los archivos generados por el Programa de utilidad de extracción de datos.