Configuring Siebel Business Applications > Configuring Multi-Value Group, Association, and Shuttle Applets > Creating Multi-Value Groups and Multi-Value Group Applets >

How Siebel CRM Constructs a Multi-Value Group

Figure 74 illustrates the objects and properties that Siebel CRM uses to construct a multi-value group applet.

Figure 74. Objects and Properties Siebel CRM Uses to Construct a Multi-Value Group Applet

Siebel CRM uses the following objects to construct a multi-value group applet:

1. Originating applet. Contains the control or list column that calls the multi-value group applet. For more information, see Originating Applet of a Multi-Value Group.
2. Parent business component. Supplies data to the originating applet. For more information, see Parent Business Component of a Multi-Value Group.
3. Multi-value fields. Includes the fields that constitute a multi-value group. For more information, see About the Multi-Value Field.

   NOTE:  If the field is a multi-value field, then Siebel CRM ignores the Required. In this situation you can use a script in Siebel Visual Basic or Siebel eScript, or create a calculated field that references the multi-value field, and then make the calculated field required.

4. Multi-value link. Identifies the link that provides the field values from the child business component that the multi-value group references.
5. Link. Specifies the parent-child relationship between the parent business component and the child business component that the multi-value group applet references. To provide a way for the fields in the parent business component to obtain their values, the multi-value link references the link.
6. Multi-value group applet. A dialog box that Siebel CRM displays if the user clicks the ellipsis button in the originating applet. It lists the records of the child business component that the multi-value group references. It also provides the user a way add, edit, or delete a child record.
7. Child business component. Stores the child records. The records that Siebel CRM displays in the multi-value group applet are the records of the child business component that the multi-value group references. For more information, see Child Business Component of a Multi-Value Group.

Example of Objects Siebel CRM Uses to Construct a Multi-Value Group Applet

Table 57 describes some of the objects that Siebel CRM uses to construct a multi-value group applet for the Account Address Mvg Applet.

Originating Applet of a Multi-Value Group

The originating applet contains the control or list column that calls the multi-value group applet. The Business Component property of the originating applet identifies the parent business component. The originating control or list column is a child of the originating applet.

Table 58 describes the important properties of the originating control or list column.

Parent Business Component of a Multi-Value Group

The parent business component is the business component of the originating applet. Siebel CRM obtains the data values that are included in the originating field and other multi-value fields from corresponding fields in a record in the child business component that the multi-value group references. The primary is the record from which Siebel CRM obtains these values.

The parent business component does not include any properties that are required to define a multi-value group. However, the field and multi-value link child objects are significant.

The originating field is the field defined in the Field property of the originating control or list column. Other than the relationship with the originating control, the role of the originating field is identical to that of the other multi-value fields that share the multi-value link. For more information, see About the Multi-Value Field.

About the MVF Pick Map

You can use a pick map for a multi-value field similarly to how you use it for a single-value field. The MVF pick map is an object type that is a child of a multi-value field. Each pick map defines a relationship between a field in the child business component that the multi-value group references and one in the originating business component. If the user chooses a record, then these relationships provide the information that Siebel CRM requires to update the record in the parent business component with information from the multi-value group business component.

Table 59 describes important properties of the MVF pick map.

The State multi-value field of the Account business component is an example of how Siebel CRM uses the MVF pick map. The Account business component includes a multi-value link to the Business Address business component, where it obtains address information.

For more information, see About Multi-Value Links, and About Links.

Child Business Component of a Multi-Value Group

The child business component of a multi-value group stores the child records of the parent-child relationship with the parent business component. Siebel CRM derives the records that it displays in the multi-value group applet from the child business component. The child business component includes no important properties with respect to defining a multi-value group. It includes child field objects that Siebel CRM uses in the following ways:

• To store data for a field in the multi-value group. A list column in the multi-value group applet represents each field that fulfills this role. To supply data to a corresponding field in the parent business component, it might also participate in the multi-value link.
• To identify the primary record in the multi-value group. The primary field that is defined in the Primary Field Id property of the multi-value link identifies the primary records.

  NOTE:  The primary field is relevant to the parent business component, the multi-value link, and the multi-value group applet. The primary field has nothing to do with the child business component that the multi-value group references.

• As the destination field of the link. The field with this role is a foreign key to the parent business component.

For more information, see Activating a Multi-Value Field.