Bookshelf Home | Contents | Index | Search | PDF |
Siebel Tools Reference > Multi-Value Group and Association Applets > Association Applets >
Association Applets Invoked from Multi-Value Group Applets
Figure 190 illustrates an association applet invoked from a multi-value group applet. Figure 191 shows the dialog box that appears when you click the New button. Figure 192 shows the dialog box that appears when you click the Add button.
The applet in the upper section of the view shown in Figure 190 is an Account form applet, which is used in various views to display a single record of account information at the top of the view. Five of the fields in this applet display multi-value fields: Sales Team, Organizations, Territories, and Account. Each of these text boxes has a check mark button that invokes a specific multi-value group applet when clicked.
Some multi-value-group applets add and remove records without the use of an association applet. Such applets are based on a one-to-many relationship between the master and detail business components, and no intersection table is involved. The Account Address MVG applet (invoked from the Address text box in the Account form applet) is that kind of multi-value group applet. You can confirm that no association applet is involved by examining the value in the Associate Applet property in the multi-value group applet's object definition, which is blank in this case.
Other multi-value group applets are based on a many-to-many relationship implemented through an intersection table. The user may either create or associate records. This requires that an association applet be invoked when the New button in the multi-value group applet is clicked. The Industry Mfg applet, invoked from the Industries text box, is of this type. The name of an association applet (Industry Assoc applet) appears in the Associate Applet property in the multi-value group applet's object definition.
In Figure 190, the user has clicked the ellipsis button to the right of the Industries text box, and the Add Industries dialog box has appeared. The Add Industries dialog box (association applet) allows the user to add an existing industry record to the multi-value group, or to create a new industry record in the multi-value group. A new Industry record is created by clicking the New button, and entering data into the new record in the Add Industries dialog box.
The Add Industries dialog box is implemented as an association applet called Industry Assoc applet. The details of the object relationships are shown in Figure 193.
The roles of the object definitions in Figure 193 are the following:
- Form applet (Account Form applet). Contains one or more text box controls displaying multi-value fields. The MVG Applet property for each of these text box controls identifies a multi-value group applet that is invoked when the user clicks the ellipsis button to the right of the text box.
- Multi-value group applet (Industry Mfg. applet). Displays the list of records assigned to the multi-value field in the form applet. The Associate Applet property in the multi-value group applet's object definition identifies the association applet to invoke when the user clicks the New button in the multi-value group applet.
- Multi-Value Group business component (Industry). Stores the (detail) multi-value group records for each master business component record. The multi-value group business component supplies records to both the multi-value group applet and the association applet.
- Association applet (Industry Assoc applet). Implements the dialog box that appears when the user attempts to add or insert a record in the multi-value group applet. The association applet has a Type property value of Association List, which indicates that it is an association applet. It has a Class property value of CSSFrameList, indicating that it is a list applet. The association applet is configured as a standard list applet, with a List child object definition that has List Object child object definitions.
The child object definitions for the association applet are described in greater detail at the end of Association Applets Invoked from Master-Detail Views. Typically Association applets are based on the same business component as multi-value group applets.
Bookshelf Home | Contents | Index | Search | PDF |
Siebel Tools Reference, Version 7.5, Rev. A Published: 18 April 2003 |