Ejemplo: Atributos descriptivos de entrada de datos y valores de atributos

Puede insertar, sustituir o eliminar datos de atributos descriptivos y valores de atributos mediante el programa de utilidad de carga de datos. Estos ejemplos utilizan un archivo CSV para mostrar cómo insertar, sustituir o eliminar los datos de atributos descriptivos y valores de atributos.

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 o SKU). 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 exclusivo del catálogo (producto o SKU). 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.
ValueName: (Serie) Nombre de este valor de atributo. Este campo es sensible al idioma.
Valor: (Serie|Entero|Flotante) Valor del atributo.
Image1: (Serie) Vía de acceso de la primera imagen del atributo. Este campo es sensible al idioma. Debe utilizar la barra inclinada '/' en la vía de acceso. No utilice una barra invertida '\'. Por ejemplo, images/G1.jpg.
Image2: (Serie) Vía de acceso de la segunda imagen del atributo. Este campo es sensible al idioma. Debe utilizar la barra inclinada '/' en la vía de acceso. No utilice una barra invertida '\'. Por ejemplo, images/G1.jpg.
eliminar: (Serie) Distintivo que indica si se debe eliminar. Especifique 1 para eliminar la fila.

Otros campos opcionales no incluidos en este ejemplo son:

ValueField1: (Entero) Campo personalizable para este atributo.
ValueField2: (Serie) Campo personalizable para este atributo.
ValueField3: (Serie) Campo personalizable para este atributo.
UnitOfMeasure: (Serie) Unidad de medida de este valor de atributo.
AttachmentID: (Entero) Número de referencia de un adjunto que está asociado con el valor de atributo.

Archivo CSV con datos de atributos descriptivos de entradas de catálogo de ejemplo

Insertar o sustituir

En este ejemplo, el archivo CSV contiene los datos de ejemplo de atributos descriptivos de entrada de catálogo y los datos de valores de atributos: Archivo CSV con datos de atributos descriptivos de entradas de catálogo de ejemplo. El archivo CSV formateado, que se divide en tres secciones, aparece en las tablas siguientes:

Archivo CSV con formato con cabeceras de columna
PartNumber	Tipo	Nombre:	Secuencia	Descripción:
Example-PN-10001	Serie	WashMethod	1	Wash method
Example-PN-10002	Serie	WashMethod	2	Wash method

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

Archivo CSV formateado con cabeceras de columna (continuación)
ValueName	Valor	Image1	Image2
dryCleanOnly	Dry clean only	dry_clean_1/image.jpg	dry_clean_2/image.jpg
handWashable	Hand Washable	handwash_thumb1/image.jpg	handwash_thumb2/image.jpg

eliminar

En este ejemplo, el archivo CSV contiene los datos de ejemplo de atributos descriptivos de entrada de catálogo y valores de atributos que se van a eliminar. Archivo CSV con datos de atributos descriptivos 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	WashMethod	1	Wash method
Example-PN-10002	Serie	WashMethod	2	Wash method

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

Archivo CSV formateado con cabeceras de columna (continuación)
ValueName	Valor	Image1	Image2	eliminar
dryCleanOnly	Dry clean only	dry_clean_1/image.jpg	dry_clean_2/image.jpg	1
handWashable	Hand Washable	handwash_thumb1/image.jpg	handwash_thumb2/image.jpg	1

Correlación de datos

El siguiente fragmento de código del archivo de configuración del cargador de atributos descriptivos 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="Descriptive" 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="CatalogEntryAttributes/Attributes[0]/AllowedValue/identifier" value="Value" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/Value" value="Value" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Image1" value="Image1" valueFrom="InputData"/>
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Image2" value="Image2" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Field1" value="ValueField1" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Field2" value="ValueField2" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/Field3" value="ValueField3" valueFrom="InputData" />
	<_config:mapping xpath="CatalogEntryAttributes/Attributes[0]/AllowedValue/ExtendedValue/AttachmentID" value="AttachmentID" 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.