Changing UI Labels

All labels visible in the Personalization portion of the ATG Business Control Center are defined in a resource bundle called WebAppResources.properties located in one of the following places:

Module

Resource Bundle Path and Name

Description

WebUI

<ATG2007.3dir>/WebUI/lib/
classes.jar/atg/web

Navigation pane tree

AssetUI

<ATG2007.3dir>/AssetUI/lib/classes.jar
/atg/web/assetmanager

Tabs and general UI infrastructure used by all ATG Business Control Center applications

DPS-UI

<ATG2007.3dir>/DCS-UI/lib/classes.jar
/atg/web/personalization

Views and other UI elements designed for targeters, users, roles, and other Personalization items.

Keeping labels in a resource bundle makes your application available for localization. Any time you want to add or change a label, do so in a custom resource bundle rather than the default resource bundle so that your changes aren’t overwritten when you install a new version of ATG Business Control Center. Resource bundles should exist in a directory, such as <ATG2007.3dir>/home/locallib, that automatically adds files to your CLASSPATH.

Labels for custom screen elements should be defined in a resource bundle. If you created a view in the Browse tab that lists all manufacturers, for example, you can provide a label to that view by completing these two tasks:

  1. Update a custom task configuration file to identify the appropriate resource bundle (if you are using a resource bundle that isn’t the default) and the resource bundle key for the view:

    <tabs>
      <tab id="browse">
        <views>
          <view-order>
            <view-id>manufacturer</view-id>
            <view-id>catalogTree</view-id>
            <view-id>catalogMedia</view-id>
            <view-id>catalogOrphans</view-id>
            <view-id>promotions</view-id>
            <view-id>priceLists</view-id>
            <view-id>pricelistFolders</view-id>
            <view-id>coupons</view-id>
          </view-order>
          <initial-view>
            manufacturer
          </initial-view>
          <view id="manufacturer">
            <resource-bundle>
              atg.commerce.web.MyResourceBundle
            </resource-bundle>
            <display-name-resource>
              browseTab.view.manufacturer
            </display-name-resource>
            <configuration>
              /atg/commerce/web/assetmanager/
              ManufacturerViewConfiguration
            </configuration>
          </view>
        </views>
      </tab>
    <tabs>

    For more information on the task configuration file, see Tailoring the UI for Specific Workflows, Tasks, and Activities.

  2. In the resource bundle, specify the key from the task configuration file equal to the name you want to use in the UI:

    browseTab.view.manufacturer=Manufacturers

 
loading table of contents...