Création de la commande de tâche permettant d'extraire des recommandations externes

En étendant la classe DisplayExternalRecommendationActionTaskCmdImpl, vous pouvez extraire des recommandations d'entrée de catalogue d'un système externe afin de les afficher sur les pages de votre magasin.

Avant de commencer

Examinez la rubrique suivante pour vous assurer de bien comprendre la classe à étendre :

Pourquoi et quand exécuter cette tâche

La classe DisplayExternalRecommendationActionTaskCmdImpl par défaut ne renvoie pas de recommandations sans personnalisation. Vous devez étendre cette classe et implémenter la méthode getRecommendationsFromExternalSystem pour extraire une liste d'ID entrée de catalogue du système externe et les afficher dans un emplacement e-Marketing.

La structure de cette personnalisation inclut également une interface utilisateur préconfigurée (voir la capture d'écran de la rubrique Ajout de la prise en charge des recommandations externes à l'interface utilisateur du Centre de gestion). Si cette interface utilisateur ne fournit pas les fonctions qui répondent aux besoins de votre entreprise, par exemple, si vous souhaitez baser les recommandations sur le contenu de la liste de présélection d'un client, il existe des méthodes supplémentaires que vous pouvez étendre dans la classe DisplayExternalRecommendationActionTaskCmdImpl. Ces points sont les suivants :
  • performExecute : pour effectuer la logique métier supplémentaire de l'instruction de tâche
  • validateParameters : pour valider des paramètres d'interface utilisateur supplémentaires lorsqu'un professionnel active une activité marketing contenant l'élément d'action Afficher une recommandation provenant d'un système externe

Procédure

  1. Ouvrez HCL Commerce Developer et basculez vers la vue Explorateur d'entreprise.
  2. Créez un module pour le fichier de votre commande de tâche :
    1. Naviguez jusqu'à WebSphereCommerceServerExtensionsLogic > src.
    2. Cliquez avec le bouton droit sur le dossier src, puis cliquez sur Nouveau > Package.
    3. Dans la zone Name, saisissez com.your_company_name.marketing.commands.elements.
    4. Vérifiez que WebSphereCommerceServerExtensionsLogic/src est spécifié dans le champ Dossier source.
    5. Cliquez sur Terminer.
  3. Dans le nouveau module, créez une implémentation de commande de tâche qui étend la classe DisplayExternalRecommendationActionTaskCmdImpl et implémente la méthode getRecommendationsFromExternalSystem. Si nécessaire, étendez également les méthodes validateParameters et performExecute dans cette classe. Donnez à la classe un nom qui utilise cette syntaxe : external_recommendation_systemTaskCmdImple; par exemple, MyRecommendationEngineTaskCmdImpl.
  4. Enregistrez la commande de tâche dans la table CMDREG. Voici un exemple d'instruction SQL qui enregistre ce type de commande de tâche : 
    insert into cmdreg (STOREENT_ID, INTERFACENAME, CLASSNAME) values 
(0, 'com.ibm.commerce.marketing.commands.elements.DisplayExternalRecommendationActionTaskCmd', 
'com.mycompany.marketing.commands.elements.MyRecommendationEngineTaskCmdImpl');