Ejemplo: Atributos del diccionario de atributos

Puede utilizar el programa de utilidad de carga de datos para insertar, sustituir o eliminar varios atributos del diccionario 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

Identificador

(Necesario, Serie) El nombre de referencia exclusivo para identificar el atributo. Este campo o AttributeUniqueId es necesario.

AttributeUniqueId

(Necesario, Entero) Número de referencia exclusivo del atributo. Este campo o Identifier es necesario.

Tipo

(Obligatorio, Serie) El tipo de datos de atributo.

STRING
INTEGER
FLOAT

Este campo no puede ser nulo.

AttributeType

(Serie) El tipo del atributo. El tipo de atributo puede ser AllowedValues o 1 para un atributo con valores permitidos predefinidos; o AssignedValues, 2, o numo para un atributo sin valores permitidos predefinidos.

Idioma

(Entero) El identificador de idioma para campos sensibles al idioma. Por ejemplo: -1 para inglés, -2 para francés.

LanguageId

(Entero) El identificador de idioma para campos específicos del idioma. Por ejemplo:

-1- para inglés
--2 para francés.

La columna Idioma se renombra a LanguageId. Debe especificar un solo identificador de idioma; utilice LanguageId en lugar de Language como el identificador de idioma.

(Entero) ID de idioma para los campos específicos del idioma (Name, ShortDescription, LongDescription, AuxDescription1, AuxDescription2, Thumbnail, FullImage, Published y Keyword). Por ejemplo:

-1 para inglés
-2 para francés.

Nombre:

(Serie) El nombre específico del idioma del atributo.

Descripción:

(Serie) Descripción de este atributo. Este campo depende del idioma.

SecondaryDescription

(Serie) Descripción secundaria de este atributo. Este campo depende del idioma.

GroupName

(Serie) El nombre del grupo de atributos al que pertenece este atributo. La columna GroupName se renombra a AssociatedKeyword. Aunque tanto GroupName como AssociatedKeyword están soportadas y se correlacionan con la misma columna de base de datos, utilice AssociatedKeyword en lugar de GroupName.

AssociatedKeyword

(Serie) Una palabra clave asociada para un atributo.

Field1

(Serie) Campo personalizado para información de atributo.

Footnote

(Serie) Utilice este campo para almacenar datos de atributo auxiliares, como una nota a pie de página.

UnitOfMeasure

(Serie) Utilice este campo para especificar la unidad de medida que se utiliza para el atributo.

Los siguientes campos son opcionales y no se incluyen en el ejemplo:

Secuencia

(Decimal) Número que se utiliza para controlar el orden en que se visualizan los atributos para una entrada de catálogo. Los atributos se visualizan en orden ascendente. El valor predeterminado es 0.

Se puede visualizar

(Booleano) Indica si un atributo se puede visualizar. No hay ninguna lógica de negocio asociada al uso de este campo. Se proporciona de forma predeterminada para que lo amplíe para satisfacer las necesidades individuales de su negocio. Establezca el valor de columna en true para los atributos que se pueden visualizar. Establezca el valor de columna en false o nulo para los atributos que no se pueden visualizar. Cualquier valor distinto de true adopta automáticamente el valor false.

Se puede buscar

(Booleano) Indica si un atributo se indexa y se puede localizar en el escaparate utilizando la búsqueda de HCL Commerce. Establezca el valor de la columna en 'true' para que un atributo pueda buscarse. Establezca el valor de la columna en 'false' o null para los atributos no se puedan buscar. Cualquier valor distinto de 'true' adopta automáticamente el valor predeterminado false.

Comparable

(Booleano) Indica si un atributo se puede comparar. No hay ninguna lógica de negocio asociada al uso de este campo. Se proporciona de forma predeterminada para que lo amplíe para satisfacer las necesidades individuales de su negocio. Establezca el valor de columna en true para los atributos que se pueden comparar. Establezca el valor de columna en false o nulo para los atributos que no se pueden comparar. Cualquier valor distinto de true adopta automáticamente el valor false.

Si la tienda está basada en la tienda de inicio Aurora, el escaparate utiliza este campo. El escaparate utiliza este campo para determinar si se debe incluir un atributo en la página Comparar productos.

Con facetas

(Booleana) Indica si un atributo puede utilizarse para visualizar facetas en la barra lateral izquierda del escaparate para filtrar listados de productos. Las facetas se crean en la barra lateral izquierda del escaparate, lo que permite utilizar filtros para obtener resultados de productos significativos. El escaparate muestra un recuento para cada valor de faceta. Este recuento indica el número de productos que comparten el valor de esa faceta. Establezca el valor de columna en true para los atributos que pueden utilizarse en una navegación por facetas. Establezca el valor de columna en false o nulo para los atributos que no se utilizan en la navegación por facetas.Si se establece un atributo para que se utilice en la navegación por facetas hace que el atributo pueda utilizarse en el destino Criterios y resultados de búsqueda en actividades de marketing y reglas de búsqueda.

Importante: Cuando se ha especificado que un atributo se puede utilizar en la navegación por facetas, también se especifica que se puede buscar en el escaparate. Se crean enlaces para el atributo en todo el índice de búsqueda y base de datos de HCL Commerce. Para obtener fiabilidad y coherencia, estos enlaces que se pueden buscar permanecen intactos aunque se quite la marca del recuadro de selección que hace que un atributo se pueda utilizar en la navegación por facetas. No puede quitar la marca a un atributo que se ha especificado como Se puede buscar. Cuando un atributo se ha seleccionado para su uso en la navegación por facetas, el atributo se establece automáticamente como que se puede buscar en el escaparate. Los usuarios de negocio pueden eliminar el valor Se utiliza en la navegación por facetas, pero no pueden hacer que el atributo deje de poder buscarse. Para que el atributo deje de poder buscarse, debe actualizar manualmente la base de datos de HCL Commerce para eliminar los registros que hacen que el atributo pueda buscarse.

Al cargar datos para establecer o cambiar un atributo de navegación por facetas o eliminar el atributo, la operación de carga puede actualizar las siguientes tablas de base de datos de búsqueda de HCL Commerce además de las tablas de la base de datos del diccionario de atributos. Para actualizar estas tablas de búsqueda, configure la operación de carga para que utilice el mediador de objetos de negocio com.ibm.commerce.catalog.dataload.mediator.AttributeDictionaryAttributeSearchIndexMediator.

FACET
SRCHATTR
SRCHATTRPROP
ATTRDICTSRCHCONF
SRCHPROPRELV

STOREDISPLAY

(Entero) Especifica que este atributo es para utilizarlo como cinta publicitaria en el escaparate.

Comercializable

(Booleano) Indica que el atributo puede utilizarse como atributo de comercialización en la creación de condiciones de búsqueda para que lo utilicen cualquiera de los siguientes objetos:

Actividades de marketing para buscar entradas de catálogo a recomendar a los clientes de zonas de e-Marketing.
Los atributos de comercialización también pueden utilizarse en condiciones de búsqueda dentro de una actividad de marketing para identificar un destino de página actual.
Reglas de búsqueda para buscar entradas de catálogo.
Ventas y categorías basadas en normas para buscar entradas de catálogo que asignar a las categorías.

Sólo los atributos con valores predefinidos se pueden utilizar como atributos de comercialización. Un atributo que se identifica para 'Utilizar en comercialización' está pensado para uso empresarial interno para crear estas reglas y actividades. Si establece un atributo de comercialización de modo que se pueda visualizar, buscar o con facetas cuando se carga información para un atributo, el atributo también puede aparecer en el escaparate. Establezca el valor de columna en true para los atributos de comercialización. Establezca el valor de columna en false o nulo para los atributos que no se van a utilizar en la comercialización. Cualquier valor distinto de true adopta automáticamente el valor false. Al cargar datos para establecer o cambiar un atributo de comercialización o eliminar el atributo, la operación de carga puede actualizar las siguientes tablas de base de datos de búsqueda de HCL Commerce además de las tablas de la base de datos del diccionario de atributos. Configure la operación de carga para que utilice el mediador de objetos de negocio com.ibm.commerce.catalog.dataload.mediator.AttributeDictionaryAttributeSearchIndexMediator.

SRCHATTR
SRCHATTRPROP
ATTRDICTSRCHCONF

AttributeField1

(Entero) Un campo definido por el usuario disponible para fines de personalización.

AttributeField2

(Entero) Un campo definido por el usuario disponible para fines de personalización.

AttributeField3

(Serie) Un campo definido por el usuario disponible para fines de personalización.

Eliminar

(Serie) Un distintivo que indica si se debe eliminar. Para eliminar una fila, especifique 1.

Archivo CSV con datos de atributo del diccionario de atributos de ejemplo

Insertar o sustituir

En este ejemplo, el archivo CSV contiene datos del diccionario de atributos.

eliminar

En este ejemplo, el archivo CSV contiene datos del diccionario de atributos de ejemplo para eliminar.

Correlación de datos

El siguiente fragmento de código del archivo de configuración del cargador de atributos del diccionario de atributos muestra cómo correlacionar cada valor con una vía de acceso del esquema lógico de objetos de negocio.

Nota: El valor del campo DisplayGroupName se cambia de GroupName a AssociatedKeyword. GroupName sigue siendo el valor para DisplayGroupName en versiones anteriores del diccionario de atributos.

<_config:DataMapping>
        <_config:mapping xpath="AttributeIdentifier/ExternalIdentifier/Identifier" value="Identifier"/>
        <_config:mapping xpath="AttributeIdentifier/UniqueId" value="AttributeUniqueId"/>
        <_config:mapping xpath="AttributeDataType" value="Type" />
        <_config:mapping xpath="AttributeType" value="AttributeType" />
        <_config:mapping xpath="displaySequence" value="Sequence" />
        <_config:mapping xpath="displayable" value="Displayable" />
        <_config:mapping xpath="searchable" value="Searchable" />
        <_config:mapping xpath="comparable" value="Comparable" />
        <_config:mapping xpath="ExtendedData/Field1" value="AttributeField1" />
        <_config:mapping xpath="ExtendedData/Field2" value="AttributeField2" />
        <_config:mapping xpath="ExtendedData/Field3" value="AttributeField3" />
        <_config:mapping xpath="AttributeDescription/language" value="Language" />
        <_config:mapping xpath="AttributeDescription/language" value="LanguageId" />
        <_config:mapping xpath="AttributeDescription/Name" value="Name" />
        <_config:mapping xpath="AttributeDescription/Description" value="Description" />
        <_config:mapping xpath="AttributeDescription/ExtendedData/SecondaryDescription" value="SecondaryDescription" />
        <_config:mapping xpath="AttributeDescription/ExtendedData/DisplayGroupName" value="GroupName" />
        <_config:mapping xpath="AttributeDescription/ExtendedData/DisplayGroupName" value="AssociatedKeyword" />
        <_config:mapping xpath="AttributeDescription/ExtendedData/Field1" value="Field1" />
        <_config:mapping xpath="AttributeDescription/ExtendedData/Footnote" value="Footnote" />
        <_config:mapping xpath="AttributeDescription/ExtendedData/UnitOfMeasure" value="UnitOfMeasure" />
        <_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

La infraestructura de carga de datos proporciona un mediador de objetos de negocio para insertar y sustituir entradas de catálogo. El nombre de la clase de mediador es com.ibm.commerce.catalog.dataload.mediator.AttributeDictionaryAttributeMediator.

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.