Using the TopLink Mappings Structure Window

When you select the Mapping Editor for an EJB or Java class, the Structure window displays the related TopLink descriptor and its mapping attributes in the Structure window. When working with sessions.xml file, the Structure window displays your sessions and session brokers. See "Using the Sessions Editor Structure Window" for more information.

Figure 1-4 Sample TopLink Mappings - Structure Window

This figure shows a sample Structure pane with
a TopLink descriptor and identifies the following items:
1. Structure pane toolbar
2. Descriptor
3. Mapped attribute
4. Unmapped attribute

Figure 1-4 identifies the following user-interface components:

TopLink Mappings Structure window toolbar (see "Using the TopLink Mappings Structure Toolbar" ).
TopLink descriptor
Mapped attribute
Unmapped attribute

When you select an item in the Navigator, its properties appear in the Mapping Editor.

You can perform specific functions for an item by selecting the item in the Navigator and:

Right-clicking the object and selecting the function from the pop-up menu.
Select the object the click a button in the Structure toolbar (see "Using the TopLink Mappings Structure Toolbar" ).

Inactive descriptors appear dimmed in the Structure window. Inactive descriptors are not registered with the session when the project is loaded into Java. This feature allows you to define and test subsets of descriptors. To activate or inactivate a descriptor, right-click the descriptor and select Activate Descriptor from the pop-up menu.

Figure 1-5 Sample Active/Inactive Descriptors

This figure shows active and inactive TopLink descriptors
in the Structure pane.
1. Inactive descriptor
2. Active descriptor

Figure 1-5 shows the following user-interface components.

Inactive descriptor
Active descriptor

Using the TopLink Mappings Structure Toolbar

The TopLink Mappings Structure window contains a toolbar that offers quick access to modify descriptors and mappings. This toolbar is context-sensitive; the actual buttons displayed will vary, depending on which element in the Structure window is selected.

Button	Description
	Automap
	Choose Descriptor Type
	Specify Advanced Properties
	Generate Mapping Status Report
	Choose Mapping Type
	Add/Remove Descriptors