Management Center file directory structure

Management Center files include OpenLaszlo source files, definition files, images, HTML pages, properties files, Struts action classes, JSP files, and the ManagementCenter.swf file. Any files that you customize within the Management Center should follow the same directory structure as the default files provided with the Management Center. Keeping a consistent directory structure is important if you plan to migrate to a later release, or if you require assistance from IBM support with your customizations.

Use a similar file structure for any files that you add to the Management Center (for example, when adding a new custom tool). Note the following exceptions:

  • Use your own company name for the commerce directory mentioned in the table below. For example, instead of using WebContent/WEB-INF/src/lzx/commerce/Management_Center_component, use WebContent/WEB-INF/src/lzx/myCompanyName/Management_Center_component
  • You do not require a restricted directory (such as WebContent/WEB-INF/src/lzx/ commerce/myCompanyName/restricted). Restricted directories under the commerce directory are to indicate directories that will be replaced when you install WebSphere Commerce fixes, or migrate to the next release. This is not applicable for custom tools.
Note: If you use a source control management system to store your files, consider that some files that should not be checked into a source control (for example, avoid checking in restricted directories).
You can access the Management Center files using two methods:
  • On your file system, the Management Center files are located under the WCDE_installdir\workspace\LOBTools directory.
  • Within your development environment, open WebSphere Commerce Developer, switch to the Enterprise Explorer view, and expand LOBTools,

Here is the file directory structure for all Management Center files:

Directory path (all directory paths are relative to the LOBTools directory) Type or name of files in this directory
WebContent/WEB-INF/src/lzx/commerce/Management_Center_component

Management_Center_componentManagementToolDefinition.lzx
Management_Center_componentExtensionsLibrary.lzx
WebContent/WEB-INF/src/lzx/ commerce/Management_Center_component/restricted
Depending on the Management Center component, there may also be these sub-directories, under the restricted directory:
  • activityBuilder
  • listViewDefinitions
  • objectDefinitions
  • propertiesViews
  • propertiesViews\activityBuilder
  • searchDefinitions

Note that the restricted directory contains files that you must not modify when customizing the Management Center. Files within the restricted directories will be replaced when you install WebSphere Commerce fixes, or migrate to the next release.

Management_Center_componentFilterDefinitions.lzx
Management_Center_componentLibrary.lzx
Management_Center_componentResourceBundle.lzx
Management_Center_componentResources.lzx

WebContent/WEB-INF/src/lzx /commerce/Management_Center_component/listViewDefinitions All the list view definitions
WebContent/WEB-INF/src/lzx /commerce/Management_Center_component/objectDefinitions All the object definitions and validator definitions
WebContent/WEB-INF/src/lzx /commerce/marketing/objectDefinitions/activityBuilder All the activity builder object definitions and validator definitions
WebContent/WEB-INF/src/lzx /commerce/promotion/objectDefinitions/elements All the promotion element object definitions and validator definitions
WebContent/WEB-INF/src/lzx /commerce/promotion/objectDefinitions/promotionTypes All the promotion type object definitions and validator definitions
WebContent/WEB-INF/src/lzx /commerce/Management_Center_component/propertiesViews All the properties view definitions
WebContent/WEB-INF/src/lzx /commerce/marketing/propertiesViews/activityBuilder All the activity builder properties view definitions
WebContent/WEB-INF/src/lzx /commerce/promotion/propertiesViews/promotionTypes All the promotion types properties view definitions
WebContent/WEB-INF/src/lzx /commerce/Management_Center_component/searchDefinitions All the search definitions
src/com.ibm.commerce.Management_Center_component.client.lobtools.properties

When files are built, the properties files are copied into another folder, called WebContent/WEB-INF/classes/ com.ibm.commerce.Management_Center_component.client.lobtools.properties

 Properties file for all user interface text, labels, and messages, called Management_Center_componentLOB_en_US.properties

Do not change the properties files. Instead, create a file with the same name, and save it in the extension directory (for example, src/extension/Management_Center_component).
WebContent/jsp/commerce/Management_Center_component All mediator JSP files that return Management Center objects
WebContent/config/commerce/Management_Center_component Management_Center_componentManagementToolDefinition.def
WebContent/config/commerce/Management_Center_component/listViewDefinitions All the list view definitions
WebContent/config/commerce/Management_Center_component/objectDefinitions All the object definitions
WebContent/config/commerce/marketing/objectDefinitions/activityBuilder All the activity builder object definitions
WebContent/config/commerce/promotion/objectDefinitions/elements All the promotion element object definitions
WebContent/config/commerce/promotion/objectDefinitions/promotionTypes All the promotion type object definitions
WebContent/config/commerce/Management_Center_component/propertiesViews All the properties view definitions
WebContent/config/commerce/marketing/propertiesViews/activityBuilder All the activity builder properties view definitions
WebContent/config/commerce/promotion/propertiesViews/promotionTypes All the promotion types properties view definitions
WebContent/config/commerce/Management_Center_component/searchDefinitions All the search definitions