Ejemplo: Insertar y eliminar selecciones de entrada de catálogo de filtro de catálogo

Puede insertar o eliminar información de entrada de catálogo para un filtro de catálogo. En el archivo CSV, la información necesaria es el nombre de filtro de catálogo, el identificador de almacén, el identificador de catálogo, el tipo de selección (Exclude o Include) y el número de pieza de entrada de catálogo. La entrada de catálogo se puede insertar o eliminar, no se puede sustituir. Por ejemplo, no puede cambiar una entrada de catálogo incluida por excluir.

Este ejemplo utiliza un archivo CSV para mostrar cómo insertar o eliminar los datos. También puede crear y utilizar un archivo con formato XML en lugar de un archivo CSV. 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.

Requisitos previos

Asegúrese de que la tienda existe.
Asegúrese de que los datos de catálogo existen.
Asegúrese de que el filtro de catálogo se ha cargado.

Archivo CSV con datos de selección de entrada de catálogo de filtro de catálogo de ejemplo

Archivo CatalogFilterCatentry.csv

El archivo contiene datos de selección de entrada de catálogo de filtro de catálogo. Cada columna está delimitada por una coma.

Tabla 1. CatalogFilterCatentry
CatalogFilterName	StoreIdentifier	CatalogIdentifier	SelectionType	PartNumber
CatalogFilterA	Aurora	Aurora	Incluir	CAC024_2401
CatalogFilterA	Aurora	Aurora	Incluir	CAC024_2402
CatalogFilterA	Aurora	Aurora	Exclude	CAC024_2403
CatalogFilterA	Aurora	Aurora	Excluir	CAC024_2404

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.
SelectionType: Obligatorio, Serie: El tipo de selección de entrada del catálogo: Incluir, Excluir.
PartNumber: Obligatorio, Serie: El número de pieza de entrada de catálogo para incluir o excluir del filtro de catálogo.
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.

Otros campos opcionales no incluidos en este ejemplo son:

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.

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 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 definida en el fragmento de código de configuración anterior. 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 más arriba 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="ProductSetSelection/selection" value="SelectionType" />
  <_config:mapping xpath="ProductSetSelection/ProductSet/CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="PartNumber" />
  <_config:mapping xpath="" value="Delete"  deleteValue="1"/>
</_config:DataMapping>

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.

Mediador de objetos de negocio

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