HCL Commerce Search archivo de configuración (wc-search.xml)

El archivo de configuración de HCL Commerce Search (wc-search.xml) contiene propiedades relacionadas con la configuración de las características de aplicación de HCL Commerce Search. Puede cambiar las propiedades para satisfacer las necesidades de su sitio al crear un archivo wc-search.xml personalizado que contenga solo las propiedades modificadas.

El archivo de configuración de HCL Commerce Search consta de cuatro secciones:

Servidor - Define cómo conectarse al servidor de búsqueda. No debe modificarse.
Nota: Utilice la modalidad incorporada para el servidor de búsqueda. Es decir, no utilice la Configuración avanzada para el servidor de búsqueda, porque utiliza una hebra de contenedor web adicional para realizar búsquedas, lo cual es muy ineficiente.
Índice – Define las propiedades asociadas del índice de búsqueda. No debe modificarse.
Perfiles - Lista conjuntos de parámetros de tiempo de ejecución de búsqueda; nombre de índice de búsqueda, campos de índice de búsqueda, proveedores de expresiones, paginación y ordenación y configuraciones de características de búsqueda (resaltados de texto, facetas y corrección ortográfica). Puede controlar la experiencia de búsqueda de escaparate a nivel de página utilizando diferentes perfiles de búsqueda.

Los archivos de configuración de HCL Commerce Search se almacenan en las ubicaciones siguientes de forma predeterminada:

Archivo de configuración de HCL Commerce Search predeterminado para la aplicación de búsqueda: Search_home/resources/search/runtime/config/com.ibm.commerce.search
El archivo de configuración de HCL Commerce Search ampliado para la aplicación de búsqueda. Para cambiar el valor de una propiedad existente en el archivo de configuración de HCL Commerce Search, debe crear una versión personalizada del archivo en esta ubicación. La versión personalizada del archivo debe contener únicamente las propiedades modificadas: workspace_dir/search-config-ext/src/runtime/config/com.ibm.commerce.search/wc-search.xml.

Propiedades de perfiles de búsqueda

En la tabla siguiente se resumen las propiedades de perfil configurables en el archivo. Para obtener más información sobre la propiedades del perfil de búsqueda, abra el archivo wc-search.xml y vaya a la sección de interés.

wc-search.xml propiedades configurables
Property	Descripción:
Perfil	Un perfil de búsqueda es una unidad de agrupación lógica de diferentes configuraciones e implementaciones que crean la consulta de búsqueda final y formatean la respuesta. Para obtener una lista completa de los perfiles de búsqueda predeterminados, consulte HCL Commerce Search profiles.
Consulta	Declara propiedades que influyen en cómo se ejecuta la expresión de consulta en el servidor de búsqueda en tiempo de ejecución. Los parámetros predeterminados se pueden definir en el archivo wc-component.xml. Para obtener más información, consulte Propiedades de búsqueda en el archivo de configuración de componente (wc-component.xml). Contiene los parámetros siguientes: maxRows Limita el número máximo de resultados de búsqueda por página. El valor predeterminado es 50. maxTimeAllowed Restringe la cantidad máxima de tiempo permitido (en milisegundos) para que se ejecute cualquier consulta. Si la consulta tarda más tiempo de lo especificado, se produce un tiempo de espera y se pueden devolver resultados parciales (o ningún resultado). Si el valor es nulo, el parámetro se elimina de la solicitud. El valor predeterminado es 15000. Proveedores de expresión necesarios. Estos proveedores no se pueden personalizar ni reconfigurar. SearchProfileNameValidator Un validador de expresiones de búsqueda para el nombre de perfil de búsqueda. Este proveedor asegura que se pasa el parámetro de control _wcf.search.profile y su definición se define en el archivo de configuración de búsqueda. SearchIndexNameValidator Este proveedor de expresiones es para validar el nombre del núcleo del índice. También puede determinar el nombre si no se ha especificado efectuando lo siguiente: Comprobando si _wcf.search.index se ha pasado como parte de la expresión. De lo contrario, busque el nombre de núcleo del perfil de búsqueda. De lo contrario, intente derivar el nombre de núcleo utilizando el ID de tienda para determinar el ID de catálogo maestro y el nombre de entorno local. El nombre de índice resultante se añade al objeto SelectionCriteria (_wcf.search.index) para otro proceso descendente. SearchExpressionValidator Este proveedor de expresiones de búsqueda garantiza que la expresión de consulta no esté vacía. Si es así, se genera una condición inclusiva de todo predeterminada `(:)` y la añade al objeto SelectionCriteria (_wcf.search.internal.optional.query). También garantiza que todos los caracteres especiales se escapan correctamente. Proveedores de expresión opcionales: SearchBasedMerchandisingExpressionProvider Un proveedor de expresiones de comercialización basado en búsqueda. Este proveedor llama al componente de marketing para ejecutar las reglas de búsqueda. Las reglas de búsqueda se pueden aplicar a todas las búsquedas o palabras clave de búsqueda específicas. Pueden añadir más restricciones a la solicitud de búsqueda para influir en el orden de los resultados. También pueden añadir nuevas condiciones a la consulta de búsqueda con la intención de añadir nuevos productos a los resultados de búsqueda. Por ejemplo, las reglas de búsqueda pueden abarcar resultados de la búsqueda que sólo contengan productos que estén disponibles. También pueden elevar productos que cumplen un criterio específico (como marca, margen de beneficio o clasificación de cliente) a la parte superior del resultado de búsqueda. Los fragmentos de consulta producidos por reglas de búsqueda se añaden al objeto SelectionCriteria para otros procesos descendentes _wcf.search.internal.filterquery _wcf.search.internal.optional.query _wcf.search.internal.mandatory.query _wcf.search.internal.boostquery _wcf.search.internal.sort _wcf.search.term Nota: Este proveedor se ejecuta antes que SolrSearchByKeywordExpressionProvider para asegurarse de que los términos de búsqueda se pueden sustituir correctamente mediante la acción de marketing Añadir o sustituir criterios de búsqueda. SearchByCategoryExpressionProvider Maneja la búsqueda por categoría y considera el catálogo de ventas en el contexto de negocio actual. La expresión Solr resultante se añade al objeto SelectionCriteria (categoría a_wcf.search.internal.mandatory.query y catálogo a _wcf.search.internal.filterquery) para otros procesos en sentido descendente. SearchByManufacturerExpressionProvider Maneja la búsqueda por solicitudes de nombre de marca. La expresión Solr resultante se añade al objeto SelectionCriteria (_wcf.search.internal.meta) y se codificará en la metaserie más adelante. SearchByPriceExpressionProvider Maneja la búsqueda por solicitud de rango de precios que se genera desde la página Búsqueda avanzada. La expresión Solr resultante se añade al objeto SelectionCriteria (_wcf.search.internal.meta) y se codificará en la metaserie más adelante. SearchByFacetExpressionProvider Maneja la búsqueda por solicitud de faceta. Este proveedor ayuda a convertir una expresión XPath en una expresión específica de Solr. La expresión Solr resultante se añade al objeto SelectionCriteria (_wcf.search.internal.meta) y se codificará en la metaserie más adelante. SearchByStorePathExpressionProvider Genera condiciones para manejar la vía de acceso de tienda. La expresión Solr resultante se añade al objeto SelectionCriteria (_wcf.search.internal.filterquery) para otros procesos en sentido descendente. SearchByPublishedEntryOnlyExpressionProvider Limita los resultados de búsqueda a entradas publicadas. La expresión Solr resultante se añade al objeto SelectionCriteria (_wcf.search.internal.filterquery) para otros procesos en sentido descendente. SearchByCustomExpressionProvider Maneja la búsqueda por expresión personalizada que está almacenada en _wcf.search.expr. Esta expresión personalizada se añade al objeto SelectionCriteria (_wcf.search.internal.optional.query) para otros procesos en sentido descendente. SearchFacetConditionExpressionProvider Genera una lista de facetas relacionadas con atributos y facetas de rango de precios específicos de moneda para la solicitud de búsqueda actual. La expresión Solr resultante se añade al objeto SelectionCriteria (_wcf.search.facet.field) para otros procesos en sentido descendente. SearchTypeExpressionProvider Este proveedor de expresiones de búsqueda maneja el tipo de coincidencia para solicitudes de búsqueda de palabra. Lo siguiente es la pseudológica de cómo el tipo de coincidencia (_wcf.search.type) se puede convertir a un criterio de búsqueda: El tipo de coincidencia toma de forma predeterminada ANY, Excluir código de artículo La expresión Excluir código de artículo se representa como -catenttype_id_ntk_cs:ItemBean. Solo la expresión SKU se representa como - +catenttype_id_ntk_cs:ItemBean. La expresión Incluir código de artículo no necesita cualificarse. La expresión Solr resultante se añade al objeto SelectionCriteria (_wcf.search.internal.filterquery) para otros procesos en sentido descendente. SearchProductSequencingExpressionProvider Ordena las entradas de producto del resultado de búsqueda por clasificación. SearchCategorySequencingExpressionProvider Ordena las categorías por clasificación. SearchTermAssociationExpressionProvider Maneja la expansión de asociación de términos de búsqueda (STA). Este proveedor ayuda a obtener sinónimos y a sustituir el término de búsqueda para captar el resultado final. Los sinónimos captados por el servicio STA se añade al objeto SelectionCriteria para otros procesos en sentido descendente: _wcf.search.internal.synonyms. SearchProductEntitlementExpressionProvider Realiza la autorización de producto. Esta se realiza llamando a ProductEntitlementExpressionHelper para crear expresiones de consulta específicas del motor de búsqueda para contratos que contienen Términos y condiciones CatalogFilter y Términos y condiciones ProductSet. Si una lista de contratos pasa, ProductEntitlementExpressionHelper crea la expresión de búsqueda en dichos contratos, en lugar de captar el contrato del contexto. De lo contrario, si no se pasan contratos como parámetros, esta clase auxiliar capta los contratos elegibles actuales y crea expresiones de búsqueda para ellos. La expresión Solr resultante se añade al objeto SelectionCriteria (_wcf.search.internal.filterquery) para otros procesos en sentido descendente. SearchCategoryEntitlementExpressionProvider Realiza la autorización a nivel de grupo de catálogo desencadenando una búsqueda en el núcleo de entrada de catálogo. A continuación, analiza el recuento de facetas indicado del núcleo de entrada de catálogo y crea una consulta de filtro interna en el núcleo de grupo de catálogo. La expresión Solr resultante se añade al objeto SelectionCriteria (_wcf.search.internal.filterquery) para otros procesos en sentido descendente. SearchByKeywordRelevancyExpressionProvider Maneja la búsqueda por solicitud de palabra clave. SearchInventoryExpressionProvider Maneja las búsquedas para el índice de búsqueda de inventario. SearchByIdentifierExpressionProvider Realiza búsquedas por identificadores utilizando el analizador de consultas dismax. La expresión Solr resultante se añade al objeto SelectionCriteria para otros procesos utilizando el parámetro de control _wcf.search.internal.optional.query. SearchWebContentStoreInfoExpressionProvider Un proveedor de expresiones de búsqueda para crear una condición de búsqueda obligatoria para buscar contenido desestructurado, junto con una vía de acceso de tienda si procede. La expresión Solr resultante se añade de nuevo al objeto SelectionCriteria para otros procesos utilizando el parámetro de control _wcf.search.internal.filterquery. SearchByJoinQueryExpressionProvider Un proveedor de expresiones de búsqueda para unir dos índices y restringir el resultado a una condición específica. La expresión Solr resultante se añade de nuevo al objeto SelectionCriteria para otros procesos en sentido descendente utilizando el parámetro de control _wcf.search.internal.filterquery. Postprocesadores: MainCatalogEntryViewResultQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. La configuración de correlación se define en el archivo wc-component.xml en la sección XPathToCatalogEntryFieldNameMapping. MainCatalogGroupViewResultQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. Llena la parte catalogGroupView de la respuesta. La configuración de correlación se define en el archivo wc-component.xml en la sección XPathToCategoryViewBODResponseFieldNameMapping. MainWebContentViewResultQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. Llena la parte webContentView de la respuesta. La configuración de correlación se define en el archivo wc-component.xml en la sección XPathToWebContentViewBODResponseFieldNameMapping. MainCatalogEntryViewResultQueryPostprocessor Este postprocesador de consulta de búsqueda llena la parte catalogEntryView de la respuesta. SearchCatalogEntryViewPriceQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. Llena la lista de precios en la parte catalogEntryView de la respuesta. La configuración de correlación se define en el archivo wc-component.xml en la sección XPathToPriceBODResponseFieldNameMapping. SearchCatalogEntryViewDescriptionQueryPostprocessor Este postprocesador de consulta de búsqueda se puede utilizar para proporcionar la información de sustitución de descripción de entrada de catálogo y soporte de reserva de idioma. Este postprocesador emite una consulta de base de datos para recuperar la descripción de alteración de entrada de catálogo que incluye las propiedades de nombre de entrada de catálogo, descripción breve, descripción completa, palabra clave, miniatura e imagen de tamaño normal. UtilizaIBM_Get_CatentryDesc_By_LangId_And_CatentryId y la plantilla de consulta IBM_Get_CatentryDescOverride_By_LangId_And_CatentryId_And_GroupId definida en el archivo wc-query-utilities.tpl. SearchCatalogEntryViewSKUQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. Llena la lista de códigos de artículo en la parte catalogEntryView de la respuesta. La configuración de correlación se define en el archivo wc-component.xml en la sección XPathToCatalogEntryViewBODResponseFieldNameMapping. Este postprocesador realiza una subconsulta de búsqueda para recuperar los artículos asociados de entrada de catálogo (códigos de artículo). Utiliza el perfil IBM_findCatalogEntrySKUssearch. SearchCatalogEntryViewAttributesQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. Llena la lista Atributos y la lista de valores de atributos en la parte catalogEntryView de la respuesta. La configuración de correlación se define en el archivo wc-component.xml bajo las secciones XPathToAttributesBODResponseFieldNameMapping y XPathToAttributesValuesBODResponseFieldNameMapping. SearchCatalogEntryViewAttachmentsQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. Llena la lista Adjuntos en la parte catalogEntryView de la respuesta. La configuración de correlación se define en el archivo wc-component.xml en la sección XPathToAttachmentsBODResponseFieldNameMapping. Este postprocesador realiza una subconsulta de búsqueda para recuperar los elementos asociados de entrada de catálogo. Utiliza el perfil de búsqueda IBM_findCatalogEntryAssociatedAssets. SearchCatalogEntryViewComponentsQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. Llena la lista Componentes en la parte catalogEntryView de la respuesta. La configuración de correlación se define en el archivo wc-component.xml en la sección XPathToComponentsBODResponseFieldNameMapping. Este postprocesador realiza una subconsulta de búsqueda para recuperar los componentes asociados de entrada de catálogo. Utiliza el perfil IBM_findCatalogEntryComponentssearch. SearchCatalogEntryViewMerchandisingAssocQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. Llena la merchandisingAssociationslist en la parte catalogEntryView de la respuesta. La configuración de correlación se define en el archivo wc-component.xml en la sección XPathToMerchandisingAssociationsBODResponseFieldNameMapping. Este postprocesador emite una consulta de base de datos para recuperar los identificadores de comercialización asociados a la entrada de catálogo y, a continuación, realiza una subconsulta de búsqueda para recuperar los detalles de comercialización asociados reales. Utiliza el perfil de búsqueda IBM_findCatalogEntryAssociatedMerchandising y la plantilla de consulta IBM_GET_MERCHANDISING_ASSOCIATIONS_BY_CATALOG_ENTRY_ID que se ha definido en el archivo wc-query-utilities.tpl. SearchBrandSuggestionQueryPostprocessor Un postprocesador de consulta de búsqueda para manejar la sugerencia de marca. SearchCategorySuggestionQueryPostprocessor Un postprocesador de consulta de búsqueda para manejar la sugerencia de categoría. SearchPreviewQueryPostprocessor Un postprocesador de consulta de búsqueda para manejar el contexto de vista previa. SearchExperimentQueryPostprocessor Un postprocesador de consulta de búsqueda para manejar metadatos de experimento de regla de búsqueda. SearchFacetQueryPostprocessor Adjunte la respuesta relacionada con la faceta en datos. SearchChildCategoryEntitlementQueryPostprocessor eliminar catgroupId hijo sin autorización de solrDocumentList en la respuesta. SearchCategoryEntitlementQueryPostprocessor eliminar SolrDocument de subcategoría sin autorización de solrDocumentList en la respuesta. SearchEntitlementQueryPostprocessor Poner información de faceta catgroup_id_search en SearchResponse. SearchBreadCrumbTrailQueryPostprocessor Generar la indicación de ruta. SearchSpellCheckSuggestionQueryPostprocessor Volver a formatear los comentarios de corrección ortográfica de Solr en una lista de palabras clave más legibles. SearchCatalogGroupViewUserDataQueryPostprocessor Añadir campos de índice personalizados a la respuesta de búsqueda para el recurso de vista de categoría. SearchRelevancyByProductGroupingPostprocessor Un postprocesador de consulta de búsqueda para manejar las configuraciones de agrupación de resultados. SearchCatalogEntryViewVariantAndSKUQueryPostprocessor Reformatear la respuesta de Solr en un objeto estructurado. Llena la lista de variantes y códigos de artículo en la parte catalogEntryView de la respuesta. La configuración de correlación se define en el archivo wc-component.xml en la sección XPathToCatalogEntryViewBODResponseFieldNameMapping. Este posprocesador realiza una subconsulta de búsqueda para recuperar los artículos asociados de entrada de catálogo (variantes y códigos de artículo). Utiliza el perfil de búsqueda IBM_findCatalogEntrySKUs y IBM_findCatalogEntrySKUsByVariantIds.
Ordenar	La sección de ordenación sirve para definir opciones de ordenación y sus valores correspondientes que se pueden utilizar directamente desde el escaparate. Por ejemplo: `<_config:sort> <_config:field name="1" value="mfName_ntk_cs asc" /> <_config:field name="2" value="name_ntk asc,price_* asc" /> </_config:sort>` Cuando se pasa un valor de 2 a través de un parámetro de control _wcf.search.sort, se añaden los dos parámetros siguientes a la expresión Solr final: `sort=name_ntk+asc,price_USD+asc` Nota: `price_` contiene un operador `` que se sustituye por la moneda del comprador en tiempo de ejecución. En este ejemplo, la moneda del comprador es el dólar de EE.UU.
Resultado	Declara una lista de campos de índice de búsqueda a devolver en el conjunto de resultados de búsqueda. Puede aplicar más filtrado de datos.
Resaltar	Declara una lista de campos de índice de búsqueda que se utilizarán para el resaltado y su comportamiento de resaltado asociado en el tiempo de ejecución.
Facetas	Declara una lista de campos de índice de búsqueda que se utilizarán para facetas y su comportamiento de facetas asociado en el tiempo de ejecución. Contiene los parámetros siguientes: ordenar Determina la clasificación de las restricciones del campo de faceta: count Ordenar las restricciones por recuento (primero el recuento más alto). El valor predeterminado. index Devuelve las restricciones que están ordenadas por orden de índice (lexicográfico por término indexado). Para términos en el rango ASCII, esta lista se clasifica de forma alfabética. minCount Indica los recuentos mínimos para campos de facetas a incluir en la respuesta. El valor predeterminado es 1. limit Indica el número máximo de recuentos de restricciones a devolver para los campos de faceta. Un valor negativo indica ilimitado. El valor predeterminado es 100. Nota: La columna MAX_DISPLAY de la tabla FACET prevalece sobre este límite de forma predeterminada en el escaparate.
Corrección ortográfica	Define el comportamiento de corrección ortográfica durante el tiempo de ejecución. Contiene el parámetro siguiente: limit Indica el número máximo de sugerencias a devolver. El valor predeterminado es 5.
group	Define el comportamiento de agrupación de resultados de búsqueda en tiempo de ejecución. group Especifica si se habilita la agrupación de resultados de búsqueda. El valor predeterminado es false. Puede añadir más parámetros de agrupación utilizando el mismo convenio group.`parameter_name`. Para obtener más información sobre los parámetros de agrupación, consulte la publicación Apache 5.5 Reference Guide. group.limit Especifica el número máximo de resultados de búsqueda por grupo. El valor predeterminado es 100. field El nombre de campo por el que agrupar. Este valor debe definirse como la última entrada de la configuración de grupo.
heroproduct	Define el comportamiento de producto de agrupación de representante en tiempo de ejecución. Esta propiedad se aplica cuando se habilita la agrupación de resultados de búsqueda. overrideFieldName Una lista separada por comas de nombres de campo de Solr. Cuando se especifica, algunas propiedades del elemento más relevante del grupo alteran las propiedades productBean devueltas. Por ejemplo, thumbnail (miniatura) o name (nombre). El valor predeterminado es thumbnail. showGroupPriceRange Cuando se establece en true, el precio de productBean devuelto muestra un rango de precios basándose en los códigos de artículo subyacentes que han generado las búsquedas con resultados. El valor predeterminado es false. QueryMissingGroupOwner Busca propietarios de grupo que faltan en el índice. Se ejecuta en un lote para todos los grupos para el tamaño de página actual. El valor predeterminado es true.
relevancy	joinFilterQuery Indica si se deben utilizar opciones de filtro o impulso. false Habilita el impulso. Productos dentro de la categoría que contiene la consulta de búsqueda del comprador se impulsan, seguidos por otras categorías. Este es el valor predeterminado. true Habilita el filtrado. Los productos dentro de la categoría que contiene la consulta de búsqueda del comprador se devuelven. No se devuelven otros resultados. CatalogGroupSearchFields keyword Indica que en el campo del índice CatalogGroup se busca utilizando la consulta de unión de forma predeterminada. Puede añadir más campos indexados de CatalogGroup en este parámetro. De forma predeterminada, se busca en el campo de palabra clave del índice CatalogGroup para buscar la categoría posible que contiene los productos buscados. Puede añadir más campos indexados de CatalogGroup en este parámetro para aumentar el ámbito de búsqueda. Los campos posibles son: Los campos `name`, `shortDescription`, `longDescription` y `keyword`. Puede sobrescribir los valores de parámetro predeterminados en el archivo wc-search.xml ampliado. `<_config:profile name="IBM_findProductsBySearchTerm" indexName="CatalogEntry"> <_config:join> <_config:param name="joinFilterQuery" value = "true" /> <_config:param name="CatalogGroupSearchFields" value="keyword, name" /> </_config:join> </_config:profile>`