Personalizar el gestor de códigos de promoción

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;
}

Los dos métodos clave son los dos métodos resolve. El primero toma un parámetro String que es un código de promoción y un PromotionContext. Normalmente, se llama a este método cuando se ha invocado el Motor de promociones. El segundo método resolve toma un parámetro String que es el código de promoción y un parámetro Hashtable de pareja nombre-valor. Este método se invoca normalmente cuando se añade un nuevo código de promoción a un pedido, para validar el código de promoción. Por convención, la clave para la tienda se guarda en esta pareja nombre-valor utilizando el nombre "StoreKey".

Los desarrolladores de aplicaciones de códigos de promoción personalizadas deben proporcionar su implementación del método resolve para descifrar un código de promoción de caracteres para emparejar una clave con una promoción. Esto suele ser una cuestión específica del sitio y debe tratarse caso por caso.

Tenga en cuenta que, cuando se está resolviendo el código de promoción, el componente de resolución puede registrar el hecho de que se ha utilizado un código determinado, con fines de análisis. Además, cuando se confirma y se somete un pedido, se genera un PromotionAppliedEvent, de modo que es posible que un desarrollador de aplicaciones de códigos de promoción necesite crear un escucha para escuchar este suceso y registrar los códigos de promoción que realmente desencadenan compras.

Puede personalizar los códigos de promoción de forma que un único camop de un carro de la compra sólo acepte un código de promoción. Esto significa que cuando hay varios códigos de promoción para un pedido, sólo se aplicará el código de promoción que se ha entrado en último lugar y se eliminarán los demás. En un método no personalizado, todos los códigos de promoción se acumularán y se aplicará en total. Esto puede verse afectado por los pasos siguientes:

Es necesario reiniciar HCL Commerce después de realizar cualquier cambio en PromotionCodeManager o PromotionCodeResolver.