Using Icons to Represent Values in a Field

An icon map is an object that allows you to represent the values that Siebel CRM displays 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 the bitmap object that defines the image for the icon, and corresponds to a field value. The Icon Map property of a control or list column allows you to define the icon map that Siebel CRM uses to display 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.

If you must configure Siebel CRM to use a custom icon in a list applet, then you must size the icon according to the row font size that the list applet uses. 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 modify 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 Configuring 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 Configuring 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 must set the following properties:

   • Name. Set to the name of the field value.

   • Bitmap Category. Set to the bitmap category that you must use for the field value.

   • Bitmap. Set to the bitmap object that 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 step configures Siebel CRM to use the icon map that you created in Step 3. For more information, see Using a Default Icon in an Icon Map.

11. Compile and test your modifications.

    For more information, see Using Siebel Tools.