Management Center: Promotions component configuration file (wc-admin-component.xml)

Develop > Presentation layer > Customize promotions > Promotions customization: Management Center > Work with the promotions component configuration file

Promotions component configuration file (wc-admin-component.xml)

The promotions component configuration file (wc-admin-component.xml) contains properties related to configuring promotions features for Management Center. You can change the properties to suit the site's needs by creating a custom wc-admin-component.xml file that contains the changed properties only.
The promotions component configuration file is stored at this location:
WC_EAR\xml\config\com.ibm.commerce.promotion\wc-admin-component.xml
WC_EAR\xml\config\com.ibm.commerce.promotion-fep\template\wc-admin-component.xml
The following table summarizes the configurable properties in the file:
Property Description
<_config:property name="PromotionUniqueCodeValidation" value="false"/> Controls validation of unique promotion codes.
The Value parameter can be set to:

false

Allows business users to assign the same promotion code to more than one active promotion in the same store. This is the default setting.

true

Prevents business users from assigning the same promotion code to more than one active promotion in the same store. This setting enforces unique promotion codes so that there is only one associated promotion that can apply to a customer's order on the storefront.
When a business user activates a promotion, the promotion engine checks the store for active promotions that use the same promotion code. If there are any, the business user is prevented from activating the promotion. An error message informs the business user that the promotion code is currently being used so that he or she can assign a different code.

In an extended site model, promotion code validation is a site-wide setting. For example, if a business user activates a promotion with promotion code ABC in an asset store, no other promotions in either the same store or the extended sites can be activated with promotion code ABC.
<_config:property name="PromotionUniquePriorityValidation" value="false"/> Controls validation of unique promotion priorities.
The Value parameter can be set to:

false

Allows business users to assign the same priority to more than one active promotion in the same promotion group in the same store. This is the default setting.

true

Prevents business users from assigning the same priority to more than one active promotion in the same promotion group in the same store. For example, only one active shipping promotion can be assigned a priority of 1. This setting ensures that business users assign unique priorities to control the order in which the promotion engine evaluates promotions in the same promotion group.
When a business user activates a promotion, the promotion engine checks for active promotions in the same promotion group that have the same priority. If there are any, the business user is prevented from activating the promotion. An error message informs the business user that the priority is currently being used so that he or she can assign a different priority.

In an extended site model, priority validation is a site-wide setting. For example, if a business user activates a promotion with a priority of 10 in an asset store, no other promotions in either the same store or the extended sites can be activated with a priority of 10.
<_config:property name="userBehaviorBatchUpdateCacheSize" value="100"/> Controls the size of the data recorded in memory before batch inserting best sellers data into the DMRANKINGSTAT database table. The Value parameter can be set to a custom size to achieve optimum performance.
<_config:property name="dailyScheduledJobTimeForTriggers" value="02:00"/> Controls the time that the order data is analyzed and the best sellers list is updated per day. The Value parameter can be set to a custom update time. The format for time is hh:mm where:

hh = two digits representing the hour (00 through 23)

mm = two digits representing the minute (00 through 59)

At the configured time, the best sellers list is updated for the categories specified in any best sellers action for all the currently active activities. This setting should be configured to be at an off-peak time of the site.
<_config:property name="WaitingPeriodForUniqueCodeRelease" value="1440"/> Controls the number of minutes until a unique promotion code applied by a guest shopper from an abandoned order is released and can be applied by another customer.
The Value parameter can be set to a positive integer value in minutes, or set to -1 where the promotion code is not released unless it is manually removed by the guest shopper.
<_config:property name="CodeGenerateBatchSize" value="1000"/> Controls the number of unique promotion codes to be generated or imported in a single scheduler job.
The Value parameter can be set to a positive integer value to minimize database locking on the code table.
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticLowerPatternCharacters" 
  value="abcdefghijklmnopqrstuvwxyz"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticLowerPatternCode" 
  value="a"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticMixPatternCharacters" 
  value="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticMixPatternCode" 
  value="M"/> 

<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticUpperPatternCharacters" 
  value="ABCDEFGHIJKLMNOPQRSTUVWXYZ"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticUpperPatternCode" 
  value="A"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphaLowerNumericPatternCharacters" 
  value="abcdefghijklmnopqrstuvwxyz0123456789"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphaLowerNumericPatternCode" 
  value="x"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphaMixNumericPatternCharacters" 
  value="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphaMixNumericPatternCode" 
  value="N"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphaUpperNumericPatternCharacters" 
  value="ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.AlphaUpperNumericPatternCode" 
  value="X"/> 

<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.NumericPatternCharacters" 
  value="0123456789"/> 
<_config:property 
  name="com.ibm.commerce.promotion.uniquecode.generator.NumericPatternCode" 
  value="D"/>
Controls the input and output values that are generated using advanced system-generated unique promotion codes. The default input and output pattern values is based on English alphanumeric characters.
The Value parameter of each property can be set to custom alphanumeric character values to support the custom characters.
Related tasks

Changing properties in the promotions component configuration file (wc-admin-component.xml)

+
Search Tips | Advanced Search

Property	Description
<_config:property name="PromotionUniqueCodeValidation" value="false"/>	Controls validation of unique promotion codes. The Value parameter can be set to: false Allows business users to assign the same promotion code to more than one active promotion in the same store. This is the default setting. true Prevents business users from assigning the same promotion code to more than one active promotion in the same store. This setting enforces unique promotion codes so that there is only one associated promotion that can apply to a customer's order on the storefront. When a business user activates a promotion, the promotion engine checks the store for active promotions that use the same promotion code. If there are any, the business user is prevented from activating the promotion. An error message informs the business user that the promotion code is currently being used so that he or she can assign a different code. In an extended site model, promotion code validation is a site-wide setting. For example, if a business user activates a promotion with promotion code ABC in an asset store, no other promotions in either the same store or the extended sites can be activated with promotion code ABC.
<_config:property name="PromotionUniquePriorityValidation" value="false"/>	Controls validation of unique promotion priorities. The Value parameter can be set to: false Allows business users to assign the same priority to more than one active promotion in the same promotion group in the same store. This is the default setting. true Prevents business users from assigning the same priority to more than one active promotion in the same promotion group in the same store. For example, only one active shipping promotion can be assigned a priority of 1. This setting ensures that business users assign unique priorities to control the order in which the promotion engine evaluates promotions in the same promotion group. When a business user activates a promotion, the promotion engine checks for active promotions in the same promotion group that have the same priority. If there are any, the business user is prevented from activating the promotion. An error message informs the business user that the priority is currently being used so that he or she can assign a different priority. In an extended site model, priority validation is a site-wide setting. For example, if a business user activates a promotion with a priority of 10 in an asset store, no other promotions in either the same store or the extended sites can be activated with a priority of 10.
<_config:property name="userBehaviorBatchUpdateCacheSize" value="100"/>	Controls the size of the data recorded in memory before batch inserting best sellers data into the DMRANKINGSTAT database table. The Value parameter can be set to a custom size to achieve optimum performance.
<_config:property name="dailyScheduledJobTimeForTriggers" value="02:00"/>	Controls the time that the order data is analyzed and the best sellers list is updated per day. The Value parameter can be set to a custom update time. The format for time is hh:mm where: hh = two digits representing the hour (00 through 23) mm = two digits representing the minute (00 through 59) At the configured time, the best sellers list is updated for the categories specified in any best sellers action for all the currently active activities. This setting should be configured to be at an off-peak time of the site.
<_config:property name="WaitingPeriodForUniqueCodeRelease" value="1440"/>	Controls the number of minutes until a unique promotion code applied by a guest shopper from an abandoned order is released and can be applied by another customer. The Value parameter can be set to a positive integer value in minutes, or set to -1 where the promotion code is not released unless it is manually removed by the guest shopper.
<_config:property name="CodeGenerateBatchSize" value="1000"/>	Controls the number of unique promotion codes to be generated or imported in a single scheduler job. The Value parameter can be set to a positive integer value to minimize database locking on the code table.
<_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticLowerPatternCharacters" value="abcdefghijklmnopqrstuvwxyz"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticLowerPatternCode" value="a"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticMixPatternCharacters" value="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticMixPatternCode" value="M"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticUpperPatternCharacters" value="ABCDEFGHIJKLMNOPQRSTUVWXYZ"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphabeticUpperPatternCode" value="A"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphaLowerNumericPatternCharacters" value="abcdefghijklmnopqrstuvwxyz0123456789"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphaLowerNumericPatternCode" value="x"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphaMixNumericPatternCharacters" value="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphaMixNumericPatternCode" value="N"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphaUpperNumericPatternCharacters" value="ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.AlphaUpperNumericPatternCode" value="X"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.NumericPatternCharacters" value="0123456789"/> <_config:property name="com.ibm.commerce.promotion.uniquecode.generator.NumericPatternCode" value="D"/>	Controls the input and output values that are generated using advanced system-generated unique promotion codes. The default input and output pattern values is based on English alphanumeric characters. The Value parameter of each property can be set to custom alphanumeric character values to support the custom characters.