Ejemplo: Kits y paquetes

Utilice el programa de utilidad de carga de datos para insertar, sustituir o eliminar simultáneamente varios kits y paquetes. Los productos, paquetes compuestos y kits no pueden formar parte de componentes de kit. Solo se incluyen como parte de los componentes de kit las SKU. En el ejemplo que se muestra a continuación se suprimen los componentes de varios kits y paquetes. El kit y el paquete no se suprimen.

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
Se necesita: (Serie) El número de pieza exclusivo de este paquete o kit. Este campo es necesario (no puede ser nulo) y debe ser exclusivo. 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.
Secuencia
(Doble) Número opcional que se utiliza para controlar el orden en el que aparecen las entradas de catálogo hijo bajo el kit o paquete padre.
ChildPartNumber
(Serie) Identificador de entrada de catálogo de la entrada de catálogo hijo del paquete o kit.
ChildStoreIdentifier
(Serie) Identificador de la tienda a la que pertenece la entrada de catálogo hijo.
Tipo
Opcional: (Serie) Tipo de relación.
  • PackageComponent
  • BundleComponent
  • DynamicKitComponent
Nota: Este campo es opcional, no obstante, es recomendable proporcionar este campo en el archivo CSV para optimizar el rendimiento de la carga de datos. Si no se especifica este campo, el programa de utilidad de carga de datos recupera el tipo de entrada de catálogo de la base de datos. En función del tipo de entrada de catálogo, se crea el tipo de relación correspondiente.
Cantidad
(Doble) Cantidad de entradas de catálogo que están asociadas con el kit o paquete.
eliminar
(Serie) Distintivo que indica si se debe eliminar. Especifique 1 para eliminar la fila.

Otros campos opcionales no incluidos en este ejemplo son:

StoreIdentifier
(Serie) Identificador de la tienda a la que pertenece el paquete o kit.
ParentToChildCatEntryRelField1
(Serie) Campo definido por el usuario disponible para personalización de la relación entre el producto padre y el código de artículo hijo.
ParentToChildCatEntryRelField2
(Entero) Campo definido por el usuario disponible para personalización de la relación entre el producto padre y el SKU hijo.
ParentToChildCatEntryRelField3
(Doble) Campo definido por el usuario disponible para personalización de la relación entre el producto padre y el código de artículo hijo.

Archivo CSV con datos de kit y paquete de ejemplo

Insertar o sustituir

En este ejemplo, el archivo CSV contiene los datos de kit y paquete. Archivo CSV con datos de kit y paquete de ejemplo.

Archivo CSV con formato con cabeceras de columna
PartNumber Secuencia ChildPartNumber ChildStoreIdentifier Tipo Cantidad
230092 1 430092 1001 BundleComponent 2
230093 2 430093 2001 DynamicKitComponent 7

eliminar

En este ejemplo, el archivo CSV contiene los datos de kit y paquete que se suprimen. Cada columna está delimitada por una coma. Archivo CSV con datos de kit y paquete de ejemplo.

Archivo CSV con formato con cabeceras de columna
PartNumber Secuencia ChildPartNumber ChildStoreIdentifier Tipo Cantidad eliminar
230092 1 430092 1001 BundleComponent 2 1
230093 2 430093 2001 DynamicKitComponent 7 1

Correlación de datos

El siguiente fragmento de código del archivo de configuración del cargador de kits y paquetes de entrada de catálogo muestra cómo correlacionar cada valor con una vía de acceso del esquema lógico de objetos de negocio.
<_config:DataMapping>
	<_config:mapping xpath="CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="PartNumber" />
	<_config:mapping xpath="KitComponent/displaySequence" value="Sequence" />
	<_config:mapping xpath="KitComponent/CatalogEntryReference/CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="ChildPartNumber" />
	<_config:mapping xpath="KitComponent/CatalogEntryReference/CatalogEntryIdentifier/ExternalIdentifier/StoreIdentifier/ExternalIdentifier/NameIdentifier" value="ChildStoreIdentifier" />
	<_config:mapping xpath="KitComponent/kitComponentCodeType" value="Type" />
	<_config:mapping xpath="KitComponent/quantity" value="Quantity" />
	<_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.CatalogEntryKitComponentMediator.

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.