83 Configuring an EIS One-to-One Mapping
This chapter describes the various components that you must configure in order to use an EIS one-to-one mapping.
This chapter includes the following sections:
For information on how to configure TopLink mappings options common to two or more mapping types, see Chapter 121, "Configuring a Mapping".
For information on how to create TopLink mappings, see Chapter 120, "Creating a Mapping".
Table 83-1 lists the configurable options for an EIS one-to-one mapping.
83.1 Introduction to EIS One-to-One Mapping Configuration
Table 83-1 lists the configurable options for an EIS one-to-one mapping.
Table 83-1 Configurable Options for EIS One-to-One Mappings
| Option to Configure | Oracle JDeveloper |
TopLink Workbench |
Java |
|---|---|---|---|
|
Reference descriptors (see Section 78.3, "Configuring Reference Descriptors") |
 |
|
|
|
Foreign key pairs (see Section 83.2, "Configuring Foreign Key Pairs") |
|
|
|
|
Bidirectional relationship (see Section 121.18, "Configuring Bidirectional Relationship") |
|
|
|
|
Method or direct field access at the mapping level (see Section 121.6, "Configuring Method or Direct Field Accessing at the Mapping Level") |
|
|
|
|
Read-only mappings (see Section 121.2, "Configuring Read-Only Mappings") |
|
|
|
|
Private or independent relationships (see Section 121.7, "Configuring Private or Independent Relationships") |
|
|
|
|
Indirection (lazy loading) (see Section 121.3, "Configuring Indirection (Lazy Loading)") |
|
|
|
|
Mapping comments (see Section 121.8, "Configuring Mapping Comments") |
|
|
 |
|
Selection interaction (see Section 78.4, "Configuring Selection Interaction") |
|
|
|
For more information, see the following:
83.2 Configuring Foreign Key Pairs
In a one-to-one EIS mapping, you relate a source object attribute to a target object attribute by specifying one or more pairs of source and target object fields.
In a one-to-one EIS mapping with key on source (see Section 77.7.1, "EIS One-to-One Mappings with Key on Source") using XML records, TopLink puts the target XML field value into the source object's record as a simple value.
In a one-to-one EIS mapping with key on target (see Section 77.7.2, "EIS One-to-One Mappings with Key on Target") using XML records, TopLink uses the source XML field value in the selection interaction to acquire the appropriate instance of target object.
83.2.1 How to Configure Foreign Key Pairs Using TopLink Workbench
To specify the source and target XML field pairs for a one-to-one EIS mapping, use this procedure:
-
Select the one-to-one EIS mapping in the Navigator. Its properties appear in the Editor.
-
Click the General tab. The General tab opens.
Figure 83-1 General Tab, Foreign Keys Field
Description of "Figure 83-1 General Tab, Foreign Keys Field"
-
Click Add in the Foreign Keys area to add a key pair. The Specify Field Pair dialog box appears.
Figure 83-2 Specify Field Pair Dialog Box
Description of "Figure 83-2 Specify Field Pair Dialog Box"
Click Browse to add a foreign key for the Source XPath and Target XPath fields.