Tutoriel : Personnalisation des connecteurs par défaut avec le profil Ingest

Ce tutoriel explique comment utiliser des profils Ingest avec les connecteurs par défaut pour séparer complètement les configurations personnalisées et le code logique de la logique d'édition de produit. Cette séparation logique facilite la mise à niveau vers les éditions ultérieures du produit.

Dans l'environnement de développement par défaut, le profil de recherche indexe le vendeur d'attributs prédéfinis pour les magasins de la place de marché. Le vendeur est le fournisseur qui vend les produits sur le magasin de la place de marché.

Dans ce tutoriel, vous apprenez à indexer une description de vendeur d'attribut supplémentaire pour le magasin de la place de marché en étendant la SQL par défaut dans un processeur Ingest personnalisé. Vous allez écrire du code de processeur Ingest personnalisé dans Java et générer et tester cette logique de processeur Ingest personnalisée exclusivement dans un kit d'outils NiFi, pour étendre les connecteurs par défaut. Le remplacement du profil de recherche Query par défaut vous permet d'effectuer une requête sur le nouvel attribut, qui est indexé à l'aide de la logique Ingest personnalisée dans les zones de réponse.

Niveau de compétences requis

Ce tutoriel s'adresse aux développeurs HCL Commerce expérimentés chargés de la création et de la mise à jour des personnalisations de la recherche HCL Commerce. Les étapes sont principalement basées sur Personnalisation de profils ingest.

Pour suivre ce tutoriel, vous devez être familiarisé avec les termes et les concepts suivants :

HCL Commerce Search
HCL Commerce Services
Profils Ingest
Système Ingest
Java
Maven
NiFi
SQL

Temps nécessaire

Le déroulement de ce tutoriel dure trois heures. Le tutoriel prend plus de temps si vous explorez les concepts connexes qu'il aborde.

Prérequis

Effectuez les étapes suivantes pour préparer votre système à l'utilisation du tutoriel.

Assurez-vous que vous disposez d'un environnement de développement HCL Commerce configuré pour la plateforme de données Elasticsearch. Pour plus d'informations, voir Configuration de l'HCL Commerce Developer Search environment.
Téléchargez HCL_Commerce_Search_Bundle_9.1.x.x.zip à partir de HCL License & Delivery Portal et procédez à son extraction. Après avoir décompressé le fichier, localisez le fichier commerce-custom-search-marketplace-seller.zip dans le répertoire \dependencies\nifi\Tutorials extrait.
Extrayez commerce-custom-search-marketplace-seller.zip dans un répertoire temporaire dans votre environnement de développement. Ce fichier est utilisé pour configurer le kit d'outils NiFi. Ce fichier inclut l'exemple de code Java et des tests Junit que vous utilisez dans ce tutoriel.
Activez la fonction d'aperçu de la place de marché dans HCL Commerce Developer Tooling environment. Pour plus d'informations, voir Activation de Marketplace dans le HCL Commerce Developer Legacy environment.
Activez la fonctionnalité Marketplace à l’aide du point de terminaison de configuration du service Query suivant.
```
PATCH http://QUERY_HOST:QUERY_PORT/search/resources/api/v2/configuration?nodeName=ingest&envType=auth 
```
avec ce corps de requête :
```
{ "global": { "connector": [ { "name": "attribute", "property": [ { "name": "flow.marketplace", "value": "true" } ] } ] } } 
```
Note: Toutes les API mentionnées tout au long du tutoriel doivent être exécutées en ajoutant l'authentification de base pour l'utilisateur spiuser, où l'utilisateur est spiuser et le mot de passe est
```
QxV7uCk6RRiwvPVaa4wdD78jaHi2za8ssjneNMdu3vgqi
```
Assurez-vous que le modèle d'index eSite est activé en exécutant la requête SQL suivante :
```
SELECT * FROM STORECONF WHERE name = 'wc.search.CASIndexModel'
```
Vous devez recevoir un false dans la colonne VALUE pour la table storeconf.
Déclenchez un index complet pour le magasin EmeraldMP (storeId=31) à l'aide du nœud final Ingest suivant.
```
POST http://INGEST_HOST:30800/connectors/auth.reindex/run?storeId=31 
```
Une fois la génération terminée et que la console NiFi affiche les données en file d'attente de 0/0 octets, exécutez les commandes GET suivantes à l'aide d'un client REST.
1. Vérifiez la réponse pour le profil de recherche par défaut HCL_V2_findProductByPartNumber_Details en exécutant l'appel GET suivant.
```
GET http://QUERY_HOST:30920/search/resources/api/v2/products?storeId=31&seller=7000000000000007002&partNumber=MPHBA031_310301 
```
2. Vérifiez la réponse pour le profil de recherche par défaut HCL_findCatalogEntrySKUs en exécutant l'appel GET suivant.
```
GET http://QUERY_HOST:30920/search/resources/api/v2/products?storeId=31&seller=7000000000000007002&id=14503 
```
La réponse contient l'attribut seller. A la fin du tutoriel, vous pourrez voir un attribut supplémentaire seller_description dans la réponse pour les appels GET ci-dessus.
Préparez le kit d'outils de développement pour NiFi en suivant les instructions de Processeurs NiFi personnalisés. Le kit d'outils NiFi doit être configuré avec Eclipse défini pour utiliser le compilateur Java 1.8, avec Maven version 3.8.4 ou ultérieure. Définissez le chemin de génération Java pour que le projet importé utilise les bibliothèques JavaSE-1.8.
Appliquez des correctifs au conteneur NiFi sur la plateforme de données et obtenez les derniers fichiers JAR à partir du conteneur corrigé en cours d'exécution avant de configurer et de générer des ressources de tutoriel dans le kit d'outils NiFi. Par exemple, pour l'environnement version 9.1.10, les fichiers JAR sont les suivants :
- commerce-search-processors-9.1.10.0.jar
- hcl-cache-core-9.1.10.0-20220322.160926-24.jar
- cf-base-9.1.10.0-20220322.160733-7.jar
Lancez une Génération Maven… sur le projet de groupement racine. Dans l'explorateur de projets, cliquez avec le bouton droit de la souris sur la racine (commerce-search-custom-bundle-9.1.x.x) et sélectionnez Exécuter en tant que > Génération Maven… . La fenêtre Editer la configuration s'affiche.
Entrez la commande clean install -U -Denforcer.skip=true dans la zone d'entrée Objectifs et cliquez sur le bouton Exécuter.
Une fois la génération réussie, les fichiers NAR peuvent être consultés dans le sous-répertoire cible du projet commerce-custom-search-processors.