Configuring Siebel Business Applications > Configuring Menus, Toolbars, and Icons > Customizing Icons >

Example of Using Icons to Represent Values in a Field

This topic describes one example of using images to represent a field. You might use this feature differently, depending on your business model.

An icon map is an object type that allows you to represent the values in a control or list column as icons. Each icon map includes a collection of child icon objects. Siebel CRM associates these icon objects with a bitmap object, which defines the image for the icon, and corresponds to a specific field value. The Icon Map property of a control or list column allows you to define the icon map that Siebel CRM uses to render the values in a field.

The example in this topic uses the Status list column on the Activity List Applet. Assume that the Status field can include the following values:

• Not Started
• In Progress
• Done

You must configure the Status field to display an icon for each of these values.

NOTE:  If you must use a custom icon in a list applet, then you must size the icon according to the row font size of the list applet. For example, an eight point font is typical for Siebel CRM. If you use an eight point font, then the icon must be 23 pixels wide by 14 pixels high. If you change the list applet row font size dynamically, or if you place an icon that is larger than 23 pixels by 14 pixels in a row, then Siebel CRM scrambles the list applet rows.

To use icons to represent values in a field

1. Create a bitmap category named Activity Status Icons.

   For more information, see Customizing a Bitmap Category and a Bitmap.

2. In the Bitmaps list, create three new bitmap objects for each image that you must display using values from the following table.

   Name	File Name
   Not Started	notstarted.gif
   In Progress	inprogress.gif
   Done	done.gif

   For more information, see Customizing a Bitmap Category and a Bitmap.

3. In the Object Explorer, click Icon Map.
4. In the Icon Maps list, create a new icon map named Activity Status.
5. In the Object Explorer, expand the Icon Map tree, and then click Icon.
6. In the Icons list, create three new icon objects for each field value using values from the following table.

   Name	Bitmap Category	Bitmap
   Not Started	Activity Status Icon	Not Started
   In Progress	Activity Status Icon	In Progress
   Done	Activity Status Icon	Done

   Note how you use the following properties:

   • Name. Set to the name of the field value.
   • Bitmap Category. Set to the bitmap category you must use for the field value.
   • Bitmap. Set to the bitmap object you must use for the field value.
7. In the Object Explorer, click Applet, and then locate the Activity List Applet in the Applets list.
8. In the Object Explorer, expand the Applet tree, expand the List tree, and then click List Column.
9. In the List Columns list, query the Name property for Status.
10. Set the HTML Icon Map property to Activity Status.

    This is the icon map you created in Step 3. For more information, see Using a Default Icon in an Icon Map.

11. Compile and test your changes.

    For more information, see Using Siebel Tools.

Using a Default Icon in an Icon Map

If you use icons to represent values in a field, then the Siebel Web Engine renders the image that the bitmap references if the field value matches one of the icons you define. If the field value does not match any of the icons you define, then the Siebel Web Engine renders the actual field value in text.

You can create an icon named Default in an icon map. If the field value does not match any of the icons, then Siebel CRM uses the Default icon to represent values in the field. This feature is useful to create an icon that Siebel CRM uses if a field might contain different values, such as URLs.

To use a default icon in an icon map

1. Create or locate an icon map that contains only one icon, named Default.

   For more information, see Example of Using Icons to Represent Values in a Field.

2. Define the control or list column using values from the following table.

   Property	Description
   HTML Type	Set to URL.
   HTML Icon Map	Set to an icon map that contains only one icon, named Default.