Ejemplo: Insertar y sustituir filtros de catálogo

Puede insertar o sustituir los filtros de catálogo utilizando el programa de utilidad de carga de datos. Estos ejemplos se utilizan un archivo CSV para demostrar cómo insertar o sustituir los datos de filtro de catálogo.

Este ejemplo utiliza un archivo CSV para mostrar cómo insertar, sustituir o eliminar los datos. También puede crear y utilizar un archivo con formato XML para insertar, sustituir o eliminar los datos. Si decide crear y utilizar un archivo con formato XML, asegúrese de que los elementos XML utilizan los mismos nombres que los nombres de columna CSV.

Nota: Después de insertar o actualizar filtros de catálogo con el programa de utilidad de carga de datos, deberá actualizar la tabla de base de datos EXPRESSION. Para obtener más información, consulte carga de datos.

Requisitos previos

Asegúrese de que la tienda existe.
Asegúrese de que los datos de catálogo existen.

Archivo CSV con datos de ejemplo

CatalogFilter.csv El archivo contiene datos de filtro de catálogo de ejemplo. Cada columna está delimitada por una coma. Este ejemplo carga datos de filtro de catálogo en las tablas CATFILTER y CATFLTDSC.

Datos de filtro de catálogo de ejemplo
CatalogFilterName	StoreIdentifier	CatalogIdentifier	Usage	EnglishDescription
CatalogFilterA	Aurora	Aurora	Buyer	ShortDesc para el filtro A
CatalogFilterB	Aurora	Aurora	Precio	ShortDesc for filter B

Definiciones de columnas CSV y de elementos XML

CatalogFilterName

Obligatorio, Serie: El nombre del filtro de catálogo. Asegúrese de que la combinación de CatalogIdentifier, StoreIdentifier y CatalogFilterName es exclusiva.

StoreIdentifier

Obligatorio, Serie: El identificador de la tienda a la que pertenece el filtro de catálogo.

CatalogIdentifier

Obligatorio, Serie: El identificador del catálogo al que pertenece el filtro de catálogo.

Usage

Opcional, Serie: El uso del filtro del catálogo. Los valores son:

Alojamiento de sitios: Para uso de sitios ampliados.
Buyer: Para uso de contrato.
Precio: Para uso de precio.
Promotion: Para uso de promoción.
Marketing: Para uso de marketing.

EnglishDescription

Opcional, Serie: La descripción del filtro de catálogo en inglés. La descripción también puede añadirse en otros idiomas:

GermanDescription
ItalianDescription
JapaneseDescription
KoreanDescription
PolishDescription
PortugueseDescription
RomanianDescription
RussianDescription
SChineseDescription
SpanishDescription
TChineseDescription

Otros campos opcionales que no están incluidos en el ejemplo:

CatalogFilterId: Opcional, Serie: El número de referencia del catálogo. Si el número de referencia se proporciona en el CSV, se utilizará este. Si se proporciona este campo, no son necesarios CatalogFilterName, CatalogFilterName, CatalogIdentifier.
eliminar: Opcional, Serie: Indica si se debe eliminar este registro. Este campo es efectivo cuando el valor de dataLoadMode es "replace". Si el valor de este campo es deleteValue, se suprime el registro correspondiente. El valor predeterminado para deleteValue es 1, y deleteValue puede configurarse bajo el elemento DataMapping en BusinessObjectConfigFile.
Field1: Opcional, Largo: Campo de ampliación para el valor largo.
Field2: Opcional, Entero: Campo de ampliación para el valor entero.
Field3: Opcional, Serie: Campo de ampliación para el valor de tipo serie, la longitud máxima es 254.

Datos de contexto de negocio

El siguiente fragmento de código del archivo de configuración wc-dataload-env.xml proporciona los datos de contexto de negocio necesarios:

<_config:BusinessContext storeIdentifier="AuroraESite" catalogIdentifier="Extended Sites Catalog Asset Store">
</_config:BusinessContext>

storeIdentifier: Serie: El identificador de la tienda. Este parámetro se utiliza cuando no se proporciona storeIdentifier en el archivo CSV. Si se proporciona storeIdentifier en el archivo CSV, éste se utiliza. storeIdentifier se utiliza para recuperar los valores de storeID y ownerID.
catalogIdentifier: Serie: El identificador de catálogo. Este parámetro se utiliza cuando no se proporciona el identificador de catálogo en el archivo CSV. Si se proporciona catalogIdentifier en el archivo CSV, éste se utiliza.

Correlación de datos

El siguiente fragmento de código del archivo de configuración de ejemplo muestra cómo correlacionar cada columna de datos del archivo CSV de origen con un valor.

<_config:DataReader 
     className="com.ibm.commerce.foundation.dataload.datareader.CSVReader" 
     firstLineIsHeader="true" 
     useHeaderAsColumnName="true" />

El siguiente fragmento de código del archivo de configuración de ejemplo demuestra cómo crear un objeto de negocio de componente que se base en las propiedades de configuración y en los datos de entrada que se especifican.

<_config:BusinessObjectBuilder className="com.ibm.commerce.foundation.dataload.businessobjectbuilder.BaseBusinessObjectBuilder" 
    	packageName="com.ibm.commerce.catalog.facade.datatypes.CatalogPackage" dataObjectType="CatalogFilterType" >

El siguiente fragmento de código del archivo de configuración de ejemplo muestra cómo correlacionar cada columna de datos del archivo CSV con una vía de acceso de esquema lógico de objeto de negocio. El atributo 'value' representa el nombre de la columna del archivo CSV, que se define en el fragmento de código de configuración en el ejemplo de datos de columnas de correlaciones. Cada columna del archivo CSV debe tener una correlación con la vía de acceso de esquema lógico. Si los campos opcionales especificados en el ejemplo de datos de columnas de correlaciones están presentes en el archivo CSV, debe añadirse una correlación para los mismos. La vía de acceso del esquema lógico de correlación se especifica en la siguiente tabla.

<_config:DataMapping>
  <_config:mapping xpath="CatalogFilterIdentifier/UniqueID" value="CatalogFilterId" />      
  <_config:mapping xpath="CatalogFilterIdentifier/ExternalIdentifier/Identifier" value="CatalogFilterName" />
  <_config:mapping xpath="CatalogFilterIdentifier/ExternalIdentifier/StoreIdentifier/ExternalIdentifier/NameIdentifier" value="StoreIdentifier" />
  <_config:mapping xpath="CatalogFilterIdentifier/ExternalIdentifier/CatalogIdentifier/ExternalIdentifier/Identifier" value="CatalogIdentifier" />
  <_config:mapping xpath="usage" value="Usage" />
  <_config:mapping xpath="Description[0]/language" value="-1" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[0]/value" value="EnglishDescription" />
  <_config:mapping xpath="Description[1]/language" value="-2" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[1]/value" value="FrenchDescription" />
  <_config:mapping xpath="Description[2]/language" value="-3" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[2]/value" value="GermanDescription" />
  <_config:mapping xpath="Description[3]/language" value="-4" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[3]/value" value="ItalianDescription" />
  <_config:mapping xpath="Description[4]/language" value="-5" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[4]/value" value="SpanishDescription" />
  <_config:mapping xpath="Description[5]/language" value="-6" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[5]/value" value="PortugueseDescription" />
  <_config:mapping xpath="Description[6]/language" value="-7" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[6]/value" value="SChineseDescription" />
  <_config:mapping xpath="Description[7]/language" value="-8" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[7]/value" value="TChineseDescription" />
  <_config:mapping xpath="Description[8]/language" value="-9" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[8]/value" value="KoreanDescription" />
  <_config:mapping xpath="Description[9]/language" value="-10" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[9]/value" value="JapaneseDescription" />
  <_config:mapping xpath="Description[10]/language" value="-20" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[10]/value" value="RussianDescription" />
  <_config:mapping xpath="Description[11]/language" value="-21" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[11]/value" value="RomanianDescription" />
  <_config:mapping xpath="Description[12]/language" value="-22" valueFrom="Fixed"/>
  <_config:mapping xpath="Description[12]/value" value="PolishDescription" />
  <_config:mapping xpath="UserData/UserDataField[0]/Field1" value="Field1" />
  <_config:mapping xpath="UserData/UserDataField[0]/Field2" value="Field2" />
  <_config:mapping xpath="UserData/UserDataField[0]/Field3" value="Field3" />
  <_config:mapping xpath="" value="Delete"  deleteValue="1"/>
</_config:DataMapping>

Mediador de objetos de negocio

El nombre de la clase de mediador es com.ibm.commerce.catalogfilter.dataload.mediator.CatalogFilterMediator. El correspondiente esquema lógico es CatalogFilter.xsd.

Nota: Cuando utiliza un mediador que se proporciona con HCL Commerce con el programa de utilidad de carga de datos, el programa de utilidad de carga de datos da por supuesto que está cargando datos para todas las columnas para un objeto de negocio. Si desea actualizar los datos solamente en columnas específicas, configure una lista de exclusión de columnas para el proceso de carga. Una lista de exclusión de columnas hace que el programa de utilidad de carga de datos ignore columnas concretas durante la operación de carga. Si no utiliza una lista de exclusión de columnas, el programa de utilidad actualiza todas las columnas de la fila de una fila de tabla de base de datos cuando el programa de utiliza actualiza la fila. Si el valor se establece en el archivo de entrada, el programa de utilidad puede sustituir el valor de columna existente por un valor predeterminado o establecer el valor en nulo. Para obtener más información, consulte Configuración de una lista de exclusión de columnas.