Migración de personalizaciones del servicio de consulta

Si ha revisado los cambios recientes de la versión realizados en el servicio de consulta tal como se describe en Mantener actualizados los servicios de Ingest y de consulta, puede continuar migrando las personalizaciones. Utilice la guía siguiente.

Perfiles de búsqueda

Los perfiles de búsqueda personalizados con el mismo profileName tienen una prioridad más alta que los perfiles predeterminados. Por lo tanto, los perfiles personalizados se cargan primero si se encuentran en ZooKeeper; de lo contrario, se cargan los perfiles de servicio de consulta predeterminados. Esto es para proporcionar la funcionalidad de anulación temporal de los perfiles de búsqueda.

Los perfiles predeterminados están presentes en la ubicación siguiente dentro del contenedor de servicios de consulta: /opt/WebSphere/Liberty/usr/servers/default/apps/search-query.ear/search-query.war/WEB-INF/classes/profiles

Para proporcionar la funcionalidad de herencia con perfiles de búsqueda, se extrae el perfil definido en el atributo parentProfileName y sus campos se fusionan con el perfil actual. Al extraer el perfil principal, se sigue aplicando la regla de prioridad de ZooKeeper mencionada anteriormente.

Para obtener más información, consulte Configuración del perfil de búsqueda personalizado.

Configuraciones

La estructura (formato/notación) de la configuración de HCL Commerce ha cambiado Matchmaker de color versión 9.1.7.0. Sin embargo, la estructura para todos los demás nodos de punto final de configuración (componente, uoms, filtro, etc.) sigue siendo la misma. Si ha añadido configuraciones personalizadas al nodo de configuración de colores, efectúe los pasos siguientes para hacer una copia de seguridad, fusionar los cambios personalizados y volver a aplicar estas configuraciones:

Para realizar una copia de seguridad de la configuración de colores antes de la migración, utilice el punto final de configuración de API de consulta de datos del servicio de consultas para el nodo de colores.
```
GET http://QUERY_HOSTNAME:
              QUERY_PORT/api/v2/configuration?nodeName=colors&envType=auth&locale=en_US 
```
Puede guardar la respuesta de esta llamada GET como colors_v916.json.
Después de la migración, utilice el mismo punto final de configuración de API de consulta de datos del servicio de consultas para el nodo de colores para obtener la configuración de colores más reciente.
```
GET http://QUERY_HOSTNAME:
              QUERY_PORT/api/v2/configuration?nodeName=colors&envType=auth&locale=en_US 
```
Puede guardar la respuesta de esta llamada GET como colors_v918.json.
Compare ambos JSON para fusionar manualmente los cambios. Aplíquelo de nuevo utilizando el método PATCH en el punto final de configuración de la API de consulta de datos para el nodo de colores proporcionando el JSON fusionado final en el cuerpo.
```
PATCH http://QUERY_HOSTNAME:
              QUERY_PORT/api/v2/configuration?nodeName=colors&envType=auth&locale=en_US 
```
Reinicie el contenedor de servicios de consulta.

Note: La versión 9.1.6 de la configuración de colores estará en el formato de "light salmon": "red_255", lo cual proporcionó el valor más significativo del espectro RGB. En la versión 9.1.7, el formato/notación ha cambiado a "light salmon": "[[red],[255,160,122]]" para proporcionar el valor de espectro RGB completo para mejorar la precisión de coincidencia de color. Por lo tanto, al fusionar los cambios de configuración de colores personalizados, deben proporcionarse los valores de espectro de tríada RGB completos.

Para obtener más información, consulte Configuración del servicio de consultas

Note: Al migrar de la versión 9.1.8 a versiones superiores, se pueden utilizar puntos finales de importación/exportación para exportar todas las configuraciones de servicio de consulta para importar a nuevos entornos.

Proveedores de expresiones personalizados y procesadores de consulta

Si ha ampliado el servicio de consultas creando proveedores de expresiones personalizados o preprocesadores o posprocesadores, asegúrese de realizar una copia de seguridad del archivo JAR de extensión antes de la migración. Vuelva a aplicar las expresiones después de la migración en el directorio de extensión de servicio de consulta tal como se describe en Ampliación del servicio de consulta.

Note: Los cambios de esquema de Elasticsearch no deben afectar a la API de REST V2, sin embargo, los cambios de esquema de índice pueden afectar a preprocesadores/postprocesadores de consulta personalizados. Deben evaluarse basándose en los cambios específicos del esquema y pueden requerir refactorización.

Atributos

Para actualizar atributos, haga lo siguiente:

Dentro del perfil personalizado, cambie el valor responseField de attributes.* a attribute.source.
En el postprocesamiento, analice la cadena de origen y asigne los valores resultantes a los campos de respuesta de API respectivos.

Además, al buscar o agregar, puede utilizar campos distintos del origen del atributo y el campo de faceta en el nivel base.