HCL Commerce Version 9.1.10.0 or later

Processeurs NiFi personnalisés

Les processeurs NiFi sont les éléments structurels de base des pipelines de flux de données. Les processeurs effectuent des tâches spécifiques dans le pipeline, telles que l'écoute des données entrantes ; l'acquisition de données à partir de sources externes ; la publication de données vers des sources externes et le routage, la transformation ou l'extraction d'informations à partir de fichiers de flux. La création de votre propre processeur personnalisé permet d'effectuer différentes opérations ou de transformer le contenu du fichier de flux en fonction d'exigences métier spécifiques.

Before you begin

  • Assurez-vous d'avoir une connexion Internet.
  • Assurez-vous de posséder la dernière version de HCL Commerce. Pour les besoins de cette rubrique, la version minimale requise est HCL Commerce 9.1.10.0.
  • Un environnement de développement intégré (IDE) avec un plug-in Maven est requis. Si les options de Maven ne sont pas disponibles dans votre IDE, vous devez installer le plug-in Maven. Pour plus d'informations et d'instructions d'installation, voir le plug-in M2Eclipse.
    Note: Rational Application Developer (RAD) n'est pas pris en charge pour la personnalisation du service Ingest.

Utilisez les instructions suivantes pour télécharger, extraire et importer le modèle de projet, puis définissez votre environnement de projet.

Procedure

  1. Ouvrez un navigateur Web et rendez-vous sur le site HCL License and Delivery portal.
  2. Recherchez le groupement HCL_Commerce_Search_Bundle_9.1.xxzip pour la version souhaitée (par exemple HCL_Commerce_Search_Bundle_9.1.10.x.zip) et téléchargez-le.
  3. Extrayez le groupement HCL_Commerce_Search_Bundle_9.1.x.x.zip téléchargé et obtenez le modèle de projet commerce-custom-search-bundles-9.1.x.x.zip à partir de l'emplacement \HCL_Commerce_Search_Bundle_9.1.x.x\commerce-search-bundle\dependencies\nifi\9.x.x.
    Le dossier NiFi parent fournit des packages de processeurs NiFi personnalisés pour les versions HCL Commerce 9.1.12.0 et ultérieures.
    Par exemple, la version 9.1.12.0 commerce-custom-search-bundles-9.1.12.0.zip peut être obtenue à l'emplacement suivant sous le répertoire extrait ; HCL_Commerce_Search_Bundle_9.1.12.0\commerce-search-bundle\dependencies\nifi\9.1.10
  4. Dans le conteneur NiFi, accédez au répertoire /opt/nifi/nifi-current/work/nar/extensions/commerce-search-processors-nar-9.1.x.x.nar-unpacked/NAR-INF/bundled-dependencies/.
  5. Extrayez les trois fichiers JAR suivants, qui auront des noms de fichier uniques en fonction de la version du conteneur NiFi :
    • commerce-search-processors-*.jar
    • hcl-cache-core-*.jar
    • cf-base-*.jar
    Par exemple, trois fichiers représentatifs peuvent être nommés :
    • 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 exemple de commande Docker pour copier un fichier jar hors du conteneur est :
    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. Placez ces fichiers JAR dans le répertoire /libs/ à la racine du répertoire de projet commerce-custom-search-processors extrait de l'archive commerce-custom-search-bundles-9.1.x.x.zip de modèle de projet. Renommez les fichiers pour supprimer les numéros de version.
    Renommer :
    • commerce-search-processors-9.1.12.0.jar sur commerce-search-processors.jar
    • hcl-cache-core-9.1.12.0-20210714.164808-41.jar sur hcl-cache-core.jar
    • cf-base-9.1.12.0-20210623.164640-10.jar sur cf-base.jar
  7. Mettez à jour le fichier pom.xml dans le répertoire racine du projet commerce-custom-search-processors et remplacez les références de nom de fichier par les noms des fichiers JAR extraits.
    Par exemple :
    <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. Importez le modèle de projet en tant que projets Maven existants (Fichier > Importer > Maven > Projets Maven existants) à l'aide d'Eclipse ou le Rational Application Developer inclus avec le kit d'outils HCL Commerce, avec un plug-in Maven.
  9. Sélectionnez le répertoire racine pour le contenu du modèle de projet extrait.

    1. Par exemple, si vous avez extrait le modèle de projet dans le c:\downloads\, sélectionnez c:\downloads\commerce-custom-search-bundles-9.1.12.0\ en tant que répertoire racine.

    2. Cliquez sur Terminer et attendez que le téléchargement des dépendances soit terminé.

Results

Votre environnement de développement est maintenant prêt à créer des processeurs NiFi personnalisés.