Bookshelf Home | Contents | Index | Search | PDF | ![]() ![]() ![]() ![]() |
Siebel Tools Reference > Business Objects Layer >
Multi-Value Links
The Multi Value Link object type is a child object type of the Business Component object type. A multi-value link implements a special use of the Link object type, which is the maintenance by the user of a list of records attached to a control or list column in an applet. The group of attached detail records is called a multi-value group.
An example of a multi-value group is the Account Addresses dialog box invoked from the Address Line 1 text box in the Account Entry Applet. This is illustrated in Figure 109 and Figure 110.
An account can have multiple addresses. These are stored in the Business Address business component. Clicking the Select button to the right of the Address text box brings up a dialog box. This dialog box lists the attached addresses, including the street address, city, state, and ZIP Code for each. It also provides the means for the user to add, delete or modify individual records.
In the Account Form Applet, the Address, City, State, Zip and Country text boxes display the values from the corresponding fields in the primary record in the Business Address business component. The primary record is indicated in the multi-value group applet with a checkmark in the list column labeled Primary. The user can select a different primary record by clicking the Primary list column in a different record.
The fields in the master business component (Account in the illustration) that are populated by the primary record in the multi-value group business component are called multi-value fields.
NOTE: If you want to query the originating applet for all master records that have a detail record with a specific field value you can only use Multi-value fields. See Siebel Developer's Reference for details.
Multi-value fields are populated with data from a record in the detail business component because of the multi-value link. Multi Value Link is a child object type of Business Component that defines a master-detail relationship (based on a link) to embed in the business component. These embedded master-detail relationships are used to expose fields from the detail business component as fields directly in the master business component.
NOTE: Most, but not all, multi-value links are set up to designate a primary record. Those that do not designate a primary use the first record retrieved from the detail business component. For more information, refer to Primary ID Field.
Bookshelf Home | Contents | Index | Search | PDF | ![]() ![]() ![]() ![]() |
Siebel Tools Reference, Version 7.5, Rev. A Published: 18 April 2003 |