Personnalisation du gestionnaire de codes promotionnels

public interface PromotionCodeResolver extends XMLizable {
   /**
    * IBM Copyright
    */
    public static final String COPYRIGHT = IBMCopyright.SHORT_COPYRIGHT;

   /**
    * Resolves a promotion code to a promotion.
    * @param code the code
    * @param context the context within which the resolution is performed.
    * @return the key to the promotion which is identified by this
    * promotion code.
    */

   PromotionKey resolve(String code, PromotionContext context)
      throws PromotionApplicationException;

   /**
    * Resolves a promotion code to a promotion. A name-value pair style
    * parameter can be passed in.
    * The implementor is responsible for checking whether the required 
    * parameters are provided.
    * This is for customization purposes. This method is often used when
    * promotion codes are evaluated.
    * The reason the other resolve method is not used is because it needs a
    * PromotionContext object, which may not be available at the time
    * codes are validated.
    * @param code the code
    * @param custoProp custom properties passed to the resolver for promotion
    * resolution.
    * @return the key to the promotion which is identified by this promotion 
    * code.
    */
    
    PromotionKey resolve(String code, Hashtable NVP)
       throws PromotionApplicationException;
}

Les deux méthodes clés sont les deux méthodes resolve. La première admet en entrée une chaîne correspondant à un code promotionnel et à son contexte (PromotionContext). Cette méthode est généralement appelée lorsque le moteur de promotion a été appelé. La seconde admet en entrée un paramètre de type chaîne (String), c'est-à-dire le code promotionnel, et un paramètre de type paire nom-valeur de table de hachage (Hashtable NVP). Elle est généralement appelée pour valider un nouveau code promotionnel ajouté à une commande. Par convention, la clé du magasin est sauvegardée sur cette paire nom-valeur, sous le nom "StoreKey".

Les développeurs d'applications personnalisées de gestion de codes promotionnels doivent fournir leur implémentation de la méthode resolve afin de déchiffrer un code promotionnel de type chaîne pour mettre en corrélation une clé et une promotion. Il s'agit généralement d'un problème spécifique au site à traiter au cas par cas.

Au cours de la résolution du code promotionnel, le résolveur peut enregistrer, à des fins d'analyse, l'utilisation d'un code particulier. De même, lorsqu'une commande est confirmée et soumise, un événement PromotionAppliedEvent est émis. Par conséquent, un développeur d'applications de gestion de codes promotionnels peut devoir créer un programme d'écoute pour cet événement et enregistrer les codes promotionnels qui déclenchent réellement des achats.

Vous pouvez personnaliser les codes promotionnels pour qu'une zone unique de panier d'achat n'accepte qu'un seul code promotionnel. Cela signifie que, lorsqu'il existe plusieurs codes promotionnels pour une commande, seul le dernier entré est appliqué à la commande et tous les autres sont supprimés. Sans personnalisation, tous les codes promotionnels sont cumulés et appliqués. Pour modifier le comportement par défaut, procédez comme suit :

Un redémarrage de HCL Commerce est nécessaire après toute modification apportée à PromotionCodeManager ou à PromotionCodeResolver.