Ejemplo: Insertar y sustituir grupos de condiciones de filtros de catálogo

Puede insertar y sustituir grupos de condiciones de filtros de catálogo con el programa de utilidad Carga de datos.

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.

Requisitos previos

Asegúrese de que la tienda existe.
Asegúrese de que los datos de catálogo existen.
Asegúrese de que la selección de grupo de condiciones de filtros de catálogo se ha cargado.

Archivo CSV con datos de grupo de condiciones de filtros de catálogo

CatalogFilterConditionGroup.csv

El archivo contiene datos de grupos de condiciones de filtros de catálogo de ejemplo. Cada columna está delimitada por una coma.

Datos de ejemplo
CatalogFilterName	StoreIdentifier	CatalogIdentifier	CatalogGroupIdentifier	ConditionGroupIdentifier	ConditionRelation
CatalogFilterA	Aurora	Aurora	Sillones	conditionLoungeChairAnd	And
CatalogFilterA	Aurora	Aurora	Sillones	conditionLoungeChairOr	O

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.
CatalogGroupIdentifier: Obligatorio, Serie: El identificador del grupo de catálogo que se va a incluir o excluir de este filtro de catálogo.
ConditionGroupIdentifier: Obligatorio, Serie: El nombre exclusivo de la condición.
ConditionRelation: Obligatorio, Serie: La relación para la condición: O, Y.

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.
eliminar: (Serie) Indica si debe eliminarse el 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> de 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.
Field4: Float(20,5): Campo de ampliación para el valor flotante.
Field5: Número: Campo de ampliación para el valor Número.

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="CatalogGroupSelection/CatalogGroupSelectionIdentifier/ExternalIdentifier/CatalogGroupIdentifier/ExternalIdentifier/GroupIdentifier" value="CatalogGroupIdentifier" />
  <_config:mapping xpath="CatalogGroupSelection/ConditionGroup/ConditionGroupIdentifier/ExternalIdentifier/Identifier" value="ConditionGroupIdentifier" />
	
  <_config:mapping xpath="CatalogGroupSelection/ConditionGroup/conditionRelation" value="ConditionRelation" />
  <_config:mapping xpath="CatalogGroupSelection/ConditionGroup/UserData/UserDataField[0]/Field1" value="Field1" />
  <_config:mapping xpath="CatalogGroupSelection/ConditionGroup/UserData/UserDataField[0]/Field2" value="Field2" />
  <_config:mapping xpath="CatalogGroupSelection/ConditionGroup/UserData/UserDataField[0]/Field3" value="Field3" />
  <_config:mapping xpath="CatalogGroupSelection/ConditionGroup/UserData/UserDataField[0]/Field4" value="Field4" />
  <_config:mapping xpath="CatalogGroupSelection/ConditionGroup/UserData/UserDataField[0]/Field5" value="Field5" />
 
  <_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.CatalogFilterConditionGroupMediator. El correspondiente esquema lógico esCatalogFilter.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.