Ejemplo: Sustitución de descripción de entrada de catálogo

Puede utilizar el programa de utilidad de carga de datos o la función de subida de catálogo para crear, sustituir o eliminar sustituciones de descripciones de entradas de catálogo para la tienda de sitio ampliado. Las sustituciones de descripciones de entradas de catálogo proporciona la capacidad de sustituir descripciones de entradas de catálogo que se heredan de la tienda con elementos. Si se sustituyen las descripciones de entrada de catálogo heredadas, pueden cargarse descripciones de entrada de catálogo específicas de la tienda para visualizarlas en el escaparate.

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.

Después de cargar los datos de sustitución de descripciones, puede verificar si los datos se han cargado en el Management Center y en el escaparate. En la herramienta Catálogos del Management Center, abra la vista de propiedades para la entrada de catálogo para verificar la información de sustitución. Además puede cambiar la información de sustitución en la vista de propiedades. Para verificar los datos en el escaparate, puede iniciar la vista previa de la tienda en el Management Center. Para obtener más información sobre el uso del Management Center para cambiar y tener una vista previa de las sustituciones de descripciones, consulte Añadir sustituciones de descripciones de entrada de catálogo.

Definiciones de columnas CSV y de elementos XML

PartNumber: (Necesario, serie) Identificador de la entrada de catálogo. El campo PartNumber es necesario (no puede ser NULL) y debe ser exclusivo. El número de pieza de una entrada de catálogo aparece en el Management Center como el valor de la propiedad Code de la entrada de catálogo.
LanguageId: (Serie) ID de idioma para los campos sensibles al idioma (Name, ShortDescription, LongDescription, Thumbnail, FullImage, Published y Keyword). Por ejemplo: -1 – Inglés, -2 – Francés
Nombre:: (Necesario, serie) Nombre de visualización de esta entrada de catálogo. El campo name es sensible al idioma.
ShortDescription: (Serie) Descripción breve específica del idioma de esta entrada de catálogo.
LongDescription: (Serie) Descripción larga específica del idioma de esta entrada de catálogo.
Imagen reducida: (Serie) La vía de acceso de la imagen en miniatura específica del idioma de esta entrada de catálogo. Por ejemplo images/thumbnails/G1preview.jpg.
AuxDescription1: (Serie) Descripción adicional específica del idioma de esta entrada de catálogo.
FullImage: (Cadena) La vía de acceso específica del lenguaje para la imagen completa de esta entrada de catálogo. Por ejemplo, images/G1.jpg. La vía de acceso puede ser una vía de acceso completa o una vía de acceso relativa desde el directorio de la tienda.
AuxDescription2: (Serie) Descripción adicional específica del idioma de esta entrada de catálogo.
Publicada: (Entero) Indica si esta entrada de catálogo debe visualizarse. : 0 = la entrada de catálogo no se debe visualizar, 1 = la entrada de catálogo debe visualizarse.
De forma predeterminada, no puede sustituir el valor de la tienda con elementos para la propiedad Publicado. La propiedad se muestra en el Management Center como Mostrar a los clientes. Para sustituir el valor de la tienda con elementos para esta propiedad, haga que el personal de tecnología de información añada soporte para sustituir esta propiedad a través de la configuración. Para obtener más información sobre esta opción de configuración, consulte Habilitar sustitución de publicación.
Nota: Si añade soporte para sustituir esta propiedad, el valor de sustitución para esta propiedad podría no funcionar con todas las funciones de búsqueda del escaparate. De forma predeterminada, el índice de búsqueda de HCL Commerce incluye todas las entradas de catálogo publicadas y no publicadas. Este índice se basa en el identificador de catálogo y es compartido por todas las tiendas que comparten el catálogo. Si sustituye esta propiedad para cualquier entrada de catálogo en un catálogo, no puede personalizar el índice de búsqueda compartido e incluir solo las entradas de catálogo Published para ese catálogo.
Palabra clave: (Serie) Palabra clave específica del idioma que se utiliza para la búsqueda. Si está utilizando un editor de texto sin formato y desea incluir varias palabras clave, que están separadas por comas, incluya la serie entera entre comillas dobles. Por ejemplo, "keyword 1, keyword 2, keyword3". Si está utilizando un editor de hojas de cálculo, no es necesario incluir la serie entera entre comillas dobles.
Field 1: (Entero) Campo personalizado para los datos de entrada de catálogo.
Campo 2: (Serie) Campo personalizado para los datos de entrada de catálogo.
Campo 3: (Serie) Campo personalizado para los datos de entrada de catálogo.
Eliminar: (Serie) Un distintivo que indica si se debe eliminar. Para eliminar una fila, especifique 1.

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

Replace

En este ejemplo, el origen de datos es un archivo CSV. El archivo contiene descripciones de entradas de catálogo de ejemplo. En el ejemplo no se muestran todos los campos disponibles.Archivo CSV con datos de sustitución de descripciones de entradas de catálogo de ejemplo.

Archivo CSV con formato con cabeceras de columna
PartNumber	LanguageId	Nombre:	ShortDescription	LongDescription
AuroraWMDRS-11	`-1`	Vestido veraniego de flores blancas	Celebre la vida con este vestido veraniego de flores blancas
AuroraWMDRS-6	`-1`	Vestido de fiesta sin tirantes,	Vestido de fiesta rojo de Luigi Valenti con rosas rojas y borlas en el dobladillo

Archivo CSV formateado con cabeceras de columna (continuación)
Imagen reducida	FullImage
images/catalog/apparel/women/womens_dresses_160x160/WD_031_a_red.jpg	images/catalog/apparel/women/womens_dresses_1000x1000/WD_031_a_red.jpg
images/catalog/apparel/women/womens_dresses_160x160/WD_006_a_red.jpg	images/catalog/apparel/women/womens_dresses_1000x1000/WD_006_a_red.jpg

Eliminar

En este ejemplo, el archivo CSV contiene descripciones de sustitución de entradas de catálogo que se deben eliminar. En el ejemplo solo se muestran los campos necesarios. Archivo CSV con datos de supresión de sustitución de descripciones de entradas de catálogo de ejemplo.

Archivo CSV con formato con cabeceras de columna
PartNumber	Language_ID	eliminar
Example-PN-10001	`-1`	1
Example-PN-10002	`-1`	1

Correlación de datos

El siguiente fragmento de código del archivo de configuración del cargador de sustituciones de descripciones 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/UniqueID" value="CatalogEntryUniqueId" />      
	<_config:mapping xpath="CatalogEntryIdentifier/ExternalIdentifier/PartNumber" value="PartNumber" />
	<_config:mapping xpath="Description[0]/language" value="LanguageId" />        
	<_config:mapping xpath="Description[0]/Override[0]/Name" value="Name"  />
	<_config:mapping xpath="Description[0]/Override[0]/ShortDescription" value="ShortDescription"   />
	<_config:mapping xpath="Description[0]/Override[0]/LongDescription" value="LongDescription"   />
	<_config:mapping xpath="Description[0]/Override[0]/Thumbnail" value="Thumbnail"   />
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/auxDescription1" value="AuxDescription1"   />
	<_config:mapping xpath="Description[0]/Override[0]/FullImage" value="FullImage"   />       
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/auxDescription2" value="AuxDescription2"   /> 
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/published" value="Published"   />
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/field1" value="Field1"   />
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/field2" value="Field2"   />
	<_config:mapping xpath="Description[0]/Override[0]/Attributes/field3" value="Field3"   />        
	<_config:mapping xpath="Description[0]/Override[0]/Keyword" value="Keyword"  />
	<_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.CatalogEntryDescriptionOverrideMediator.

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.