Guía de aprendizaje: Personalización de conectores de tiendas con elementos de catálogo con un perfil de Ingest

Este tutorial muestra cómo utilizar perfiles de Ingest con los conectores de tiendas con elementos de catálogo para separar completamente las configuraciones personalizadas y el código de lógica de la lógica de la versión del producto. Esta separación lógica facilita la actualización a futuras versiones del producto.

En el entorno de desarrollo predeterminado, el perfil de búsqueda indexa el vendedor de atributos preestablecidos para las tiendas de Marketplace. El vendedor es el proveedor que vende los productos en la tienda de Marketplace.

En este tutorial, aprenderá a indexar una descripción de vendedor de atributos adicional para la tienda de Marketplace ampliando el SQL predeterminado en un procesador de Ingest personalizado. Escribirá un código de procesador de Ingest personalizado en Java y compilará y probará esta lógica de procesador de Ingest personalizada exclusivamente en un kit de herramientas NiFi para ampliar los conectores predeterminados. Al alterar temporalmente el perfil de búsqueda de consulta predeterminado, podrá consultar el nuevo atributo, que se indexa utilizando la lógica de Ingest personalizada en los campos de respuesta.

Nivel de conocimientos

Este tutorial va dirigido a los desarrolladores avanzadosHCL Commerce que son responsables de crear y actualizar personalizaciones de HCL Commerce Search. Los pasos se basan principalmente en la Personalización de perfiles de Ingest.

Se recomienda estar familiarizado con los términos y conceptos siguientes:

HCL Commerce Search. Para leer una introducción al respecto, consulte Uso del servicio HCL Commerce Search y Personalización de la solución de búsqueda basada en Elasticsearch.
El modelo de indexación de tiendas con elementos de catálogo (CAS), tal y como se describe en Elección del modelo de índice.
Los servicios de HCL Commerce. Para obtener más información, consulte Trabajar con servicios SOI de HCL Commerce.
El servicio de Ingest. Para leer una introducción al respecto, consulte Servicio Ingest, y para obtener una guía sobre la personalización, consulte Ampliación del servicio Ingest.
Perfiles de Ingest.
Apache NiFi.
Programación en Java.
Apache Maven.
Lenguaje de Consulta Estructurada (SQL).

Tiempo necesario

El tiempo previsto para completar esta guía de aprendizaje es de tres horas. La guía de aprendizaje tarda más tiempo si se exploran conceptos relacionados con la misma.

Requisitos previos

Siga los siguientes pasos para preparar el sistema para el tutorial:

Asegúrese de que tiene un entorno HCL Commerce Developer configurado para la plataforma de datos de Elasticsearch. Para obtener más información, consulte Configuración de HCL Commerce Developer Search environment.
Descargue y extraiga HCL_Commerce_Search_Bundle_9.1.x.x.zip del Portal de entregas y licencias de HCL. Después de descomprimir el archivo, localice el archivo commerce-custom-search-marketplace-seller.zip en el directorio extraído \dependencies\nifi\Tutorials.
Extraiga commerce-custom-search-marketplace-seller.zip en un directorio temporal en su entorno de desarrollo. Utilice esto para configurar el kit de herramientas NiFi, tal y como se indica más adelante en este tutorial. Este archivo incluye los códigos de Java y las pruebas de Junit de ejemplo que utiliza en este tutorial.
Habilite la característica de vista previa de Marketplace en HCL Commerce Developer Tooling environment. Para obtener más información, consulte Habilitación de Marketplace en HCL Commerce Developer Legacy environment.
Habilite la característica de Marketplace utilizando el siguiente punto final de configuración del servicio de consulta.
```
PATCH http://QUERY_HOST:QUERY_PORT/search/resources/api/v2/configuration?nodeName=ingest&envType=auth 
```
con este cuerpo de solicitud:
```
{ "global": { "connector": [ { "name": "attribute", "property": [ { "name": "flow.marketplace", "value": "true" } ] } ] } } 
```
Note: Todas las API mencionadas en el tutorial deben ejecutarse añadiendo una autenticación básica para el usuario spiuser, donde el usuario es spiuser y la contraseña es
```
QxV7uCk6RRiwvPVaa4wdD78jaHi2za8ssjneNMdu3vgqi 
```
Asegúrese de que el modelo de índice CAS está habilitado ejecutando una consulta SQL como la siguiente:
```
SELECT * FROM STORECONF WHERE name = 'wc.search.CASIndexModel';
```
Debe recibir una respuesta true.
Si no es true, ejecute la siguiente consulta de actualización para actualizarlo:
```
UPDATE STORECONF SET VALUE= 'true' WHERE name = 'wc.search.CASIndexModel';
```
Ejecute un índice completo para la tienda EmeraldMP (storeId=12001) utilizando el siguiente endpoint de Ingest.
```
POST http://INGEST_HOST:30800/connectors/auth.reindex/run?storeId=12001 
```
Una vez que la compilación se ha completado y la consola NiFi muestra 0/0 bytes en la cola de datos, ejecute los siguientes comandos GET utilizando un cliente de REST.
1. Compruebe la respuesta para el perfil de búsqueda predeterminado HCL_V2_findProductByPartNumber_Details ejecutando la siguiente invocación GET.
```
GET http://QUERY_HOST:30920/search/resources/api/v2/products?storeId=31&seller=7000000000000007002&partNumber=MPHBA031_310301 
```
2. Compruebe la respuesta para el perfil de búsqueda predeterminado HCL_findCatalogEntrySKUs ejecutando la siguiente invocación GET.
```
GET http://QUERY_HOST:30920/search/resources/api/v2/products?storeId=31&seller=7000000000000007002&id=14503 
```
La respuesta contiene el atributo de vendedor. Al final del tutorial, aparecerá un atributo adicional, seller_description, en respuesta para las invocaciones GET anteriores.
Prepare el kit de herramientas de desarrollo para NiFi siguiendo las instrucciones que figuran en Procesadores personalizados de NiFi. El kit de herramientas de NiFi debe configurarse habiendo establecido Eclipse para utilizar el compilador Java 1.8, con la versión 3.8.4 de Maven u otra posterior. Establezca la vía de acceso de compilación de Java para que el proyecto importado utilice bibliotecas JavaSE-1.8.
Parchee el contenedor NiFi en la plataforma de datos y obtenga los archivos JAR más recientes del contenedor con parches en ejecución antes de configurar y compilar elementos de tutorial en el kit de herramientas NiFi. Por ejemplo, para el entorno de la versión 9.1.12, los archivos JAR son los siguientes:
1. commerce-search-processors-9.1.12.0.jar
2. hcl-cache-core-9.1.12.0-20221201.221643-25.jar
3. cf-base-9.1.12.0-20221123.064414-9.jar
Inicie una Compilación de Maven... en el proyecto del paquete raíz. En el Explorador de proyectos, haga clic con el botón derecho en la raíz (commerce-search-custom-bundle-9.1.x.x) y seleccione Ejecutar como > Compilación de Maven.... Se abre la ventana Editar configuración.
Escriba el siguiente comando en el campo de entrada Objetivos:
```
clean install -U -Denforcer.skip=true
```
Pulse el botón Ejecutar.
Una vez que la compilación se ha realizado correctamente, los archivos JAR pueden visualizarse en el subdirectorio de destino del proyecto commerce-custom-search-processors.