JR50973: Loading Composer layouts with Data Load for a custom device class fails

APAR status

• Closed as program error.

Error description

• After creating a new device class in wc-devices.xml, attempts to
  load Composer layouts using Data Load for this new class (ex.
  'Tablet') may fail.
  
   Example error
  
   Exception message:
   The specified device class "Tablet" is not valid.
   Stack trace:
   com.ibm.commerce.pagelayout.dataload.exception.PageLayoutDataLo
  adApplicationException: The specified device class "Tablet" is
  not valid.
     at
  com.ibm.commerce.pagelayout.dataload.mediator.LayoutMediator.pop
  ulatePAGELAYOUT(LayoutMediator.java:477)
     at
  com.ibm.commerce.pagelayout.dataload.mediator.LayoutMediator.tra
  nsform(LayoutMediator.java:128)
     at
  com.ibm.commerce.foundation.dataload.businessobjectmediator.Abst
  ractBusinessObjectMediator.execute(AbstractBusinessObjectMediato
  r.java:450)
     at
  com.ibm.commerce.foundation.dataload.businessobjectbuilder.Abstr
  actBusinessObjectBuilder.processData(AbstractBusinessObjectBuild
  er.java:568)
     at
  com.ibm.commerce.foundation.dataload.businessobjectbuilder.Abstr
  actBusinessObjectBuilder.processData(AbstractBusinessObjectBuild
  er.java:513)
     at
  com.ibm.commerce.foundation.dataload.businessobjectbuilder.Abstr
  actBusinessObjectBuilder.execute(AbstractBusinessObjectBuilder.j
  ava:283)
     at
  com.ibm.commerce.foundation.dataload.AbstractBusinessObjectLoade
  r.processBusinessObjectBuilder(AbstractBusinessObjectLoader.java
  :2037)
     at
  com.ibm.commerce.foundation.dataload.AbstractBusinessObjectLoade
  r.processDataObject(AbstractBusinessObjectLoader.java:1979)
     at
  com.ibm.commerce.foundation.dataload.AbstractBusinessObjectLoade
  r.loadData(AbstractBusinessObjectLoader.java:1815)
     at
  com.ibm.commerce.foundation.dataload.AbstractBusinessObjectLoade
  r.execute(AbstractBusinessObjectLoader.java:481)
     at
  com.ibm.commerce.foundation.dataload.DataLoaderMain.execute(Data
  LoaderMain.java:459)
     at
  com.ibm.commerce.foundation.dataload.DataLoaderMain.main(DataLoa
  derMain.java:215)
  

Local fix

• If possible, use one of the default device classes instead (ex.
  Any/Mobile/Web)
  

Problem summary

• USERS AFFECTED:
   WebSphere Commerce users on v7.0 loading composer layouts for
  custom devices
  
   PROBLEM ABSTRACT:
   Loading Composer layouts with Data Load for a custom device
  class fails
  
   BUSINESS IMPACT:
   Users may not be able to load composer layouts for their own
  custom-defined devices
  
   RECOMMENDATION:
  

Problem conclusion

• With this fix, If the user wants to specify their own device
  class for the template/layout, they will need to define their
  own device classes in the STORECONF table with the attribute
  'wc.pagelayout.deviceClass' in the name column and the device
  class that they want to use in the value column.  Multiple
  device classes can be specified with a comma separator.
  
   Here is an example:
   insert into STORECONF (storeent_id, name, value) values
  (<storeId>, 'wc.pagelayout.deviceClass', 'Any, Mobile, Tablet')
  
   The validateDeviceClass method in the LayoutMediator is
  modified to perform a lookup in the STORECONF table first to
  validate the device classes.  If it is defined, it will use what
  is specified in the table to perform validation.  If it is not
  specified, it will validate using the old method, meaning only
  the 'Any, Mobile or Web' device classes will be validated.
  Note:  If the 'wc.pagelayout.deviceClass' exists for the store
  but the value specified is NULL, validation will only check for
  'Any, Mobile or Web'.
  
  
  
   -------------------------------------------------------------
   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