Ejemplo: Asociaciones de comercialización de entradas de catálogo

Puede utilizar el programa de utilidad de carga de datos para sustituir o eliminar simultáneamente varias asociaciones de comercialización de entradas 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.

Definiciones de columnas CSV y de elementos XML

PartNumber
(Necesario, Serie) Número de pieza exclusivo que se utiliza para identificar la entrada del catálogo de origen en la asociación. Este campo no puede ser nulo. El número de pieza de una entrada de catálogo aparece en el Centro de gestión como valor para la propiedad Code de la entrada de catálogo.
AssociationType
(Necesario, Serie) Tipo de asociación de comercialización que desea utilizar. Los valores posibles son CrossSell, UpSell, Accessory, y Replacement. Este campo no puede ser nulo.
TargetPartNumber
(Necesario, Serie) Número de pieza exclusivo que se utiliza para identificar la entrada del catálogo de destino en la asociación. Este campo no puede ser nulo.
TargetStoreIdentifier
(Serie) Identificador exclusivo de la tienda a la que pertenece la entrada del catálogo de destino. Si no se proporciona el valor de TargetStoreIdentifier en el archivo CSV fuente, se utiliza el valor StoreIdentifier de los datos de contexto.
Secuencia
(Decimal) Orden en el que se visualizan las asociaciones de comercialización.
SemanticSpecifier
(Necesario, serie) Especificador semántico de la asociación de comercialización. Algunos ejemplos de especificadores semánticos son comes_with, none, requires o temp. Este campo no puede ser nulo.
Cantidad
(doble) La cantidad de entradas de catálogo de destino que están asociadas con el origen. Por ejemplo, si la entrada del catálogo de origen es una cámara y la entrada del catálogo de destino es el tipo de batería que utiliza, la cantidad indica el número de baterías necesarias.
eliminar
(Serie) Distintivo que indica si se debe eliminar. Especifique 1 para eliminar la fila.

Otros campos opcionales no incluidos en este ejemplo son:

Field1
(Serie) Campo definido por el usuario disponible para fines de personalización de la asociación de comercialización.
Field2
(Entero) Campo definido por el usuario disponible para fines de personalización de la asociación de comercialización.
Field3
(Decimal) Campo definido por el usuario disponible para fines de personalización de la asociación de comercialización.
Date1
(Indicación de hora) Campo definido por el usuario disponible para fines de personalización de la asociación de comercialización.

Archivo CSV con asociaciones de comercialización de entradas de catálogo

Insertar o sustituir

En este ejemplo, el archivo CSV contiene datos de asociaciones de comercialización de entradas de catálogo de ejemplo. Cada columna está delimitada por una coma. Archivo CSV con datos de asociaciones de comercialización de entradas de catálogo de ejemplo.

Archivo CSV formateado con cabeceras de columna.
PartNumber AssociationType TargetPartNumber TargetStoreIdentifier Secuencia SemanticSpecifier Cantidad
Example-PN-10001 UpSell Example-PN-10004 ExampleTargetB2BStore 1 NONE 23
Example-PN-10002 Accesorio Example-PN-10005 ExampleTargetB2BStore 2 NINGUNO 11
Figura 1. eliminar

En este ejemplo, el archivo CSV contiene datos de asociaciones de comercialización de entradas de catálogo de ejemplo que se eliminarán. Archivo CSV con datos de asociaciones de comercialización de entradas de catálogo de ejemplo.

Archivo CSV formateado con cabeceras de columna.
PartNumber AssociationType TargetPartNumber TargetStoreIdentifier Secuencia SemanticSpecifier Cantidad eliminar
Example-PN-10001 UpSell Example-PN-10004 ExampleTargetB2BStore 1 NONE 23 1
Example-PN-10002 Accesorio Example-PN-10005 ExampleTargetB2BStore 2 NINGUNO 11 1

Correlación de datos

El siguiente fragmento de código del archivo de configuración de asociaciones de entradas de catálogo de ejemplo muestra cómo correlacionar cada valor con una vía de acceso de esquema lógico de objeto de negocio.
<_config:DataMapping>
	<_config:mapping xpath="CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="PartNumber" />
	<_config:mapping xpath="Association/Name" value="AssociationType" />
	<_config:mapping xpath="Association/CatalogEntryReference/CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="TargetPartNumber" />
	<_config:mapping xpath="Association/CatalogEntryReference/CatalogEntryIdentifier/ExternalIdentifier/StoreIdentifier/ExternalIdentifier/NameIdentifier" value="TargetStoreIdentifier" />
	<_config:mapping xpath="Association/displaySequence" value="Sequence" />
	<_config:mapping xpath="Association/semantic" value="SemanticSpecifier" />
	<_config:mapping xpath="Association/quantity" value="Quantity" />
	<_config:mapping xpath="Association/Attributes/field1" value="Field1" />
	<_config:mapping xpath="Association/Attributes/field2" value="Field2" />
	<_config:mapping xpath="Association/Attributes/field3" value="Field3" />
	<_config:mapping xpath="Association/Attributes/date1" value="Date1" />
	<_config:mapping xpath="" value="Delete" deleteValue="1"/>
</_config:DataMapping> 
Si realiza una operación de inserción o sustitución, no especifique la columna "Delete" en el archivo CSV o puede dejar la columna "Delete" vacía.

Mediador de objetos de negocio

El nombre de la clase de mediador es com.ibm.commerce.catalog.dataload.mediator.CatalogEntryAssociationMediator.

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.