WebSphere Commerce EnterpriseIntroduced in Feature Pack 2

Defining icons to represent the price rule element

You can create and load three sizes of a custom icon to represent your new price rule element in the Management Center user interface. These images help business users identify the element when creating price rules in the Price Rule Builder.

About this task

Rather than hard-coding image file names in the OpenLaszlo class files, include all paths to images in resource files, and associate the files with resource keys. This way, you maintain the user interface code in one area (the OpenLaszlo file) and the images in another (resource file). This is particularly useful if you have images that will change often or require translation. In the Price Rule Builder user interface, each price rule element is represented by an icon. Each icon is displayed in three different locations in the user interface, and each location requires the same icon in a different size. The following table summarizes these requirements:
Specifications for palette icons
Location of icon in Price Rule Builder Suggested size of icon
In the palette 20x20 pixels
In the work area (after a business user drags the icon from the palette onto the flow) 32x32 pixels
In the properties view (top-left corner) below the work area 63x60 pixels

Procedure

  1. Open WebSphere Commerce Developer and switch to the Enterprise Explorer view.
  2. Copy the three image files to the following locations:
    • For the icon in the palette:

      LOBTools/WebContent/WEB-INF/src/lzx/your_company_name/price/resources/pal/

    • For the icon in the work area:

      LOBTools/WebContent/WEB-INF/src/lzx/your_company_name/price/resources/dgm/

    • For the icon in the properties view:

      LOBTools/WebContent/WEB-INF/src/lzx/your_company_name/price/resources/hdr/

  3. Define a resource file to reference the images:
    1. Navigate to the directory to store your new resource file, for example:

      LOBTools/WebContent/WEB-INF/src/lzx/your_company_name/price/resources/

    2. Create an OpenLaszlo file for your customized resources, for example, extPricingManagementResources.lzx.
    3. Within the resources file, list the three images and associate a resource name with each path and file name.
      Here is an example of the contents of the file:
      <library>
          <resource name="customNewRegisteredConditionPaletteIcon" src="pal/cNewRegCon_pal.png"/>
          <resource name="customNewRegisteredConditionIcon" src="dgm/cNewRegCon_dgm.png"/>
          <resource name="customNewRegisteredConditionHeaderIcon" src="hdr/cNewRegCon_hdr.png"/>
      </library>
    4. Save and close the file.
  4. Add a reference to the new resource file in the PricingExtensionsLibrary.lzx file.

    The file is stored at this path:

    LOBTools/WebContent/WEB-INF/src/lzx/commerce/price/PricingExtensionsLibrary.lzx

    The line of code that references the new object definition should look like the following example:

    <include href="../../your_company_name/price/resources/extPricingManagementResources.lzx"/>