Configure the promotion engine for a custom agenda builder


To configure the promotion engine to use a customer agenda builder:

  1. Edit the promotion engine configuration XML file in an editor. You can find this file in the following location: WC_eardir/xml/PromotionEngineConfiguration/WCSPromotionEngineConfig.xml

  2. Update the following code segment: 
    <PromotionExecutionAgendaBuilder impl="
com.ibm.commerce.marketing.promotion.runtime.DefaultAgendaBuilder">

  3. The segment in bold should be updated to reflect either the custom agenda builder, or one of the following agenda builders:

    StorePathSupportedAgendaBuilder

    This is the default agenda builder. It supports all of the WebSphere Commerce features and business models. To select this agenda builder, set the PromotionExecutionAgendaBuilder's impl parameter to 
    com/ibm/commerce/marketing/promotion/runtime/StorePathSupportedAgendaBuilder.java

    CodeDrivenAgendaBuilder

    This agenda builder only builds a PromotionExecutionAgenda for promotions for which a promotion code is entered by a customer. To select this sequence builder, set the PromotionExecutionAgendaBuilder's impl parameter to 
    com/ibm/commerce/marketing/promotion/runtime/CodeDrivenAgendaBuilder.java

    DefaultAgendaBuilder

    A former default agenda builder that does not support B2B business models. To select this sequence builder, set the PromotionExecutionAgendaBuilder's impl parameter to 
    com/ibm/commerce/marketing/promotion/runtime/DefaultAgendaBuilder.java

    ShopcartDrivenAgendaBuilder

    This agenda builder searches for promotions that are directly related to the contents of the customers shopping cart, rather than searching all defined promotions. This agenda builder satisfies retail store check-out process requirements, which evaluates the promotions each time a product gets scanned. Therefore, it significantly decreases evaluation time. Other promotion types, such as order level promotions still follow the default procedure.

    This builder requires some predefined customer based search algorithm for product level promotions. The algorithm depends on the relationship between products and promotions in your store. This builder, provides a WebSphere Commerce specific search algorithm, which uses a set of calculation code related tables, CATENCALCD and CATGPCALCD. To select this agenda builder, set the PromotionExecutionAgendaBuilder's impl parameter to: 

    com/ibm/commerce/marketing/promotion/runtime/ShopCartDrivenAgendaBuilder.java
    You may also see the following agenda builders, which are not intended to be used directly:

    PromotionExecutionAgendaBuilder

    A dummy interface to facilitate customization. Any custom agenda builders must call this interface.

    Need this description

  4. Publish the updated configuration file to the production server.


 

Related tasks


Configure the Promotion Engine

 

Related Reference


Example: Promotion engine configuration XML file