JR44751: CMVC 221237 - TO DISPLAY THE SALES CATEGORIES IN THE UTILITY PANE FOR STOREFRONTASSETSTORE FOR MARKETING AND PROMOTIONS

APAR status

• Closed as program error.

Error description

• A business user is using the Promotion or Marketing tool in
  Management Center in a storefront asset store. The business
  users uses the utility pane to browse or search for a sales
  category that is defined in a catalog asset store.  The utility
  pane does not display the catalog asset store sales categories,
  and the business user cannot refer to the catalog asset store
  sales categories in promotions and marketing activities.
  

Local fix

Problem summary

• USERS AFFECTED:
  WebSphere Commerce v7 users who try to browse sales catalogs
  owned by the asset store when using the Marketing or Promotion
  tool in a storefront store.
  
  PROBLEM ABSTRACT:
  When using the Promotion or Marketing tool in Management Center
  in a storefront asset store, business users cannot use sales
  categories from a Catalog Asset Store.
  
  BUSINESS IMPACT:
  Business user cannot refer to the catalog asset store sales
  categories in promotions and marketing activities, limiting
  their capabilities with those tools.
  
  RECOMMENDATION:
  

Problem conclusion

• The Management Center code can be fixed to no longer exclude
  sales catalogs when using the Promotion or Marketing tools in a
  storefront asset store.  Due to the nature of this fix and the
  modification of non-restricted, customizable Management Center
  files, this APAR does not include any code changes. The code
  changes must be applied manually in a development environment.
  Once all of the file updates listed below have been completed,
  the Management Center files need to be deployed for use by
  business users.
  
  1. Open WebSphere Commerce Developer
  (http://publib.boulder.ibm.com/infocenter/wchelp/v7r0m0/topic/co
  m.ibm.commerce.developer.doc/refs/rdestartwctoolkit.htm) and
  switch to the Enterprise Explorer view.
  
  2. Open the file
  LOBTools\WebContent\config\commerce\marketing\MarketingManagemen
  tToolDefinition.def
  3. Locate the line: <ObjectTypeFilter
  baseDefinitionName="catSalesCatalogGroupsFilter"/>
  4. Replace that line with: <ObjectTypeFilter
  baseDefinitionName="catSalesCatalogGroupsAllowStorefrontAssetSto
  reFilter"/>
  
  5. Open the file
  LOBTools\WebContent\config\commerce\promotion\PromotionManagemen
  tToolDefinition.def
  6. Locate the line: <ObjectTypeFilter
  baseDefinitionName="catSalesCatalogGroupsFilter"/>
  7. Replace that line with: <ObjectTypeFilter
  baseDefinitionName="catSalesCatalogGroupsAllowStorefrontAssetSto
  reFilter"/>
  
  8. Open the file
  LOBTools\WebContent\config\commerce\catalog\restricted\CatalogMa
  nagementFilterDefinitions.def
  9. Locate the line starting with: <ObjectTypeFilter
  definitionName="catSalesCatalogGroupsFilter"
  displayName="${catalogResources.salesCategoriesFilterTitle}"
  filterType="SalesCategories"
  10. After that ObjectTypeFilter element, add the following
  additional ObjectTypeFilter element:
    <ObjectTypeFilter
  definitionName="catSalesCatalogGroupsAllowStorefrontAssetStoreFi
  lter"
  displayName="${catalogResources.salesCategoriesFilterTitle}"
  filterType="SalesCategories"
  objectTypes="DefaultCatalog,ChildCatalogGroup,ChildInheritedCata
  logGroup,SalesCatalog,InheritedSalesCatalog,ChildSalesCatalogGro
  up,ChildInheritedSalesCatalogGroup,SharedSalesCatalogGroup,Share
  dInheritedSalesCatalogGroup,SharedCatalogGroup,SharedInheritedCa
  talogGroup,ChildSalesCatalogGroupForSalesCatalog,ChildInheritedS
  alesCatalogGroupForSalesCatalog,SharedSalesCatalogGroupForSalesC
  atalog,SharedInheritedSalesCatalogGroupForSalesCatalog,SharedCat
  alogGroupForSalesCatalog,SharedInheritedCatalogGroupForSalesCata
  log">
    <EnablementOrCondition
  baseDefinitionName="catStoreTypeSalesCatalogObjectFilterRestrict
  ionAllowStorefrontAssetStore"/>
   </ObjectTypeFilter>
  
  11. Open the file
  LOBTools\WebContent\config\commerce\catalog\objectDefinitions\Ca
  talogCommonObjectDefinitions.def
  12. Locate the line starting with:  <EnablementOrCondition
  conditionId="storeTypeCondition3"
  13. After that EnablementOrCondition element, add the following
  additional EnablementOrCondition element:
  
   <!---
    This is a condition to remove the sales catalog option from
  the filter in the explorer view for store of type:<br/>
     <ul>
      <LI>SHS (supplier hosted store)
      <LI>RPS (Consumer direct reseller store front asset store)
      <LI>BRP (B2B reseller store front asset store)
      <LI>DPS (Distributor asset store)
      <LI>DPX (Distributor proxy store)
      <LI>SCS (Supplier catalog asset store)
      <LI>SPS (Supplier asset store)
      <LI>HCP (Hosting hub)
      <LI>PBS (Store directory)
     </ul>
    Note that this condition allows the store types MPS and BMP
  which are for
    Consumer direct hosted store front asset store and
    B2B hosted store front asset store respectively.
    By adding or removing wcfEnablementCondition for the
  contextName storeType, you can control in which store type
    the option of Sales Catalog Categories will appear in the
  explorer view.<br/>
   -->
   <EnablementOrCondition conditionId="storeTypeCondition4"
  definitionName="catStoreTypeSalesCatalogObjectFilterRestrictionA
  llowStorefrontAssetStore" negate="true">
    <EnablementCondition conditionId="shsCondition"
  contextName="storeType" enablementValue="SHS"/>
    <EnablementCondition conditionId="rpsCondition"
  contextName="storeType" enablementValue="RPS"/>
    <EnablementCondition conditionId="brpCondition"
  contextName="storeType" enablementValue="BRP"/>
    <EnablementCondition conditionId="dpsCondition"
  contextName="storeType" enablementValue="DPS"/>
    <EnablementCondition conditionId="dpxCondition"
  contextName="storeType" enablementValue="DPX"/>
    <EnablementCondition conditionId="scsCondition"
  contextName="storeType" enablementValue="SCS"/>
    <EnablementCondition conditionId="spsCondition"
  contextName="storeType" enablementValue="SPS"/>
    <EnablementCondition conditionId="hcpCondition"
  contextName="storeType" enablementValue="HCP"/>
    <EnablementCondition conditionId="pbsCondition"
  contextName="storeType" enablementValue="PBS"/>
   </EnablementOrCondition>
  
  After you complete your customization:
  
      1. Save all the updated files.
      2. Test your changes by viewing them in the Management
  Center, using this URL: https://hostname:8000/lobtools.
      3. Deploy your changes to your production environment.
  (http://publib.boulder.ibm.com/infocenter/wchelp/v7r0m0/topic/co
  m.ibm.commerce.developer.doc/tasks/tdpdeploying_j2ee_assets_enti
  re.htm)
  -------------------------------------------------------------
  The latest available maintenance information can be obtained
  from the Recommended Fixes for WebSphere Commerce technote:
  http://www.ibm.com/support/docview.wss?rs=3046&uid=swg21261296
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  WC BUS EDITION

• Fixed component ID

  5724I3800

Applicable component levels

• R700 PSY

     UP