HCL Commerce Search Interfaz

La interfaz de búsqueda en el servidor de HCL Commerce Search se compone de un conjunto de parámetros de control relacionados con la búsqueda. Estos parámetros se representan como una representación Java interna denominada objeto SearchCriteria.

Tiempo de ejecución de búsqueda

La programación de tiempo de ejecución de búsqueda consta de servicios REST, un marco de tiempo de ejecución de búsqueda y un conjunto de servicios básicos de HCL Commerce que también proporcionan acceso a la base de datos de HCL Commerce. La infraestructura de búsqueda reutiliza el modelo de programación de búsqueda actual. en lugar de utilizar BOD y realizar la mediación basada en objeto, el modelo de programación REST de búsqueda no se basa en cualquier SDO. Utiliza los datos en bruto y POJO que se devuelven del servidor de búsqueda para realizar la correlación de pareja nombre-valor simple.

Parámetros de control

Perfil de búsqueda (_wcf.search.profile)
Define una colección que agrupa un conjunto de parámetros de tiempo de ejecución de búsqueda como, por ejemplo, nombre de índice de búsqueda, campos de índice de búsqueda, proveedores de expresiones, paginación y clasificación. El perfil también define configuraciones de características de búsqueda como resaltados de texto, facetas y corrección ortográfica. Por consiguiente, es posible controlar la experiencia de búsqueda del escaparate en el nivel de la página utilizando diferentes perfiles de búsqueda.

Para obtener más información, consulte HCL Commerce Search archivo de configuración (wc-search.xml).

Filtros (_wcf.search.(exclude.)term, _wcf.search.category, _wcf.search.(exclude.)facet, _wcf.search.manufacturer, _wcf.search.price.minimum/maximum)
Estos parámetros son criterios de búsqueda que desencadenan la operación de búsqueda que debe llevarse a cabo. Puesto que debe realizarse un seguimiento de estas acciones para ser consultadas en el futuro, estos parámetros no pueden ser fijos ni transportarse para solicitudes de búsqueda futuras. Por ejemplo, realizar una navegación por facetas después de que se devuelve una búsqueda por palabra clave implica una búsqueda por palabra clave. A continuación, la palabra clave se almacena en el contexto de la segunda solicitud de búsqueda de subcategoría.
Filtros (_wcf.search.meta)
Contiene la serie de metadatos de entrada, es decir, el historial de pulsaciones anterior de la secuencia actual de solicitudes. Recuerda solo los parámetros proporcionados por el usuario a través del escaparate. No almacene información de metadatos interna, como por ejemplo la vía de acceso de tienda, que se pueda regenerar a raíz de la siguiente solicitud. Las excepciones son que los únicos parámetros especificados por el usuario que no se recuerdan son palabras clave e ID de categoría. Siempre se pasan para iniciar la lógica de marketing que genera los puntos de e-Marketing adecuados.

Para lograr un comportamiento fijo, se adjunta una serie de metadatos generada por servidor con todas las solicitudes posteriores. Esta serie de metadatos contiene todo el contexto de búsqueda ejecutado anteriormente, como facetas aplicado. Esta serie de metadatos se codifica con UTF8 base64 y por lo tanto es compatible con URL.

Tipo de coincidencia (_wcf.search.type)
El tipo de coincidencia se puede utilizar para definir instrucciones de búsqueda más precisas sobre cómo el motor de búsqueda puede ejecutar la operación de búsqueda con el conjunto de palabras clave.

Por ejemplo, los ejemplos siguientes proporcionan varias combinaciones de uso para dos términos de búsqueda, t1 y t2, respecto a dos campos, f1 y f2:

  • Incluir EXACT+(f1:"t1 t2" f2:"t1 t2")
  • Incluir NONE -(f1:(t1 t2) f2:(t1 t2))
  • Incluir ALL +(f1:(+t1 +t2) f2:(+t1 +t2))
  • Incluir ANY +(f1:(t1 t2) f2:(t1 t2))
  • Incluir EXACT -f1:"t1 t2" -f2:"t1 t2"
  • Incluir ANY o ALL -f1:(t1 t2) -f2:(t1 t2)
Se adjunta la siguiente subexpresión, donde el valor de este parámetro se utiliza para identificar si se debe incluir el código de artículo como parte del ámbito de búsqueda:
  • Excluir SKU -catenttype_id_ntk_cs:ItemBean
  • Solo SKU +catenttype_id_ntk_cs:ItemBean
Los valores posibles para asignar _wcf.search.type son:
  • 0: ANY (excluir SKU)
  • 1: EXACT (excluir SKU)
  • 2: ALL (excluir SKU)
  • 3: NONE (excluir SKU)
  • 10: ANY (incluir SKU)
  • 11: EXACT (incluir SKU)
  • 12: ALL (incluir SKU)
  • 13: NONE (incluir SKU)
  • 100: ANY (solo SKU)
  • 101: EXACT (solo SKU)
  • 102: ALL (solo SKU)
  • 103: NONE (solo SKU)
  • 1000: ANY (incluir productos, variantes, kits, paquetes compuestos, códigos de artículo a nivel de categoría; excluir códigos de artículo a nivel de producto)
  • 1001: EXACT (incluir productos, variantes, kits, paquetes compuestos, códigos de artículo a nivel de categoría; excluir códigos de artículo a nivel de producto)
  • 1002: ALL (incluir productos, variantes, kits, paquetes compuestos, códigos de artículo a nivel de categoría; excluir códigos de artículo a nivel de producto)
  • 1003: NONE (incluir productos, variantes, kits, paquetes compuestos, códigos de artículo a nivel de categoría; excluir códigos de artículo a nivel de producto)
  • 10000: ANY (incluir códigos de artículo a nivel de categoría; excluir productos, kits, paquetes compuestos, códigos de artículo a nivel de producto)
  • 10001: EXACT (incluir códigos de artículo a nivel de categoría; excluir productos, kits, paquetes compuestos, códigos de artículo a nivel de producto)
  • 10002: ALL (incluir códigos de artículo a nivel de categoría; excluir productos, kits, paquetes compuestos, códigos de artículo a nivel de producto)
  • 10003: NONE (incluir códigos de artículo a nivel de categoría; excluir productos, kits, paquetes compuestos, códigos de artículo a nivel de producto)
El valor de este parámetro debe pasarse siempre durante la búsqueda o navegación, ya que la serie de metadatos no lo recuerda.
Expresión de búsqueda opcional personalizada (_wcf.search.expr)
Opcional: Opcional: El llamante puede incluir una expresión nativa de motor de búsqueda en la solicitud utilizando este parámetro de control. Sin embargo, esto suele no recomendarse ya que convierte la expresión de búsqueda en una instrucción específica de motor de búsqueda.
Expresión de búsqueda obligatoria personalizada (_wcf.search.mandatory.expr)
El valor de este parámetro se pasa siempre durante la búsqueda o navegación. solo se utiliza en SolrRESTSearchByCustomExpressionProvider para añadir la expresión a la consulta de búsqueda principal con un operador AND.
Clasificación personalizada (_wcf.search.sort)
Permite al llamante sobrescribir el orden de clasificación de relevancia desde el motor de búsqueda. El valor que se proporciona en este parámetro es un nombre de lógica que se define en el perfil de búsqueda. A continuación, se correlaciona en un nombre de columna de índice físico y un orden de clasificación.
Por ejemplo:

<_config:sort>
  <_config:field name="1" value="mfName_ntk_cs asc" />
  <_config:field name="2" value="name_ntk_cs asc" />
  <_config:field name="3" value="price_* asc" /> 
  <_config:field name="4" value="price_* desc" /> 
</_config:sort>
_wcf.search.category.limitSubCategories
Esta lista separada por comas de números controla la profundidad de las subcategorías y limita el número de artículos que se devuelven en cada nivel de categoría.

El primer número de la lista determina el número máximo de categorías que se deben mostrar bajo la categoría solicitada.

El segundo número de la lista determina el número máximo de categorías que se deben mostrar bajo las categorías de primer nivel.

Un valor de -1 implica que no hay límite.

Expresión de búsqueda personalizada para exclusión (_wcf.search.filter.expr)
El valor de este parámetro se pasa siempre durante la búsqueda o navegación. solo se utiliza en SolrRESTSearchByCustomExpressionProvider.
Valor de tamaño de página (_wcf.search.page.size_)
El valor de este parámetro se utiliza para permitir que el comprador pase el tamaño de cada página en el resultado de búsqueda.
Valor de número de página (_wcf.search.page.number)
El valor de este parámetro se utiliza para permitir que el comprador pase el tamaño inicial en el resultado de búsqueda.
_wcf.search.facet.field.limit
El número máximo de recuentos de restricciones que deben devolverse para todas las facetas.

El formato de este valor de parámetro es facet_field_name:number_of_constraint_counts. Por ejemplo, _wcf.search.facet.field.limit='mfName_ntk_cs:3'.

Utilice un número negativo para solicitar todos los recuentos de restricciones.

_wcf.search.partnumber
El número de pieza de la entrada de catálogo.
_wcf.search.store.physical
El identificador de tienda física que se debe utilizar para recuperar el recuento de inventario.
_wcf.search.internal.store.path
Almacena la vía de acceso de tienda calculada.
_wcf.search.ignoreInventory
Usando este parámetro, se ignorará el filtro de inventario que haya añadido a todas sus búsquedas.

Parámetros de control obligatorios

La siguiente lista describe la búsqueda obligatoria y el contexto de navegación requerido para cada solicitud de búsqueda:
_wcf.search.catalog
El catálogo que se debe utilizar para la solicitud de búsqueda actual.
_wcf.search.currency
La moneda a utilizar para la solicitud de búsqueda actual.
_wcf.search.language
El identificador de idioma que se debe utilizar para la solicitud de búsqueda actual.
_wcf.search.store.online
El identificador de tienda en línea que se debe utilizar para la solicitud de búsqueda actual.

Parámetros de control de autorización de B2B

_wcf.search.contract
Parámetro de control que se utiliza internamente para representar información de autorización de contrato.
_wcf.search.hostcontract
Parámetros de control que se utilizan internamente para representar el identificador de contrato de alojamiento.
_wcf.search.eligible.contract
Los parámetros de control que se utilizan internamente para representar una lista de contratos elegibles que pertenecen al usuario actual.
_wcf.search.current.contract
Los parámetros de control que se utilizan internamente para representar el contrato que se ha establecido en la sesión para el usuario actual.
_wcf.search.internal.entitlement.expression
Los parámetros de control que se utilizan internamente para la expresión de búsqueda de autorización.

Parámetros de control de correlación de servicios REST

_wcf.search.internal.service.resource
Nombre de recurso de servicio de búsqueda para la solicitud actual.
_wcf.search.internal.service.resource.url
URL de recurso de servicio de búsqueda para la solicitud actual.
_wcf.search.internal.response.format
Formato de respuesta de servicio de búsqueda a utilizar para la solicitud actual. Los servicios REST soportan los formatos JSON y XML para los datos de entrada y salida de forma predeterminada. El formato predeterminado es JSON.
_wcf.search.internal.response.template
Puede crear una plantilla de representación (archivo JSP) por recurso en el sistema de archivos que se utiliza para generar la representación para los tipos de soporte específicos, como canales de información Atom y XHTML.
_wcf.search.internal.response.fields
Una lista de campos de retorno para la respuesta de búsqueda.

Parámetros de control de uso interno

_wcf.search.index
Define el nombre de núcleo de la solicitud de búsqueda.
_wcf.search.internal.experiment
El valor de este parámetro se utiliza para representar el experimento de las pruebas de AB. Consta de cuatro identificadores de componente en la siguiente secuencia: zona de marketing, actividad, experimento y elemento de prueba.
_wcf.search.internal.filterquery
Define una lista de varios valores de criterios de consulta de filtro.
_wcf.search.internal.sort
Contiene el valor de este parámetro para llevar a cabo la clasificación de búsquedas anidadas internas.
_wcf.search.internal.boostquery
Contiene el valor de la consulta boost que se utiliza para influir en el grado de relevancia de los resultados. Este parámetro se utiliza con _wcf.search.internal.query. La consulta boost afecta a la puntuación de los elementos que ya coinciden con la consulta en _wcf.search.internal.query. Si un elemento coincidente también coincide con _wcf.search.internal.query, tendrá una puntuación superior o inferior, en función de si la consulta boost incrementa o reduce la puntuación de relevancia.
_wcf.search.internal.mandatory.query
Contiene expresiones de búsqueda parcial que deben utilizarse en la sección de consulta de la expresión de búsqueda. Cada elemento de esta matriz se trata como un término independiente y se le asigna AND conjuntamente para formar la expresión final para el motor de búsqueda. Es decir, todas las expresiones deben coincidir con los documentos en los que se realizan búsquedas. Estas expresiones pueden utilizarse con las expresiones de _wcf.search.internal.optional.query. No todos los valores que se especifican pueden recordarse en la serie de metadatos.
Note: Este parámetro consta de varios valores.
_wcf.search.internal.optional.query
Contiene expresiones de búsqueda parcial que deben utilizarse en la sección de consulta de la expresión de búsqueda. Cada elemento de esta matriz se trata como un término independiente y se le asigna OR conjuntamente para formar la expresión final del motor de búsqueda. Es decir, que al menos una expresión debe coincidir con los documentos en los que se realizan búsquedas. Estas expresiones pueden utilizarse con las expresiones de _wcf.search.internal.mandatory.query. No todos los valores que se especifican pueden recordarse en la serie de metadatos.
Note: Éste es un parámetro de varios valores.
_wcf.search.internal.filterquery
Contiene expresiones para una expresión de consulta filtrada. Cada elemento de esta matriz se trata como un término independiente y se asigna de forma individual como parámetro fq independiente al enviar al motor de búsqueda. Estos valores pueden parecerse a filtros (también se conocen como intersecciones AND) de todos los conjuntos de resultados.
Note: Éste es un parámetro de varios valores.
_wcf.search.intent.term
El valor del parámetro es el término que el usuario tiene la intención de buscar. La diferencia entre _wcf.search.intent.term y _wcf.search.term es que _wcf.search.term se evade con caracteres reservados de Solr.
_wcf.search.originalterm
El valor del parámetro es el término original que inicia la segunda petición de búsqueda con corrección ortográfica, _wcf.search.originalterm no se evade con caracteres reservados de Solr como ocurre con _wcf.search.intent.term.
_wcf.search.source
Se utiliza como concepto para identificar la naturaleza del origen de la petición de búsqueda de palabra clave desde el escaparate.
Los valores aceptables son los siguientes:
Q
Búsqueda rápida.
A
Búsqueda avanzada.
E
Búsqueda en profundidad. Recupera productos de todas las categorías y subcategorías secundarias.
S
Corrección ortográfica.
N
Navegación.
O
Otros.
_wcf.search.internal.synonyms
Se utiliza internamente para la expansión de sinónimos.
_wcf.search.catalogfilter
_wcf.search.contract
Los parámetros de control que se utilizan internamente para representar información de autorización de contrato.
_wcf.search.facet.field
_wcf.search.facet.properties
_wcf.search.facetquery.field
Se utiliza internamente para representar operaciones de faceta.
_wcf.search.internal.workspace.schema
_wcf.search.internal.workspace.indexname
Se utiliza internamente para representar información actual relacionada con el espacio de trabajo.
_wcf.search.internal.edismax.mm
Se utiliza internamente para representar el número mínimo de criterios de búsqueda que deben coincidir.
De forma predeterminada, todas las palabras o frases que se especifican en el parámetro q se tratan como cláusulas optional a menos que están precedidas de los caracteres + o -.
Al trabajar con las cláusulas optional, la opción mm permite la opción de seleccionar el número mínimo de cláusulas que deben coincidir (mm).
El valor predeterminado es 1. Sin embargo, cuando se utiliza el tipo de coincidencia All, el valor predeterminado se establece en 100 %.
_wcf.search.internal.edismax.queryfields
Se utiliza internamente para representar la lista de campos de consulta y sus correspondientes factores de aumento.
_wcf.search.edismax.maxSlop
Se utiliza internamente para representar el desplazamiento de frase máximo en la consulta Dismax de Solr.
Una consulta de frase desplazada especifica un "desplazamiento" máximo o el número de posiciones que las señales necesitan moverse para obtener una coincidencia. Cuanto más juntos aparezcan los dos términos en el documento, más alta será la puntuación.