Configuring Siebel Open UI > Customizing Styles, Applets, Fields, and Controls > Customizing Applets >

Customizing List Applets with Class Names

You can use class names at the record level to customize list applets. Using the Applet PM user property you can define a class name based on a condition that is evaluated for each row in the list applet. Before you begin to customize a list applet:

• Configure a calculated field in a business component to use for applying the class name. Make sure the calculation produces an appropriate value that can be evaluated to produce the desired effect. For example, if you want to apply the class name when the calculated value is 1, 2, or 3, make sure that your calculation can handle all possible values it may encounter and produces the desired result.
• If the calculated field is not exposed in the UI, expose it as a business component private field.
• Configure the Applet PM User Property as follows (assuming the calculated field is named Record State):
  • Name: Record State Field, Value: Record_State
  • For each possible value for Record_State, create a name-value pair
    • Name: <State1>, Value <Class1>
    • Name: <Staten>, Value <Classn>
• Configure the Applet PM User Property to include all of the previously configured name-value pairs:
  Name: ClientPMUserProp, Value: Record State Field, State1, State2, ... Staten

For example, you can make a row in a list applet appear in a specific color if the revenue column has a value greater than $500. The following procedure explains how to implement this customization.

To customize a list applet to display a row in color based on the value of a specific
column

1. Create a calculated field named "Record State" with the following calculated expression: [revenue > 500]
2. Expose the field as a Business Component Private field.
3. Configure the Presentation Model property as:
   1. Name: Record State field
   2. Value: Record State
4. For each expected value of the expression (in this example, true or false), add name-value pairs:
   1. Name: true
   2. Value: siebui-row-good-revenue
   3. Name: false
   4. Name: siebui-row-avg-revenue
5. Configure the properties to be exposed as Presentation Model properties:
   1. Name: ClientPMUserProp
   2. Value: Record State Field, true, false

      List applet rows having a revenue value greater than $500 have the siebui-row-good-revenue classname added. Rows that do not meet this criterion have the siebui-row-avg-revenue classname added. You can now add the a CSS definition to show the siebui-row-good-revenue rows in the spcified color if the revenue column has a value greater than $500.