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

Reference descriptors (see Section 78.3, "Configuring Reference Descriptors")

Supported Supported Supported

Foreign key pairs (see Section 83.2, "Configuring Foreign Key Pairs")

Supported Supported Supported

Bidirectional relationship (see Section 121.18, "Configuring Bidirectional Relationship")

Supported Supported Supported

Method or direct field access at the mapping level (see Section 121.6, "Configuring Method or Direct Field Accessing at the Mapping Level")

Supported Supported Supported

Read-only mappings (see Section 121.2, "Configuring Read-Only Mappings")

Supported Supported Supported

Private or independent relationships (see Section 121.7, "Configuring Private or Independent Relationships")

Supported Supported Supported

Indirection (lazy loading) (see Section 121.3, "Configuring Indirection (Lazy Loading)")

Supported Supported Supported

Mapping comments (see Section 121.8, "Configuring Mapping Comments")

Supported Supported Supported

Selection interaction (see Section 78.4, "Configuring Selection Interaction")

Supported Supported Supported

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:

  1. Select the one-to-one EIS mapping in the Navigator. Its properties appear in the Editor.

  2. Click the General tab. The General tab opens.

    Figure 83-1 General Tab, Foreign Keys Field

    Description of Figure 83-1 follows
    Description of "Figure 83-1 General Tab, Foreign Keys Field"

  3. 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 follows
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.