HCL Commerce Version 9.1.12.0 or later

Tutoriel : Personnalisation des connecteurs du magasin de ressources de catalogue par défaut avec le profil Ingest

Ce tutoriel explique comment utiliser des profils Ingest avec les connecteurs de votre magasin de ressources de catalogue pour séparer 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 de requête 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 pour HCL Commerce Search. Les étapes sont principalement basées sur Personnalisation des profils Ingest.

Il est recommandé de connaître les termes et concepts suivants :

Temps nécessaire

Prévoyez trois heures pour réaliser ce tutoriel. 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.
  1. Assurez-vous que vous disposez d'un environnement HCL Commerce Developer configuré pour la plateforme de données Elasticsearch. Pour plus d'informations, voir Configuration de l'HCL Commerce Developer Search environment.
  2. 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. Utilisez cette option pour configurer le kit d'outils NiFi, comme indiqué plus loin dans ce tutoriel. Ce fichier inclut l'exemple de code Java et des tests Junit que vous utilisez dans ce tutoriel.

  3. 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.
  4. 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 CAS est activé en exécutant une requête SQL telle que :
    SELECT * FROM STORECONF WHERE name = 'wc.search.CASIndexModel';
    Vous devriez recevoir une réponse true.

    Si la réponse n'est pas true, exécutez la requête de mise à jour suivante pour la mettre à jour :
    UPDATE STORECONF SET VALUE= 'true' WHERE name = 'wc.search.CASIndexModel';
    Déclenchez un index complet pour le magasin EmeraldMP (storeId=12001) à l'aide du nœud final Ingest suivant. 
    POST http://INGEST_HOST:30800/connectors/auth.reindex/run?storeId=12001
    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, un attribut supplémentaire, seller_description apparaît dans la réponse pour les appels GET ci-dessus.
  5. 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.12, les fichiers JAR sont les suivants :
    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
  6. 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 suivante dans la zone d'entrée Objectifs : 
    clean install -U -Denforcer.skip=true
    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.