Essentials (Siebel 7.
7)
Module 31: Configuring Multi-
Value Groups
Module Objectives
After completing this module you will be able to:
Describe multi-value groups and their benefits
Use Siebel Tools to configure a multi-value field and multi-
value link
Use Siebel Tools to configure a multi-value group so that
users may select one or more related child records
Why you need to know:
Enables you to incorporate child data directly in an applet
More child data can be available within a view
More effective use of screen space
Module 31: Configuring Multi-Value Groups 2 of 24
Multi-Value Group
A multi-value group (MVG) is a set of detail (child) records
associated with a parent record
Parent applet displays only one of the child records
Multi-value group applet opens on demand to display all child
records
Module 31: Configuring Multi-Value Groups 3 of 24
Multi-Value Group Continued
Is an alternative to a detail view for managing parent and related
child records
Makes effective use of space
Does not require dedicated space on a view
Allows for multiple sets for detail records to be available from a
single view
Territory
MVG
Business Address Account Industries
MVG Team MVG MVG
Module 31: Configuring Multi-Value Groups 4 of 24
Multi-Value Group Continued
Allows users to access child records for multiple parent records
using a single view
Business Address Territory Industries
MVG MVG MVG
Module 31: Configuring Multi-Value Groups 5 of 24
Multi-Value Group Continued
Allows for creating queries that include values for fields in both
parent and child records
Query on
Organization
Query on
Industries
Query on
Territory
Module 31: Configuring Multi-Value Groups 6 of 24
Multi-Value Field (MVF)
Is a field in the parent business component that references a
field in the child business component (not a column in a table)
Is required for an MVG
Single-value field Multi-value field Parent business Child business
component component
Account
Name Location City
S_ORG_EXT Business Address
City Street Address
LOC
EMP_COUNT
ROW_ID
NAME
Module 31: Configuring Multi-Value Groups 7 of 24
Link
Must exist between parent and
child business components in
the MVG
Specifies how child records
are related to a parent record
Parent business
component
Account
Name Location City
Child business
component
Business Address
City Street Address
Module 31: Configuring Multi-Value Groups 8 of 24
0/5
Creating a Multi-Value Group
1. Specify the Multi-Value Link
2. Add Multi-Value Fields
3. Identify or Create an MVG Applet
4. Enable User to Invoke MVG Applet
5. Enable Primaries to Improve Performance
Module 31: Configuring Multi-Value Groups 9 of 24
1/5
1. Specify the Multi-Value Link (MVL)
Create a Multi-Value Link object definition
Child object definition of the business component that specifies
how to retrieve the records for a multi-value field
Based on an existing link definition that specifies how the parent
and child business components are related
Set Destination
Business Component
Module 31: Configuring Multi-Value Groups 10 of 24
2/5
2. Add Multi-Value Fields
Create a Multi-Value Field object definition for each field in the
child business component to be added to parent business
component
Uses the multivalue link
Field in Parent BC Multivalue link Field in Child BC
Module 31: Configuring Multi-Value Groups 11 of 24
3/5
3. Identify or Create an MVG Applet
Identify an existing MVG applet to display records from the child
business component
Search for applets of Type MVG that reference the child
component
Verify that the applet displays enough list columns to allow the
user to distinguish the desired record
Can display more columns than are displayed on the parent applet
Module 31: Configuring Multi-Value Groups 12 of 24
3/5
3. Identify or Create an MVG Applet Continued
If a suitable MVG applet does not exist, create a new one
Copy an existing MVG applet
Copies all controls required for MVG applet
Set the Business Component property to reference the child
business component
Edit list columns as required
MVG applet
controls
Module 31: Configuring Multi-Value Groups 13 of 24
4/5
4. Enable User to Invoke the MVG Applet
Identify the list column or control that references the multi-value
field
Set the MVG Applet property to the corresponding MVG applet
Set Runtime property to TRUE
Specify Field the Set MVG Set Runtime
control displays Applet to TRUE
Module 31: Configuring Multi-Value Groups 14 of 24
5/5
5. Enable Primaries to Improve Performance
A primary refers to a designated child record
Add a primary foreign key field in the parent business
component to reference the primary foreign key column
Set the Primary Id Field and Use Primary Join properties in the
MVL
Module 31: Configuring Multi-Value Groups 15 of 24
5/5
5. Enable Primaries to Improve Performance Continued
The Siebel Data Model includes primary foreign keys for many
relationships
Begin with PR_
To find a primary foreign key (PFK):
Scan the columns in the main table for parent
Select the column with the desired Foreign Key Table (main table
for child)
Expose this column as a single-value field in the parent
business component
S_ORG_EXT S_ADDR_ORG
ROW_ID
ADDR
CITY
OU_ID
ROW_ID
NAME
LOC
PR_ADDR_ID
PFK FK
Module 31: Configuring Multi-Value Groups 16 of 24
5/5
5. Enable Primaries to Improve Performance Continued
Set the Auto Primary property in the MVL to Default
Sets the first record as the primary
Add a List Column displaying the SSA Primary Field to the MVG
applet
SSA Primary Field is a special field that permits the user to see
and change the primary child record
Module 31: Configuring Multi-Value Groups 17 of 24
Creating a New MVG
Verify that a link between the parent and child business
components exists
Use the MVG wizard to choose the child BC and construct the
MVL and the MVFs
Select the link to be used in the MVF
Select one or more fields in the child BC and create MVFs
Module 31: Configuring Multi-Value Groups 18 of 24
Displaying MVGs
To display the child records:
Use an existing MVG applet for the child business component
Copy an existing MVG applet and edit as required
Create a new applet using the MVG Applet wizard
Modify the parent applet to display the new MVFs
Set Runtime to TRUE for new list columns or controls
Set the MVG Applet property
MVF wizard invokes
automatically
Module 31: Configuring Multi-Value Groups 19 of 24
Multi-Value Groups for M:M Relationships
MVGs can be built on M:M relationships as well
Link must specify the Inter Table property
Parent BC
Account
Name Location Industry
Child BC
Multi-value Industry
field Name SIC Code
Industry MVG
applet
Module 31: Configuring Multi-Value Groups 20 of 24
Configuring MVGs for M:M Relationships
Create object definitions required for 1:M MVGs
Specify an association applet for the MVG applet
Allows users to select other child records to add to the MVG
Module 31: Configuring Multi-Value Groups 21 of 24
Configuring MVGs for M:M Relationships Continued
Association applet provides a list of available child records to
add to 1:M MVGs
Specify an available child record and add it to the selected list
for display in the MVG
Module 31: Configuring Multi-Value Groups 22 of 24
Summary
This module showed you how to:
Describe multi-value groups and their benefits
Use Siebel Tools to configure a multi-value field and multi-
value link
Use Siebel Tools to configure a multi-value group so that
users may select one or more related child records
Module 31: Configuring Multi-Value Groups 23 of 24
Lab
In the lab you will:
Create a new MVG
Create an MVG applet to display the MVG
Module 31: Configuring Multi-Value Groups 24 of 24