HCL Commerce Version 9.1.10.0 or later

Personalizar procesadores NiFi

Los procesadores NiFi son los bloques de construcción esenciales de las canalizaciones de flujo de datos. Los procesadores realizan tareas específicas dentro de la canalización, como escuchar los datos entrantes; extraer datos de fuentes externas; publicar datos en fuentes externas, y direccionar, transformar o extraer información de archivos de flujo. Al crear un procesador personalizado, se pueden realizar distintas operaciones o para transformar el contenido del archivo de flujo de acuerdo con los requisitos específicos de la empresa.

Before you begin

  • Asegúrese de que tiene conexión a Internet.
  • Asegúrese de que dispone de la última versión de HCL Commerce. Para los fines de este tema, la versión mínima requerida es HCL Commerce 9.1.10.0.
  • Se requiere un entorno de desarrollo integrado (IDE) con un plugin de Maven. Si las opciones de Maven no están disponibles en su IDE, deberá instalar el complemento de Maven. Consulte el plugin M2Eclipse para obtener más información y las instrucciones de instalación.
    Note: Rational Application Developer (RAD) no es compatible con la personalización del servicio Ingest.

Utilice las instrucciones siguientes para descargar, extraer e importar la plantilla del proyecto y configure su entorno de proyecto.

Procedure

  1. Abra un navegador web y vaya a HCL License and Delivery portal.
  2. Busque el paquete HCL_Commerce_Search_Bundle_9.1.xxzip para la versión deseada (por ejemplo, HCL_Commerce_Search_Bundle_9.1.10.x.zip ) y descárguelo.
  3. Extraiga el paquete descargado HCL_Commerce_Search_Bundle_9.1.x.x.zip y obtenga la plantilla de proyecto commerce-custom-search-bundles-9.1.x.x.zip de la ubicación \HCL_Commerce_Search_Bundle_9.1.x.x\commerce-search-bundle\dependencies\nifi\9.x.x.
    La carpeta principal de NiFi proporciona paquetes de procesadores de NiFi personalizados para las versiones HCL Commerce 9.1.12.0 y posteriores.
    Por ejemplo, la versión 9.1.12.0, commerce-custom-search-bundles-9.1.12.0.zip se puede obtener en la siguiente ubicación en el directorio extraído; HCL_Commerce_Search_Bundle_9.1.12.0\commerce-search-bundle\dependencies\nifi\9.1.10
  4. Dentro del contenedor de NiFi, navegue hasta el directorio /opt/nifi/nifi-current/work/nar/extensions/commerce-search-processors-nar-9.1.x.x.nar-unpacked/NAR-INF/bundled-dependencies/.
  5. Extraiga los siguientes tres archivos JAR, que tendrán nombres de archivo únicos según la versión del contenedor NiFi:
    • commerce-search-processors-*.jar
    • hcl-cache-core-*.jar
    • cf-base-*.jar
    Por ejemplo, tres archivos representativos podrían denominarse:
    • commerce-search-processors-9.1.12.0.jar
    • hcl-cache-core-9.1.12.0-20210714.164808-41.jar
    • cf-base-9.1.12.0-20210623.164640-10.jar
    Un ejemplo de mandato Docker, para copiar un archivo jar del contenedor, es:
    docker cp <nifi_container_id>: opt/nifi/nifi-current/work/nar/extensions/commerce-search-processors-nar-9.1.12.0.nar-unpacked/NAR-INF/bundled-dependencies/commerce-search-processors-9.1.12.0.jar /root/libs
  6. Coloque estos archivos JAR de dentro del directorio /libs/ dentro de la raíz del directorio del proyecto commerce-custom-search-processors que se ha extraído del archivo commerce-custom-search-bundles-9.1.x.x.zip de plantilla de proyecto. Cambie el nombre de los archivos para eliminar los números de las versiones.
    Cambiar nombre:
    • commerce-search-processors-9.1.12.0.jar a commerce-search-processors.jar
    • hcl-cache-core-9.1.12.0-20210714.164808-41.jar a hcl-cache-core.jar
    • cf-base-9.1.12.0-20210623.164640-10.jar a cf-base.jar
  7. Actualice el archivo pom.xml del directorio raíz del proyecto commerce-custom-search-processors y cambie las referencias del nombre del archivo a los nombres de los archivos JAR extraídos.
    Por ejemplo:
    <dependency> <groupId>com.hcl.commerce</groupId> <artifactId>dummy-commerce-search-processors</artifactId> <version>9.1.12.0</version> <scope>system</scope> <systemPath>${project.basedir}/libs/commerce-search-processors.jar</systemPath></dependency>
  8. Importe la plantilla del proyecto como proyectos Maven existentes (Archivo > Importar > Proyectos > Maven Existentes) utilizando Eclipse, o el Rational Application Developer incluido con el kit de herramientas HCL Commerce, con un plugin de Maven.
  9. Seleccione el directorio raíz para el contenido de la plantilla del proyecto extraído.

    1. Por ejemplo, si ha extraído la plantilla del proyecto en c:\downloads\, entonces seleccione c:\downloads\commerce-custom-search-bundles-9.1.12.0\ como directorio raíz.

    2. Pulse Finalizar y espere a que las dependencias terminen de descargarse.

Results

Su entorno de desarrollo está ahora preparado para crear procesadores NiFi personalizados.