Skip Headers

Oracle TopLink Developer's Guide 10g Release 3 (10.1.3) B13593-01 |
| Home | Solution Area | Contents | Index

Previous | Next |

# Configuring Selection Interaction

In EIS mappings that extend `oracle.toplink.mappings.ForeignReferenceMapping` class, TopLink uses a selection interaction to acquire the instance of the target object to which the mapping refers.

By default, TopLink uses the read interaction you define for the mapping's reference descriptor (see "Configuring Reference Descriptors"). In most cases, this interaction is sufficient. If the reference descriptor's read interaction is not sufficient, you can define a separate interaction.

Table 57-4 summarizes which EIS mappings support this option.

Table 57-4 Mapping Support for Selection Interaction

Mapping | Using TopLink Workbench | Using Java
--- | --- | ---
EIS Direct Mapping |  |
EIS Composite Direct Collection Mapping |  |
EIS One-to-One Mapping |  |
EIS One-to-Many Mapping |  |
EIS Composite Object Mapping |  |
EIS Composite Collection Mapping |  |
EIS Transformation Mapping |  |

For more information about how TopLink uses the selection criteria, see "Reference EIS Mappings".

## Using TopLink Workbench

To specify the selection interaction (such as Read Object) for the EIS mapping, use this procedure:

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

2. Click the Selection Interaction tab. The Selection Interaction tab appears.

   Figure 57-2 Selection Interaction Tab

   Description of "Figure 57-2 Selection Interaction Tab"

Use the following information to enter data in each field on the tab:

Field | Description
--- | ---
Function Name | The name of the EIS function that this call type (Read Object or Read All) invokes on the EIS.
Input Record Name | The name passed to the J2C adapter when creating the input record.
Input Root Element Name | The root element name to use for the input DOM.
Input Arguments | The query argument name to map to the interaction field or XPath nodes in the argument record. For example, if you are using XML records, use this option to map input argument `name` to the XPath `name/first-name`.
Output Arguments | The result record field or XPath nodes to map to the correct nodes in the record used by the descriptor's mappings. For example, if you are using XML records, use this option to map the output `fname` to `name/first-name`. Output arguments are not required if the interaction returns an XML result that matches the descriptor's mappings.
Input Result Path | Use this option if the EIS interaction expects the interaction arguments to be nested in the XML record. For example, specify `arguments`, if the arguments were to be nested under the root element `exec-find-order`, then under an `arguments` element.
Output Result Path | The name of the EIS function that this call type (Read Object or Read All) invokes on the EIS.
Properties | Any properties required by your EIS platform. For example, property name `operation` (from `AQPlatform.QUEUE_OPERATION`) and property value `enqueue` (from `AQPlatform.ENQUEUE`).