HCL Commerce Version 9.1.7.0 or later

Propiedades de configuración de los componentes

La siguiente tabla resume los tipos de propiedades de configuración de los componentes.

Nombre de propiedad Finalidad de la propiedad
Manejar caracteres especiales Para establecer los patrones de escape, patrones de ignorar, patrones de detención y valores de campo de solicitud. No es necesario que cambie estas propiedades.
Gestión de facetas
maximumFacetFieldsToRequest
El número máximo de campos de faceta que se solicitarán en el FacetHelper. Este número puede configurarse para evitar errores de límite de longitud de URI de Solr.
El valor predeterminado es 200.
displayLeafCategoriesOnly
Mostrar sólo facetas de categoría de hoja de búsqueda de palabras clave. Las categorías padre no se muestran.
categoryFacetLimitForKeywordSearch
Esta configuración define el valor límite para las facetas de categoría cuando un comprador realiza búsquedas de palabra clave.
Para el examen de categoría, utiliza la columna MAX_DISPLAY de la tabla FACET para establecer el valor límite.
HCL Commerce Version 9.1.9.0 or laterFacetPageSize
HCL Commerce Version 9.1.9.0 or laterEl número máximo de facetas que se devolverán en la respuesta. El valor predeterminado es 1000.
TopCategorySortOrder
Puede definir por separado cómo se clasifican los elementos en la ventana de navegación de la izquierda y el menú desplegable superior. Por ejemplo, un cliente puede que quiera ordenar las categorías en el menú superior por secuencia y configurar por separado facetas en la ventana de navegación de la izquierda alfabéticamente. Los valores admitidos son
  1. 0 para ordenar la siguiente secuencia del centro de gestión.
  2. 1 para clasificar de forma alfanumérica, basándose en los nombres de elemento.
El valor predeterminado es 0.
Tiempo de ejecución de búsqueda
ResponseTemplateDefault
Define el comportamiento predeterminado de la transformación de respuesta de REST. Para la compatibilidad con una versión anterior, use 0, de modo que la estructura de datos de respuesta puede ensamblarse cuidadosamente a la estructura de tipo BOD para minimizar el impacto de la migración de escaparate. Los valores admitidos son:
  • -1 no utiliza ninguna transformación y solo indica datos en bruto.
  • 0 utiliza la estructura de nombre como una plantilla.
  • 1 utiliza la estructura de servicio REST como una plantilla.
El valor predeterminado es 0.
DisplayEntryWithNoName
Esta configuración permite que se visualicen entradas de producto sin nombre.
El valor predeterminado es true.
Important: Para ser eficaz, este parámetro debe actualizarse en los archivos de configuración wc-component.xml de ambos EAR de WC y de Search.
Note: Al inhabilitar esta configuración, también se inhabilita el soporte de reserva de idioma.
LimitDeepCategoryFacetValuesToImmediateChildrenOnly
Cuando se utiliza la navegación de categoría expandida, las facetas de categoría visualizan una lista de valores de faceta de todas las categorías hijas inmediatas y no inmediatas. Cuando se establece esta configuración, los valores de faceta de categoría devueltos se limitan a los inmediatos sólo de la categoría seleccionada.
El valor predeterminado es false.
HCL Commerce Version 9.1.10.0 or latermaxTimeAllowed
Le permite establecer el tiempo de espera de consulta de búsqueda de Elasticsearch globalmente en el servicio de consulta a través de un punto final de configuración. Esto elimina la necesidad de declarar maxTimeAllowed en cada perfil. El parámetro todavía se puede establecer a través de perfiles y cuando se declara en un perfil, tendrá una prioridad más alta sobre la declaración global a través del punto final de configuración.
El valor predeterminado es de 15 segundos.
uriPrefix
Una lista de prefijos de URI que se debe omitir, para que la vía de acceso de tienda no se añada a las URL de imagen.
Los siguientes parámetros se utilizan para dar soporte a las características de eliminación de la publicación de categoría detallada y secuenciación de búsqueda detallada. Para obtener más información, consulte Ocultación de categorías y productos utilizando la eliminación de publicación de categoría detallada.
DisplayPublishedOnly
Sólo permite visualizar productos de categorías publicadas en los resultados de búsqueda de palabra clave cuando la eliminación de publicación de categoría detallada está habilitada.
El valor predeterminado es false.
Note:
  • Hay más parámetros que están relacionados con las características de eliminación de publicación de categoría detallada y de secuenciación de búsqueda detallada en el archivo wc-component.xml en el EAR de HCL Commerce. Para obtener más información, consulte Propiedades de búsqueda en el archivo de configuración de componente (wc-component.xml).
  • Los parámetros de eliminación de publicación de categoría detallada se ignoran cuando la característica está inhabilitada (EnableDeepCategoryUnpublish=false en el EAR de HCL Commerce).
Configuraciones de índice de búsqueda de inventario
FilterInventoryByStoreAndFulfillmentCenter
La fórmula para recuperar el recuento de inventario por tienda física utilizando el diseño de indexación de un solo valor.
1: Identificador interno de tienda en línea.
2: Identificador interno de tienda física.
3: Filtro de rango [%s TO %s].
El valor predeterminado es inv_strlocqty_%s_%s:%s.
Note: Esta función se puede utilizar sólo para opciones de valor único en el índice de inventario.
Corrección ortográfica Parámetros configurables en wc-component.json:
SpellCheckAccuracy
La similitud de los términos sugeridos. La similitud de los términos sugeridos debe compararse, al menos, con los tokens originales del texto sugerido. Se puede especificar un valor de entre 0 y 1. El valor predeterminado es 0.3.
SpellCheckPrefixLength
Consulte la descripción de la opción prefix_length en la documentación de Elasticsearch. El valor predeterminado es 2.
SpellCheckSuggestionMode
Consulte la descripción de la opción suggest_mode en la documentación de Elasticsearch. El valor predeterminado es MISSING.
SpellCheckSortBy
Consulte la descripción de la opción sort en la documentación de Elasticsearch. El valor predeterminado es SCORE.
SpellCheckStringDistance
Consulte la descripción de la opción string_distance en la documentación de Elasticsearch. El valor predeterminado es INTERNAL.
SpellCheckMaxEdits
Consulte la descripción de la opción max_edits en la documentación de Elasticsearch. El valor predeterminado es 2.
SpellCheckMaxInspections
Consulte la descripción de la opción max_inspections en la documentación de Elasticsearch. El valor predeterminado es 5.
SpellCheckMaxTermFrequency
Consulte la descripción de la opción max_term_freq en la documentación de Elasticsearch. El valor predeterminado es 0.01.
SpellCheckMinWordLength
Consulte la descripción de la opción min_word_length en la documentación de Elasticsearch. El valor predeterminado es 4.
SpellCheckMinDocFrequency
Consulte la descripción de la opción min_doc_freq en la documentación de Elasticsearch. El valor predeterminado es 0.0.
Parámetros configurables en el perfil de búsqueda:
limit
Especifica el número de sugerencias de corrección ortográfica que se mostrarán en el escaparate.
Note: Para obtener más información sobre el perfil de búsqueda, consulte Configuración del perfil de búsqueda personalizado
Servicio de correlación de valores Servicio de correlación de valores para resolver la configuración de relación entre las claves externas e internas de los objetos de negocio. La finalidad de este servicio es recuperar la correlación de valores entre los valores externos e internos de los objetos de negocio.
SearchControlParameterMapping
Define la relación entre los parámetros de URL REST y su correspondiente nombre interno que se utiliza en el objeto SearchCriteria. Estos parámetros de control en el objeto SearchCriteria se utilizan posteriormente en los proveedores de expresiones para su proceso.
SearchIndexReturnFieldMapping
Define la relación entre el nombre de campo de retorno que se utiliza en el parámetro de URL REST, returnFields, y su correspondiente ​​Campo de índice​ Nombre​ interno en el índice de búsqueda.
XPathToCatalogEntryFieldNameMapping
Define la correlación de un XPath con su correspondiente ​​Campo de índice​ Nombre​ interno utilizado en el índice de búsqueda de CatalogEntry.
XPathToCatalogEntryViewBODResponseFieldNameMapping
Define la correlación de los campos de índice internos con sus correspondientes campos de respuesta externos utilizados en la búsqueda de CatalogEntry.
XPathToCatalogEntryViewResponseFieldNameMapping
Define la correlación del ​​Campo de índice​ Nombre​ de búsqueda con el correspondiente nombre de campo de respuestas de búsqueda.
XPathToPriceBODResponseFieldNameMapping
Define la correlación de los campos de índice internos con los correspondientes campos de respuesta externos para la sección de precios que se utiliza en la búsqueda de CatalogEntry.
XPathToPriceResponseFieldNameMapping
Define la correlación de los campos de índice internos con los correspondientes campos de respuesta externos para la sección de precios que se utiliza en la búsqueda de CatalogEntry.
XPathToAttachmentsBODResponseFieldNameMapping
Define la correlación de los campos de índice internos con sus correspondientes campos de respuesta externos para la sección de adjuntos que se utiliza en la búsqueda de CatalogEntry.
XPathToAttachmentsResponseFieldNameMapping
Define la correlación de los campos de índice internos con sus correspondientes campos de respuesta externos para la sección de adjuntos que se utiliza en la búsqueda de CatalogEntry.
XPathToAttributesBODResponseFieldNameMapping
Define la correlación de campos de índice internos con sus correspondientes campos de respuesta externos para la sección de atributos que se utiliza en la búsqueda de CatalogEntry.
XPathToAttributesResponseFieldNameMapping
Define la correlación de campos de índice internos con sus correspondientes campos de respuesta externos para la sección de atributos que se utiliza en la búsqueda de CatalogEntry.
XPathToAttributesValuesBODResponseFieldNameMapping
Define la correlación de campos de índice internos con sus correspondientes campos de respuesta externos para la sección de atributos que se utiliza en la búsqueda de CatalogEntry.
XPathToAttributesValuesResponseFieldNameMapping
Define la correlación de campos de índice internos con sus correspondientes campos de respuesta externos para la sección de atributos que se utiliza en la búsqueda de CatalogEntry.
XPathToComponentsBODResponseFieldNameMapping
Define la correlación de campos de índice internos con su correspondientes campos de respuesta externos para la sección de componentes que se utiliza en la búsqueda de CatalogEntry.
XPathToComponentsResponseFieldNameMapping
Define la correlación de campos de índice internos con su correspondientes campos de respuesta externos para la sección de componentes que se utiliza en la búsqueda de CatalogEntry.
XPathToMerchandisingAssociationsBODResponseFieldNameMapping
Define la correlación de campos de índice internos con sus correspondientes campos de respuesta externos para la sección de Asociaciones de comercialización que se utiliza.
XPathToMerchandisingAssociationsResponseFieldNameMapping
Define la correlación de campos de índice internos con sus correspondientes campos de respuesta externos para la sección de Asociaciones de comercialización que se utiliza.
XPathToBreadCrumbTrailResponseFieldNameMapping
Define la correlación de campos de índice internos con sus correspondientes campos de respuesta externos encontrados en la sección BreadCrumbTrailEntryView.
XPathToFacetResponseFieldNameMapping
Define la correlación de los campos de índice internos con sus correspondientes campos de respuesta externos encontrados en la sección FacetView.
XPathToCatalogGroupFieldNameMapping
Define la correlación de un XPath con su correspondiente ​​Campo de índice​ Nombre​ interno utilizado en el índice de búsqueda de CatalogGroup. Estas correlaciones las utilizan los proveedores de expresiones.
XPathToCategoryViewResponseFieldNameMapping
Define la correlación del ​​Campo de índice​ Nombre​ de búsqueda con el correspondiente nombre de campo de respuestas de búsqueda.
XPathToCategoryViewBODResponseFieldNameMapping
Define la correlación del ​​Campo de índice​ Nombre​ de búsqueda con el correspondiente nombre de campo de respuestas de búsqueda.
XPathToWebContentViewBODResponseFieldNameMapping
Define la correlación del ​​Campo de índice​ Nombre​ de búsqueda con el correspondiente nombre de campo de respuestas de búsqueda.
WebContentTypeMapping
Define los metadatos internos de contenido web.
STAAssociationType
Define los metadatos internos de asociación de términos de búsqueda.
CatalogEntryUserDataFieldNameMapping
Define la correlación de un ​​Campo de índice​ Nombre​ personalizado que se utiliza en el índice de búsqueda de CatalogEntry con el nombre de campo utilizado en el área UserData en la respuesta REST.
CatalogGroupUserDataFieldNameMapping
Define la correlación de un ​​Campo de índice​ Nombre​ personalizado que se utiliza en el índice de búsqueda CatalogGroup con el nombre de campo utilizado en el área UserData en la respuesta REST.
Sugerencias
SearchBasedKeywordSuggestions
Cuando se establece, las sugerencias de palabra clave devueltas por la API REST de siteContent keywordSuggestionsByTerm se basan en las búsquedas de palabras clave utilizando el componente de consulta de búsqueda. El perfil de búsqueda IBM_findNavigationSuggestion_Keywords se utiliza para crear la consulta. De lo contrario, se utiliza el TermsComponent predeterminado. La sugerencia basada en las consultas de búsqueda puede tener en cuenta diferentes filtros como tienda, catálogo, autorización y tipo de entrada de catálogo. En cambio, las sugerencias por TermsComponent se generan a partir de todos los documentos indexados.
Otras propiedades adicionales que se evalúan cuando se establece en true son SearchBasedKeywordSuggestionsMaxShingleSize y SearchBasedKeywordSuggestionsSortByFrequency.
El valor predeterminado es false.
SearchBasedKeywordSuggestionsMaxShingleSize
Determina el número de señales utilizadas para crear una sola sugerencia. Sólo se evalúa cuando SearchBasedKeywordSuggestions se establece en true. El valor predeterminado es 3.
SearchBasedKeywordSuggestionsSortByFrequency
Determina el orden de clasificación de las sugerencias de palabra clave basadas en búsqueda. Sólo se evalúa cuando SearchBasedKeywordSuggestions se establece en true. El valor predeterminado es true.
Contratos B2B
MultipleContracts
Define la operación entre varios contratos.
Si la operación es AND, la expresión entre varios contratos se acomoda con +.
De lo contrario, se acomodan varias expresiones con un espacio.
El valor predeterminado es una operación OR.
Reglas de búsqueda
CombineFilterRuleWithProductSequencing
Esta configuración define si se debe permitir que las reglas de búsqueda con condiciones de filtrado funcionen con la secuenciación de producto durante la navegación de categoría.
Cuando se establece en true, las reglas de búsqueda de todas las palabras clave que se pueden utilizar para la navegación de categoría y los productos que se devuelven se ordenan según su secuencia definida en esa categoría.
El valor predeterminado es false.
LocalTransactionCache La memoria caché de transacción local mantiene las entradas de memoria caché en memoria durante una transacción de base de datos única.
habilitado
Habilita el almacenamiento en memoria caché de transacciones locales. Especifique false para desactivar la característica.
No desactive el almacenamiento en memoria caché de transacciones local, excepto como parte de la determinación de problemas.
Note: No desactive nunca el almacenamiento en memoria caché de transacciones local sin desactivar también el almacenamiento en memoria caché entre transacciones.
maxSize
El número máximo de entradas de memoria caché que se pueden recordar durante una transacción.
Cada entrada de memoria caché permanece en la memoria hasta que finaliza la transacción actual. Una transacción de larga ejecución que crea demasiadas entradas de memoria caché puede quedarse sin memoria.
Cuando se alcanza el límite especificado, la memoria caché de transacciones deja de crear entradas de memoria caché para el resto de la transacción actual. Este valor impide una condición de memoria agotada.
maxInvalidationldsPerTransaction
El número máximo de operaciones de invalidación de memoria caché que se pueden ejecutar en una sola transacción.
El conocimiento de cada ejecución de operación de invalidación debe retenerse durante la transacción actual. Una transacción de larga ejecución que ejecuta demasiadas operaciones de invalidación puede quedarse sin memoria.
Cuando se alcanza el límite especificado, se borra toda la memoria caché de la transacción y el conocimiento de las operaciones de invalidación individuales se elimina de la memoria. Este valor impide una condición de memoria agotada. El uso de la memoria caché entre transacciones queda suspendido para el resto de la transacción. Todas las entradas de memoria caché se consideran invalidadas durante el resto de la transacción.
Memoria caché de entre transacciones
habilitado
Habilita el almacenamiento en memoria caché de transacciones cruzadas. Especifique false para desactivar la característica.
commandCaching
On fuerza que la memoria caché de transacciones cruzadas utilice el almacenamiento en memoria caché de mandatos en el baseCache DistributedMap predeterminado.
Off evita que la memoria caché de transacciones cruzadas utilice almacenamiento en memoria caché de mandato.
El valor predeterminado utiliza el almacenamiento en memoria caché DistributedMap cuando se encuentra DistributedMap correspondiente utilizando su nombre JNDI y, de lo contrario, utiliza el almacenamiento en memoria caché de mandato en DistributedMap predeterminado.
maxInactivityTime
El número de segundos tras los cuales una entrada de memoria caché inactiva se elimina de la memoria caché debido a la inactividad.
maxTimeToLive
El número de segundos tras los cuales una entrada de memoria caché caduca y se elimina de la memoria caché.
defaultResultSizeThreshold
Cuando el tamaño de la colección de objetos que se almacenan en memoria caché en una entrada de memoria caché excede el valor umbral especificado, los ID de dependencia se generan utilizando nombres de tabla.
Para reducir el número de ID de dependencia generados para la entrada de memoria caché, no se utilizan nombres de columna y valores.
clearUserOnLogoff
Especifique false si los ID de invalidación DC_userid:nnnn no se deben enviar a baseCache cuando el usuario con el ID de usuario cierra la sesión.
clearUserDataCacheOnLogoff
Especifique true si las entradas de memoria caché específicas de un determinado usuario se eliminan de la memoria caché cuando el usuario cierra la sesión.
maxInvalidationldsPerTransaction
El número máximo de operaciones de invalidación de memoria caché de transacciones cruzadas que se pueden ejecutar en una sola transacción.
El conocimiento de cada ejecución de operación de invalidación debe retenerse durante la transacción actual. Una transacción de larga ejecución que ejecuta demasiadas operaciones de invalidación puede quedarse sin memoria.
Cuando se alcanza el límite especificado, no se recuerdan más ID de invalidación para la memoria caché entre transacciones para el resto de la transacción actual.
Cuando la transacción finaliza, la acción especificada por la configuración clearCacheOnMaxInvalidationIdsPerTransaction.
clearCacheOnMaxInvalidationIdsPerTransaction
La acción cuando se supera el número máximo de operaciones de invalidación de memoria caché entre transacciones, que se especifica mediante el elemento maxInvalidationIdsPerTransaction.
Especifique true para borrar toda la memoria caché de transacciones cuando finalice la transacción actual.
Si este elemento se establece en false, las invalidaciones se emiten de forma inmediata y no se recuerdan hasta el final de la transacción actual.
Este valor deja un corto margen de tiempo durante el cual los datos obsoletos pueden almacenarse en la memoria caché.
reduceMemory
Especifique true para reducir la huella de memoria de la memoria caché de transacciones.
reduceInvalidationIds
Especifique true para reducir el número de mensajes de invalidación emitidos cuando los datos en memoria caché cambian en la base de datos.
Los sistemas que tienen muchas JVM de servidor de aplicaciones de HCL Commerce pueden beneficiarse de este valor. No obstante, se puede producir determinado exceso de invalidación. Mida el impacto general en el rendimiento antes de elegir este valor para un sistema de producción.
sizeable
Especifique true para implementar la interfaz com.ibm.websphere.cache.Sizeable para la mayoría de las entradas de memoria caché que utilizan las siguientes memorias caché de objetos de HCL Commerce:
  • services/cache/DM_Cache (Memoria caché de marketing)
  • services/cache/DM_UserCache (Memoria caché de comportamiento de usuario de marketing)
  • dmap/IVCache (Memoria caché de disponibilidad de inventario externo)
  • dmap/PriceCache (Memoria caché de precio externo)
  • services/cache/WC*DistributedMapCache(todas las instancias de memoria caché de objeto de memoria caché de datos)
Si se especifica true también se implementa la interfaz com.ibm.websphere.cache.sizeable para la mayoría de mandatos almacenables en memoria caché utilizados de forma predeterminada por HCL Commerce.
Este valor no implementa la interfaz com.ibm.websphere.cache.Sizeable para la memoria caché de reglas de precios.
searchRulesCacheMode
Especifica la modalidad de memoria caché para los datos de regla de búsqueda. La modalidad es un mapa de bits. Puede utilizar los valores siguientes para esta propiedad:
  • 0: Se inhabilita el almacenamiento en memoria caché para las reglas de búsqueda.
  • 1: Almacenar en memoria caché los términos con reglas de búsqueda.
  • 2: Almacenar en memoria caché el resultado de las reglas de búsqueda.
  • 3: Almacenar en memoria caché los términos con reglas de búsqueda y el resultado de las reglas de búsqueda.
maxTimeToLiveForAutoCacheEntries
Devuelve el número máximo de segundos hasta que una entrada almacenada en caché automáticamente caduca en la memoria caché. Un valor de cero indica que no se debe crear ninguna entrada de memoria caché automática. Un valor negativo indica que no hay ningún límite especial para las entradas de memoria caché automáticas.
Note: Utilice sólo un valor negativo a efectos de depuración.
autoCacheableTableNames
Define una lista de nombres de tabla para la memoria caché automática.
Los conjuntos de resultados de estas tablas de base de datos se almacenan en la memoria caché utilizando JDBCQueryService. Intente minimizar el uso de esta configuración para evitar el exceso de almacenamiento en memoria caché.
notAutoCacheableTableNames
Define una lista de nombres de tabla que no debe utilizarse para la memoria caché automática.
invalidationJobInterval
Especifica la frecuencia (en segundos) con la que la infraestructura de invalidación de memoria caché debe consultar periódicamente la tabla de base de datos CACHEIVL para buscar sucesos de invalidación pendientes.
Este valor, cuando se combina con el parámetro maxSeconds en invalidationJobParameters, se puede utilizar para determinar con qué rapidez se procesan los sucesos de invalidación de memoria caché en el servidor de búsqueda.
La técnica de invalidación predeterminada que se utiliza en el servidor de búsqueda en ocasiones requiere que una solicitud de búsqueda de entrada dedique una parte configurable de su tiempo de proceso a realizar la invalidación de memoria caché. Es decir, cuando hay sucesos de invalidación pendientes en la tabla CACHEIVL. El resultado es que cada instancia de servidor de búsqueda se haga responsable de la invalidación de sus propias instancias de memoria caché local.
Para sincronizar los últimos datos indexados que se almacenan en el servidor de búsqueda, la cantidad esperada de retardo de tiempo para que la memoria caché se invalide puede tardar más de 3 veces que el valor del parámetro invalidationJobInterval, inmediatamente después de que se haya completado la tarea de reindexación de búsqueda. Este retardo puede ser superior cuando el número de sucesos de invalidación pendientes de la tabla CACHEIVL supera el número que se puede procesar en el tiempo permitido por el parámetro maxSeconds.
Cuando se trabaja con fragmentos JSP en memoria caché en el servidor de HCL Commerce, el tiempo de retardo esperado para que el contenido en memoria caché relacionado quede invalidado puede ser tan largo como la duración del rango de tiempo de trabajo de planificador de DynaCacheInvalidation, más el valor del tiempo de retardo de invalidación de memoria caché de servidor de búsqueda.
Note: Si se establece invalidationJobInterval en -1 se indica que el servidor de búsqueda no consulta la tabla CACHEIVL. En su lugar, se utiliza algún otro método de recepción de sucesos de invalidación de memoria caché, como por ejemplo los servicios de réplica de dominio.
invalidationJobParameters
Especifica los parámetros cuando se ejecuta el trabajo de invalidación.
Por ejemplo, localJVMOnly=true&maxSeconds=1&maxSecondsPerTransaction=0&enableRefreshRegistry=false.
RestParameterSetting
addResourceId
Especifique false para eliminar resourceId de la llamada de REST. El valor predeterminado es true.