Configuring Siebel Business Applications > Configuring the Customer Dashboard > Process of Configuring the Customer Dashboard >

Mapping a Business Component Field to a Customer Dashboard Field

This task is a step in the Process of Configuring the Customer Dashboard.

A customer dashboard field is a field that Siebel CRM displays in the Customer Dashboard. To create this field, you define a business service user property for the Persistent Customer Dashboard business service. You define the following properties for this business service user property:

• Name. Identifies the name of the Customer Dashboard field. For example, Field 1.
• Value. Identifies the business component list and a field from the business component list.

Siebel CRM predefines the following field names for the Customer Dashboard:

• Field 1.
• Field 2.
• Field 3.
• Field 4. Formatted to display a phone number.
• Field 5.
• Field 10.
• Field 12.

To map a business component field to a customer dashboard field

1. In the Object Explorer, click Business Service.
2. In the Business Services list, locate the Persistent Customer Dashboard business service.
3. In the Object Explorer, expand the Business Service tree, and then click Business Service User Prop.
4. In the Business Service User Props list, add a user property using values from the following table.

   Property	Description
   Name	Enter a name for this business service user property that represents the customer dashboard field. Use the following format: Field integer where: integer is a number. For example: Field 1
   Value	You must use the following format: name of the business component list.position where: position is the position of the business component field in the business component list. Consider the following examples from Table 78: Assume you must reference the Last Name field of the Contact business component. This field is the first field that is included in the Value property for the List 1 business component list. You use the following format: List 1.1 Assume you must reference the First Name field of the Contact business component. This field is the second field that is included in the Value property for the List 1 business component list. You use the following format: List 1.2

Configuring a Customer Dashboard Field to Display Data According to Context

You can display data from fields from more than one business component in a single customer dashboard field. To do this, you define multiple values in the Value property of a business service user property for the Persistent Customer Dashboard business service.

The Customer Dashboard business service searches through the list of user properties, starting with Field, and looks for fields that Siebel CRM maps to the Customer Dashboard from the current business component.

If you create a new Customer Dashboard field, then make sure to include a member from every business component list. If you do not do this, then the Customer Dashboard might retain data from the previous business component when Siebel CRM updates the dashboard.

To configure a customer dashboard field to display data according to context

1. In Siebel Tools, in the Object Explorer, click Business Service.
2. In the Business Services list, locate the Persistent Customer Dashboard business service.
3. In the Object Explorer, expand the Business Service tree, and then click Business Service User Prop.
4. In the Business Service User Props list, add a user property using values from the following table.

   Property	Description
   Name	Enter a name for this business service user property that represents the customer dashboard field. For example: Field 1
   Value	Reference each field from each business component list. You must use the following format: name of the business component list.position;name of the business component list.position where: position is the position of the business component field in the business component list. For example, using the business component lists described in Table 78, assume you must display the following information: If the Customer Dashboard is in the Contacts context, then the Field 1 customer dashboard field must display the Last Name of the contact. If the Customer Dashboard is in the Opportunities context, then the Field 1 customer dashboard field must display the Opportunity Name. You use the following code to implement this example: List 1.1;List 2.1 List 1.1 represents the first field of List 1. List 2.1 represents the first field of List 2.

Example of Configuring a Customer Dashboard Field to Display Data According to Context

Assume the Contact business component is active. The Persistent Customer Dashboard business service does the following:

• Locates business service user properties with Field in the Name property.
• If a Field business service user property references the Contact business component, then Siebel CRM displays data from the business component field.
• If a Field business service user property does not reference the Contact business component, then Siebel CRM does nothing and the Customer Dashboard field remains empty.
• If a Field business service user property references the Opportunity business component, and if the Opportunity business component is active, then Siebel CRM displays data from the Opportunity business component field.