Working with Workbench Preferences

General Preferences

Use the General preferences to customize the Òlook and feelÓ (the graphical user interface) of the OracleAS TopLink Mapping Workbench.

To Change the General Preferences:

1. 
   Description of the illustration prefbtn.gif
   
   

   Click the Preferences button on the toolbar. The Preferences dialog appears.

   You can also display the Preferences dialog box by choosing Tools > Preferences from the menu.

2. Select General in the Category pane.

   Figure 1-7 General Preferences

   
   Description of the illustration prefgen.gif
   
   

3. Use this table to enter data in each field and click OK.

   Field	Description
   Text Editor	Click Browse and select a text editor (used when viewing the session configuration source). See "Working with the Source" on page 8-18 for more information. Note: This field appears for the OracleAS TopLink Sessions Editor only.
   Look and Feel	Select the Òlook and feelÓ to use for the OracleAS TopLink Mapping Workbench. See Figure 1–8 for a sample of each option.
   Size of Recently Opened Documents List	Select the number of projects to maintain in the File > Reopen option. See "Opening Existing Projects" on page 2-2 for more information.
   Log Unit of Work Messages and SQL	Specify if the OracleAS TopLink Mapping Workbench logs runtime messages to help troubleshoot projects. Click Browse to select a filename (default mw_xml.txt) and Location.

   
   

You must restart the OracleAS TopLink Mapping Workbench to apply the changes.

Figure 1-8 Look and Feel Samples

Description of the illustration lfsamples.gif

Figure 1–8 shows the following Òlook and feelÓ samples:

• Oracle

• Windows

• Metal (Java)

• CDE/Motif

Warning and Confirmation Preferences

Use the Warnings preferences to specify if the OracleAS TopLink Mapping Workbench displays certain warning and confirmation dialog boxes.

To Specify Warnings Preferences:

1. 
   Description of the illustration prefbtn.gif
   
   Click the Preferences button on the toolbar. The Preferences dialog box appears.

   You can also display the Preferences dialog box by choosing Tools > Preferences from the menu.

2. Select Warning in the Category pane.

   Figure 1-9 Warning Preferences

   
   Description of the illustration prefwarn.gif
   
   

3. Use this table to enter data in each field and click OK.

   Field	Description
   Show All Warning and Confirmation Dialogs	Specify which (if any) of the following confirmation and warning messages are displayed.
   Descriptors Without an Associated Table	Specify if the OracleAS TopLink Mapping Workbench displays a warning message if you attempt to create a table reference before defining the descriptor's associated table.
   Direct Mappings Without a Database Field	Specify if the OracleAS TopLink Mapping Workbench displays a warning message if you attempt to create a table reference for a direct collection mapping before mapping's direct field and target table.
   Mappings Without a Reference Descriptor	Specify if the OracleAS TopLink Mapping Workbench displays a warning message if you attempt to create a mapping before defining a reference descriptor.
   Aggregate Descriptors Without Mapped Attributes	Specify if the OracleAS TopLink Mapping Workbench displays a warning message if you attempt to create field references for an aggregate mapping before mapping the aggregate descriptor's attributes.
   Mappings Without a Relation Table	Specify if the OracleAS TopLink Mapping Workbench displays a warning message if you attempt to create a table reference for a many-to-many mapping before defining the mapping's relation table.
   Define Reference Descriptor First	Specify if the OracleAS TopLink Mapping Workbench displays a warning message if you attempt to create a table reference before defining the mapping's reference descriptor.
   Invalid or Incomplete Data	Specify if the OracleAS TopLink Sessions Editor displays a warning message if your session configuration contains invalid or incomplete data.

   
   

Class Preferences

Use this procedure to specify how the OracleAS TopLink Mapping Workbench imports and edits classes. See "Working with Classes" on page 2-13 for more information.

To Specify Class Import Options:

1. 
   Description of the illustration prefbtn.gif
   
   Click the Preferences button on the toolbar. The Preferences dialog box appears.

   You can also display the Preferences dialog box by choosing Tools > Preferences from the menu.

2. Select Class in the Category pane.

3. Click the Importing Classes tab.

Figure 1-10 Class Preferences — Importing Classes

Description of the illustration prefclas.gif

1. Select Never Verify Classes in Chooser if you do not want to verify the classes when performing an Add or Refresh.

   
   

   Caution: By default, the OracleAS TopLink Mapping Workbench always verifies the classes. Select this option only if you encounter errors when displaying classes in the Select Classes dialog box.

   
   

2. Click the Editing Classes tab.

   Figure 1-11 Class Preferences — Editing Classes

   
   Description of the illustration prefedcl.gif
   
   

3. Specify how the OracleAS TopLink Mapping Workbench maintains classes when renaming or editing a zero-argument constructor.

4. Click OK.

EJB Preferences

Use this procedure to specify how the OracleAS TopLink Mapping Workbench updates the ejb-jar.xml file when saving projects.

To Specify EJB Preferences:

1. 
   Description of the illustration prefbtn.gif
   
   Click the Preferences button on the toolbar. The Preferences dialog box appears.

   You can also display the Preferences dialog box by choosing Tools > Preferences from the menu.

2. Select EJB in the Category pane.

   Figure 1-12 EJB Preferences

   
   Description of the illustration prefejb.gif
   
   

3. Specify whether the OracleAS TopLink Mapping Workbench prompts before updating the ejb-jar.xml file when you save the project.

4. Click OK.

Database Preferences

Use the Database preferences to specify custom database divers and connection URLs for the OracleAS TopLink Mapping Workbench. These drivers and URLs can then be used when defining database logins.

To Specify Database Preferences:

1. 
   Description of the illustration prefbtn.gif
   
   Click the Preferences button on the toolbar. The Preferences dialog appears.

   You can also display the Preferences dialog box by choosing Tools > Preferences from the menu.

2. Select Database in the Category pane.

   Figure 1-13 Database Preferences

   
   Description of the illustration preflogi.gif
   
   

3. Use this table to enter data in each field and click OK.

   Field	Description
   Database Drivers	Click Add to add a custom database driver.
   Connection URLs	Select a Database Driver, then click Add to add a custom database connection URL.

   
   

To edit or remove an existing driver or URL, select the driver or URL and click Remove or Edit.

Help Preferences

Use the Help preferences to select a Web browser to use the online help and Web-based support.

To Specify the Help Preferences:

1. 
   Description of the illustration prefbtn.gif
   
   Click the Preferences button on the toolbar. The Preferences dialog box appears.

   You can also display the Preferences dialog box by choosing Tools > Preferences from the menu.

2. Select Help in the Category pane.

   Figure 1-14 Help Preferences

   
   Description of the illustration prefhelp.gif
   
   

3. Use this table to enter data in each field and click OK.

   Field	Description
   Web Browser	Click Browse and select the location of your default Web browser. You must specify a Web browser to use the online help and Web-based support.