Customizing functionality level features

Customize functionality level features by modifying the action they perform and the graphic image they use. Features are defined in the functionality-level.config file. A feature definition consists of up to five parts:

n	Feature ID

This is the feature name and must be a unique alphanumeric string, enclosed within <ID> and </ID> tags. This value is used as the feature name in functionality level definitions. Do not change this value, because the IDs are used in the Actuate Information Console code to identify the features.

Label key

This key is used in the Actuate Information Console resource files. These files have names of the format, ActivePortalResources_<locale>.properties. The files are located in <context root>\WEB-INF\lib\resources.jar. If this file does not contain a resource file for a locale, the resource file, ActivePortalResources.properties, for the default locale, en_US, is used. The key provides for proper translation in the resource file so that the hyperlink text for the feature is displayed using the current locale. Keys are enclosed within <Labelkey> and </Labelkey> tags. Do not change the key values or the resource string substitution fails.

Link

This link is the target URI of the label key hyperlink, which is typically to the page that corresponds to the feature. Table 1-5 shows the targets for each feature. Links are enclosed within <Link> and </Link> tags. Change the link target for the feature by replacing the default page or action name.

**Table 1-5** Actuate Information Console targets for features
Feature	Actuate Information Console target
Documents	\getfolderitems.do
Jobs	\selectjobs.do
Channels	\selectchannels.do
Search	\searchfiles.do
Customization	\customize.do

n	Large icon and Small icon

These optional icons are displayed together with the link, depending on the skin. For example, the classic skin displays the large icons, the treeview skin uses the small icons, and the tabbed skin does not use these icons at all. Table 1-6 shows features and their icons. Large icons are 32 pixels square. Their file names are relative to the context root and are enclosed within <LargeIcon> and </LargeIcon> tags. Small icons are 16 pixels square. Their file names are relative to the context root and are enclosed within <SmallIcon> and </SmallIcon> tags. Replace these file names with the names of your own icons to customize your skin’s appearance.

**Table 1-6** Icons for features
Feature	SmallIcon	LargeIcon
Documents	\images\filesfoldersicon16x16.gif	\images\filesfoldersicon.gif
Jobs	\images\requestsicon16x16.gif	\images\requestsicon.gif
Channels	\images\channelsicon16x16.gif	\images\channelsicon.gif

The following example shows a sample definition for the Channels feature. This example specifies custom large and small icons. The classic and treeview skins, and any skins cloned from them, use these new images for the channel icon.

<ID>Channels</ID>

<Labelkey>SBAR_CHANNELS</Labelkey>

<Link>/selectchannels.do</Link>

<SmallIcon>/images/customIcon16x16.gif</SmallIcon>

<LargeIcon>/images/customIcon32x32.gif</LargeIcon>

</Feature>