Ejemplo: Insertar y sustituir selecciones de grupos de catálogo de filtro de catálogo

Puede insertar o sustituir las selecciones de grupos de catálogo de filtros de catálogo con el programa de utilidad de carga de datos. Estos ejemplos utilizan un archivo CSV para mostrar cómo insertar o sustituir los datos de selección de grupos de catálogo de filtros 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.

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 grupo de catálogo de filtro de catálogo de ejemplo

CatalogFilterCategory.csv

Datos de ejemplo
CatalogFilterName	StoreIdentifier	CatalogIdentifier	SelectionType	CatalogGroupIdentifier	ConditionGroupRelation
CatalogFilterA	Aurora	Aurora	Excluir	Sillones	O
CatalogFilterA	Aurora	Aurora	Incluir	Sillas de oficina	And

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.
CatalogGroupIdentifier: Obligatorio, Serie: El identificador del grupo de catálogo que se va a incluir o excluir de este filtro de catálogo.
ConditionGroupRelation: Opcional, Serie: Este campo está reservado y puede utilizarse para ampliar la lógica de filtro de catálogo.

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: 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.
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/conditionGroupRelation" value="ConditionGroupRelation" />
    <_config:mapping xpath="CatalogGroupSelection/selection" value="SelectionType" />
    <_config:mapping xpath="CatalogGroupSelection/UserData/UserDataField[0]/Field1" value="Field1" />
        <_config:mapping xpath="CatalogGroupSelection/UserData/UserDataField[0]/Field2" value="Field2" />
        <_config:mapping xpath="CatalogGroupSelection/UserData/UserDataField[0]/Field3" value="Field3" />
        <_config:mapping xpath="CatalogGroupSelection/UserData/UserDataField[0]/Field4" value="Field4" />
        <_config:mapping xpath="CatalogGroupSelection/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.CatalogFilterCategorySelectionMediator. 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.