Programa de utilidad de extracción de datos

Para obtener información general sobre el Programa de utilidad de extracción de datos, consulte Visión general del Programa de utilidad de extracción de datos.

Sintaxis del mandato

Valores de parámetros

vía_acceso_completa

Es la ubicación de vía de acceso completa del archivo de configuración de orden para el Programa de utilidad de extracción de datos.

-DXmlValidation

(Booleano) Se utiliza para activar o desactivar la validación de XML. Para comprobar la exactitud, las configuraciones definidas dentro de los archivos XML se validan con los XSD del Programa de utilidad de extracción de datos y del Programa de utilidad de carga de datos . De forma predeterminada, la validación de XML está activada (true). Si desea desactivar la validación, introduzca -DXmlValidation=false.

-DLoadOrder

Especifica el orden en que los datos se extraen de la base de datos. Este parámetro sustituye el elemento LoadOrder en el archivo de configuración de orden. Puede especificar cualquier número de elementos de objeto para extraer los que desee, con cada elemento separado por una coma. Asegúrese de que los valores de parámetro no contengan espacios en blanco. Si hay un espacio en blanco, encierre los parámetros entre comillas dobles. Por ejemplo,

"-DLoadOrder=loadItemName1, loadItemName2"

-DConsoleHandler.level

Se utiliza para alterar temporalmente el nivel de registro de consola que se define en el archivo utilities_root\dataextract\logging.properties. Por ejemplo, introduzca -DConsoleHandler.level=SEVERE para cambiar el nivel de registro cronológico de consola a SEVERE.

-DFileHandler.level

Se utiliza para alterar temporalmente el nivel de registro de archivo que está definido en el archivo utilities_root\dataextract\logging.properties. Por ejemplo, introduzca -DFileHandler.level=WARNING para cambiar el nivel de registro de archivo a WARNING.

-Dpackage_name.level

Donde package_name es el nombre de cualquier paquete. Este parámetro se utiliza para alterar temporalmente el nivel de registro para el paquete especificado. Si el package_name está en blanco (-D.level=level name), el nombre de registro se cambia para todos los paquetes. El level name puede ser: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST o ALL

Para ayudarle a resolver los errores que se pueden producir cuando se ejecuta el Programa de utilidad de extracción de datos, puede alterar los niveles de registro. Por ejemplo, altere los siguientes paquetes del Programa de utilidad de carga de datos que tienen el registro disponible que Programa de utilidad de extracción de datos pueda utilizar:

-Dcom.ibm.commerce.foundation.dataload.businessobjectbuilder.level
-Dcom.ibm.commerce.foundation.dataload.businessobjectmediator.level
-Dcom.ibm.commerce.foundation.dataload.config.level
-Dcom.ibm.commerce.foundation.dataload.datareader.level
-Dcom.ibm.commerce.foundation.dataload.datawriter.level
-Dcom.ibm.commerce.foundation.dataload.idresolve.level
-Dcom.ibm.commerce.foundation.dataload.database.level
-Dcom.ibm.commerce.foundation.dataload.level 

Para obtener más información sobre cómo cambiar el nivel de registro para un paquete, consulte Configuración del registro para entornos de ejecución. Para obtener más información acerca del registro, consulte Servicios de anotación cronológica.

Ejecución del Programa de utilidad de extracción de datos

1. En una línea de mandatos, vaya al directorio WCDE_installdir\bin.
2. 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.
3. Ejecute el siguiente mandato para utilizar Programa de utilidad de extracción de datos para ejecutar el archivo de configuración de orden especificado. El archivo identifica los archivos de configuración de objetos de negocio que definen cómo extraer los datos.
   • ./dataextract.sh ../path_to_order_configuration_file/wc-dataextract.xml
   • dataextract ..\path_to_order_configuration_file\wc-dataextract.xml
   Donde

   path_to_order_configuration_file

   La vía de acceso relativa al archivo de configuración de orden que identifica los archivos de configuración que está utilizando con el Programa de utilidad de extracción de datos.

   wc-dataextract.xml

   El archivo de configuración de orden. Los archivos de ejemplo se proporcionan con HCL Commerce en los siguientes directorios:

   • utilities_root/samples/DataExtract
   • WCDE_installdir\samples\DataExtract

   De forma predeterminada, el archivo de configuración de orden de ejemplo normalmente se llama wc-dataextract.xml o wc-dataextract-object.xml, donde object es el tipo de objeto que se está extrayendo. Estos archivos tienen una estructura parecida a los archivos de configuración de orden que se utilizan para configurar Programa de utilidad de carga de datos , pero incluyen algunas extensiones.

   Como ejemplo, el siguiente mandato ejecuta el Programa de utilidad de extracción de datos para extraer los objetos de promoción:
   • ./dataextract.sh ../samples/DataExtract/Promotion/wc-dataextract.xml
   • dataextract ..\samples\DataExtract\Promotion\wc-dataextract.xml

Solución de problemas

Puede encontrar errores al ejecutar el programa de utilidad por muchas razones. Los errores pueden deberse a configuraciones incorrectas, parámetros de mandatos incorrectos, entre otros. Para ayudarle a resolver los errores que se encuentren, revise el archivo wc-dataextract.log como primer paso para determinar el origen del error. Este archivo puede encontrarse en el siguiente directorio

• utilities_root\logs
• WCDE_installdir\logs

dataextract.sh wc-dataextract.xml -Dcom.ibm.commerce.catalog.dataload.level=FINER