Extracción de datos de promoción 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 los datos de promoción para una tienda en un archivo XML. Entonces podrá utilizar el programa de utilidad de carga de datos para cargar el archivo XML de promoción en tiendas de otros entornos, como por ejemplo para realizar pruebas de la promoción en varios entornos de prueba.

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

Cuando se ejecuta el programa de utilidad de extracción de datos para extraer datos de promoción, el programa de utilidad utiliza el mediador PromotionToDomTransformMediator para recuperar datos de promoción de la base de datos y crear un objeto DOM para las promociones. Después el objeto DOM se pasará al lector de datos, que generará el archivo XML de salida que incluirá los datos extraídos. El formato XML de promociones generado es completamente distinto del XML de tiempo de ejecución de promociones. El formato XML de promociones generado es parecido al XML de creación de promociones. El XML de salida generado difiere del XML de creación en que durante el proceso de extracción, el programa de utilidad de extracción de datos sustituye algunos valores de claves primarias (por ejemplo, para categorías, entradas de catálogo, segmentos de cliente) por el correspondiente valor de identificador exclusivo. El programa de utilidad genera el valor de identificador en lugar del ID exclusivo, dado que el ID exclusivo D puede ser distinto entre entornos. Al cargar el XML en una tienda con el programa de utilidad de carga de datos, el programa de utilidad resuelve el ID exclusivo para las promociones del valor de identificador.

Para utilizar las promociones del programa de utilidad de extracción de datos, se proporcionan archivos de configuración de ejemplo para editarlos y utilizarlos para configurar rápidamente el programa de utilidad. Estos archivos configuran el programa de utilidad para extraer datos para todas las promociones en la tienda configurada.

Nota: No se da soporte a la extracción de datos de promoción de espacios de trabajo.

Procedimiento

Configure el programa de utilidad de extracción de datos.
Cuando configure el programa de utilidad, copie y edite los archivos de configuración de ejemplo para extraer datos de promoción. Estos archivos están en el siguiente directorio y subdirectorios:
- WCDE_installdir\samples\DataExtract\Promotion
Opcional: Cuando configure el programa de utilidad, abra el archivo de configuración de objeto de negocio (wc-extract-xml-promotion.xml) para su edición y configure los valores para extraer datos de promoción.
De forma predeterminada, el programa de utilidad de extracción de datos utiliza el mediador PromotionToDomTransformMediator para extraer y generar la siguiente información para una promoción:
- Las propiedades de identificación y generales para una promoción. Estas propiedades incluyen el nombre de promoción, fecha de inicio, fecha de finalización, prioridad, exclusividad, entre otras. La información se incluye dentro del elemento XML <Base> del archivo de salida generado. Si la promoción que se extrae tiene un código de promoción público, dicho código se incluye en esta sección del archivo de salida. No se incluye información sobre los códigos de promociones exclusivos generados.
  La configuración para extraer esta información se ha definido en el elemento <_config:BusinessObjectMediator> del archivo de configuración de objeto de negocio.
- La descripción de promoción, que se incluye en el elemento XML <Description> en el archivo de salida generado. Se incluye un elemento <Description> distinto para cada idioma definido para la promoción. El programa de utilidad extrae esta información para la tabla de base de datos PX_DESCRIPTION.
  El mediador PromotionToDomTransformMediator incluye la configuración para extraer este tipo de datos. No puede personalizar los datos que se devuelven en este grupo de información.
- Las condiciones de compra y destino de promoción, que se incluyen en el elemento XML <Elements> en el archivo de salida generado. El programa de utilidad extrae esta información de las tablas de base de datos PX_ELEMENT y PX_ELEMENTNVP. Cada par nombre-valor para una promoción de la tabla PX_ELEMENTNVP se incluye como un nombre y valor del elemento XML distinto. Este elemento XML de par nombre-valor está dentro del elemento XML padre adecuado de los datos PX_ELEMENT extraídos.
  El mediador PromotionToDomTransformMediator incluye la configuración para extraer este tipo de datos. No puede personalizar los datos que se devuelven en este grupo de información.
Para obtener la lista completa de propiedades que pueden extraerse para una promoción, consulte Archivo de entrada XML de promociones. El archivo de salida generado para una promoción extraída pueden incluir las mismas propiedades que un archivo de entrada para cargar una promoción con el programa de utilidad de carga de datos.
1. Para extraer más datos o datos personalizados para una promoción, actualice la configuración del elemento <_config:BusinessObjectMediator>.
  Puede personalizar las consultas SQL en el elemento <_config:BusinessObjectMediator> para añadir datos al elemento XML <Base> en el archivo de salida generado. Cada elemento <_config:Query> en la configuración del mediador de objetos de negocio incluye una declaración SQL para recuperar datos. El elemento de consulta también incluye las correlaciones de columnas para saber cómo deben grabarse los datos recuperados en el archivo XML generado. El valor para cada correlación de columnas se utiliza como el nombre del elemento XML que incluye el valor para dicha columna de base de datos en el archivo de salida generado.
2. Para extraer datos solo para promociones específicas, actualice la configuración del elemento <_config:DataReader>.
  Puede personalizar la consulta SQL en la configuración del lector de datos para definir qué promociones debe extraer el programa de utilidad. De forma predeterminada, el archivo de configuración de objeto de negocio de ejemplo se configura para extraer datos para todas las promociones con estado 0 y 1 para la tienda que está configurada en el archivo de configuración de entorno.
3. Configure el formato de los elementos XML en el archivo XML de salida generado. Puede configurar el formato del archivo generado incluyendo las siguientes propiedades en la configuración del elemento <_config:DataWriter>.
  
  rootElemenetName
  
  Especifica el nombre del elemento XML raíz en el archivo generado. El valor puede ser cualquier nombre que desee.
  
  indent
  
  Indica si el XML en el archivo de salida generado se va a formatear. Puede establecer los siguientes valores para este parámetro:
  
  true
  
  El XML en el archivo generado se formatea de modo que cada elemento XML esté en una línea distinta. Esta configuración puede ayudar a mejorar la legibilidad del archivo de salida generado. La propiedad indentAmount indica cuántos espacios se sangra cada elemento del elemento principal.
  
  false
  
  El valor predeterminado. El XML en el archivo generado tiene dos líneas. La primera línea es la cabecera XML y la segunda línea es la serie XML serializada de datos de promoción.
  
  indentAmount
  
  Indica cuántos espacios se sangra cada elemento del elemento padre.
  Por ejemplo, el siguiente fragmento de código incluye todas estas propiedades.
```
<_config:DataWriter className="com.ibm.commerce.foundation.dataload.datawriter.DomXmlWriter">
  <_config:property name="rootElemenetName" value="Promotions" />
  <_config:property name="indent" value="true" />
  <_config:property name="indentAmount" value="2" />
</_config:DataWriter>
```
4. Guarde y cierre el archivo de configuración.
Ejecute el programa de utilidad de extracción de datos para extraer los datos de promoción para la tienda configurada.
Verifique que el archivo XML de salida Promotion.xml se ha generado satisfactoriamente.
1. Vaya a la ubicación de salida de datos y abra el archivo de salida XML generado para revisar el contenido del archivo.
2. Compare el contenido del archivo con los datos de promoción en las tablas de base de datos de origen para verificar que se extraen los datos correctos.

Qué hacer a continuación

Puede utilizar el archivo de salida XML generado como archivo de entrada con el programa de utilidad de carga de datos. Por ejemplo, si los usuarios de negocio crean promociones en un entorno de creación, puede extraer las promociones completada y, a continuación, cargar las promociones en uno o varios entornos de prueba para probar los datos de promoción. Al extraer y cargar estas promociones, no es necesario volver a crear las promociones con el Centro de gestión en cada entorno de prueba.

También puede editar las promociones en el archivo de salida y volver a cargar los datos en la misma tienda para actualizar las promociones de la tienda. Para obtener más información sobre cómo cargar un archivo de entrada XML de promoción con el programa de utilidad de carga de datos, consulte Carga de promociones con el programa de utilidad de carga de datos.