Enabling fix JR55608

JR55608 introduces a new parameter that can allow the Data Load utility to change a catalog entry's parent master category relationship.

By default, if the data to be loaded includes an entry to add a new parent master category to a catalog entry that has an existing parent master category, then you encounter a validation error. If you want to allow the Data Load utility to overwrite the parent master category, then complete the following procedure.

Before you begin

Install interim fix JR55608.

Procedure

  1. Open the custom WC_eardir\xml\config\com.ibm.commerce.catalog-ext\dataload\wc-loader-catalog-entry-parent-catalog-group.xml file.
    If a custom file does not exist, complete the following steps to create the custom file:
    1. Create the following directory structure if needed, WC_eardir\xml\config\com.ibm.commerce.catalog-ext\dataload\
    2. In the \dataload\ folder, create an empty wc-loader-catalog-entry-parent-catalog-group.xml file.
    3. Add the following code to the file.
      <_config:DataloadBusinessObjectConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/foundation/config ../../../../xml/config/xsd/wc-dataload-businessobject.xsd" 
      xmlns:_config="http://www.ibm.com/xmlns/prod/commerce/foundation/config">
      
           <_config:DataLoader className="com.ibm.commerce.foundation.dataload.BusinessObjectLoader">
                //add your code here
           </_config:DataLoader>
      
      </_config:DataloadBusinessObjectConfiguration>
      
  2. Set the replaceParentMasterCategory property to true by adding the following code snippet within the <_config:DataLoader> section.
    <_config:BusinessObjectMediator className="com.ibm.commerce.catalog.dataload.mediator.CatalogEntryParentCatalogGroupMediator"
         componentId="com.ibm.commerce.catalog" >
         <_config:property name="replaceParentMasterCategory" value="true" />
    </_config:BusinessObjectMediator>
  3. Open the custom WC_eardir\xml\config\com.ibm.commerce.catalog-ext\dataload\wc-loader-catalog-entry.xml file.
    If a custom file does not exist, complete the following steps to create the custom file:
    1. In the \dataload\ folder, create an empty wc-loader-catalog-entry.xml file.
    2. Add the following code to the file.
      <_config:DataloadBusinessObjectConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/foundation/config ../../../../xml/config/xsd/wc-dataload-businessobject.xsd" 
      xmlns:_config="http://www.ibm.com/xmlns/prod/commerce/foundation/config">
      
           <_config:DataLoader className="com.ibm.commerce.foundation.dataload.BusinessObjectLoader" >
      	    //add custom properties here
           </_config:DataLoader>
      
      </_config:DataloadBusinessObjectConfiguration>
      
  4. Set the replaceParentMasterCategory property to true by adding the following code snippet within the <_config:DataLoader> section.
    <_config:BusinessObjectMediator className="com.ibm.commerce.catalog.dataload.mediator.CatalogEntryMediator" componentId="com.ibm.commerce.catalog" >
         <_config:property name="replaceParentMasterCategory" value="false" />
    </_config:BusinessObjectMediator>