Ejemplo: Atributos de definición de entradas de catálogo

Puede utilizar el programa de utilidad de carga de datos para insertar, sustituir o eliminar simultáneamente varios atributos de definición para productos. Los atributos de definición solo se aplican a los productos, a las variantes, y a los SKU. Los paquetes y los kits no pueden tener atributos de definición.

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) Identificador de la entrada de catálogo (producto). Este campo es necesario (no puede ser nulo) y debe ser exclusivo. Este campo o CatalogEntryUniqueId es obligatorio. 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.
CatalogEntryUniqueId: (Necesario, BigInt) Número de referencia interno exclusivo del catálogo (producto). Este campo o el valor de PartNumber es obligatorio.
Tipo: (Serie) Tipo de datos del atributo, como serie, entero o flotante. Este campo es necesario y no puede ser nulo.
Nombre:: (Serie) Nombre de este atributo. Este campo es sensible al idioma.
Secuencia: (Doble) Número de secuencia que se utiliza para controlar el orden en el que se muestran los atributos en un producto. Este valor no puede ser nulo. El valor predeterminado es 0.
Descripción:: (Serie) Descripción de este atributo. Este campo es sensible al idioma.
SecondaryDescription: (Serie) Descripción secundaria de este atributo. Este campo es sensible al idioma.
GroupName: (Serie) Nombre del grupo de atributos al que pertenece este atributo.
Field1: (Serie) Campo personalizable para este atributo.
Footnote: (Serie) Datos de atributo adicionales, como una nota al pie.
eliminar: (Serie) Distintivo que indica si se debe eliminar. Especifique 1 para eliminar la fila.

Archivo CSV con datos de atributos de definición de entradas de catálogo de ejemplo

Insertar o sustituir

Este archivo contiene productos de ejemplo con atributos de definición. Dado que las SKU, los paquetes y los kits no pueden tener atributos de definición, estos tipos de entradas de catálogo no se incluyen en el archivo CSV de ejemplo. Archivo CSV con datos de atributos de definición de entradas de catálogo de ejemplo. Debido al gran número de campos del archivo CSV, la tabla se divide en dos secciones:

Archivo CSV con formato con cabeceras de columna
PartNumber	Tipo	Nombre:	Secuencia	Descripción:
Example-PN-10001	Serie	Color	1	The color of the item
Example-PN-10002	Serie	Tamaño	2	The size of the item

Archivo CSV formateado con cabeceras de columna (continuación)
SecondaryDescription	GroupName	Field1	Footnote
	Clothing	A	A
	Clothing	B	B

eliminar

Este archivo contiene atributos de definición de entrada de catálogo de ejemplo que se suprimen: Archivo CSV con datos de atributos de definición de entradas de catálogo de ejemplo.

Archivo CSV con formato con cabeceras de columna
PartNumber	Tipo	Nombre:	Secuencia	Descripción:
Example-PN-10001	Serie	Color	1	The color of the item
Example-PN-10002	Serie	Tamaño	2	The size of the item

Archivo CSV formateado con cabeceras de columna (continuación)
SecondaryDescription	GroupName	Field1	Footnote	eliminar
	Clothing	A	A	1
	Clothing	B	B	1

Correlación de datos

El siguiente fragmento de código del archivo de configuración del cargador de atributos de definición de entradas 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" valueFrom="InputData"/>
	<_config:mapping xpath="CatalogEntryIdentifier/UniqueID" value="CatalogEntryUniqueId" valueFrom="InputData"/>
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AttributeIdentifier/UniqueID" value="AttributeUniqueId" valueFrom="InputData"/>
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AttributeDataType" value="Type" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/Name" value="Name" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/usage" value="Defining" valueFrom="Fixed" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/displaySequence" value="Sequence" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/Description" value="Description" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/SecondaryDescription" value="SecondaryDescription" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/DisplayGroupName" value="GroupName" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/Field1" value="Field1" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/Footnote" value="Footnote" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/ExtendedData/UnitOfMeasure" value="UnitOfMeasure" valueFrom="InputData" />
	<_config:mapping xpath="" value="Delete" valueFrom="InputData" 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.CatalogEntryAttributeMediator.

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.