TOC Special:Whatlinkshere_Configuring_an_EIS_One-to-Many_Mapping_(ELUG)[Related Topics]
For information on how to create EclipseLink mappings, see Creating a Mapping.
This table lists the configurable options for an EIS one-to-many mapping.
[Table 80-1]#
Option to Configure
Workbench
Java
Reference descriptors
Foreign key pairs
Bidirectional relationship
Method or direct field access at the mapping level
Read-only mappings
Private or independent relationships
Indirection (lazy loading)
Container policy
Mapping comments
Selection interaction
Delete all interactions
For more information, see the following:
In a one-to-many 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-many EIS mapping with key on source (see EIS One-to-Many Mappings with Key on Source) using XML records, EclipseLink puts the target XML field value into the source object’s record as a simple value. By default, these values are not grouped, as this example shows.
[Example 80-1]# Source Object XML Record without Grouping
Jane
3 `
4`
If you specify more than one source and target XML field pair, you must specify a grouping element, as this example shows.
[Example 80-2]# Source Object XML Record with Grouping
`
Jane`
3
Project 3
4
Project 4
In a one-to-one EIS mapping with key on target (see EIS One-to-Many Mappings with Key on Target) using XML records, EclipseLink uses the source XML field value in the selection interaction to acquire the appropriate instances of target object.
To specify the source and target XML field pairs for a one-to-many EIS mapping, use this procedure:
Use the following information to complete the Foreign Keys fields on the General tab:
Field
Description
Foreign Keys Located On Target
Select if you are creating a one-to-many EIS mapping with key on target (see EIS One-to-Many Mappings with Key on Target).
Foreign Keys Located On Source
Select if you are creating a one-to-many EIS mapping with key on source (see EIS One-to-Many Mappings with Key on Source).
Grouping Element
Specify the element in which foreign key pairs are grouped in the source object’s EIS record. If you specify only one pair of source and target XML fields, this is optional.
If you specify more than one pair of source and target XML fields, this is required.
Field Pairs
Click Add to add a pair of source and target XML fields. Specify Field Pair dialog box opens. Click Browse to add a foreign key for the Source XPath and Target XPath fields.
The EclipseLink query and expression framework supports delete all queries. If your JCA adapter provides access to an EIS Delete All function, you can configure a delete all interaction to support EclipseLink delete all queries.
To specify the DeleteAll interaction for an EIS one-to-many mapping, use this procedure:
Use the following information to enter data in each field on the Delete All Interaction 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 JCA 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 |
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
|
Input Result Path |
Use this option if the EIS interaction expects the
interaction arguments to be nested in the XML record. For example,
specify |
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 |
Category:_EclipseLink_User’s_Guide[Category: EclipseLink User’s Guide] Category:_Release_1[Category: Release 1] Category:_Task[Category: Task] Category:_EIS[Category: EIS]