Globally Excluded Products Import and Export
Global Product Exclusions rules are imported as part of promotion import.
When configuring Global Product Exclusions rules, keep the following in mind:
- An empty Global Product Exclusions rule isn't exported.
- Global product exclusion rules are replicated with the campaigns and promotions of the site.
- Global product exclusion rules are replicated with the campaigns and promotions of the site.
- New promotion-level settings are replicated with the promotion.
- The
promotion.xsd
top-level element <promotions> contains the element <global-promotion-settings> of complex type PromotionSettings. This element is the container of the <global-excluded-products> rule. - The <global-promotion-settings> element is optional and can occur at most once. The complex types ProductPromotionRule and OrderPromotionRule support the flag <disable-global-excluded-products>.
A site always owns a PromotionSettings instance. This instance can never be deleted, but only reset. The following is how the different modes behave:
<promotion-settings> | Update or Merge | Replace | Delete |
---|---|---|---|
with <global-excluded-products> | Global excluded product rule is created or updated. | PromotionSettings instance is reset to its initial state (meaning that all of its values are removed), after that global excluded products rule is created. | PromotionSettings instance is reset to its initial state (meaning that all of its values are removed). |
with <global-excluded-products/> empty | If it exists, the global excluded product rule is removed. | PromotionSettings instance is reset to its initial state (means all of its values are removed), after that global excluded products rule is NOT new created. | PromotionSettings instance is reset to its initial state (means all of its values are removed). |
empty | PromotionSettings instance isn't touched. | PromotionSettings instance is reset to its initial state (means all of its values are removed). | PromotionSettings instance is reset to its initial state (means all of its values are removed). |
undefined | PromotionSettings instance isn't touched. | PromotionSettings instance isn't touched. | PromotionSettings instance isn't touched. |
Note: If promotions are created with no <disable-global-excluded-products>
flag, import sets the default value to FALSE. The import always updates the
global-excluded-products rule completely. There is no partial update of the rule.