Working with Projects

You can edit each component of the project, including:

Project settings, such as the project classpath and sequence information
Database information, such as driver, URL, and login information
Table schema information for the database
Packages and classes associated with the project
Descriptor information for each class

The OracleAS TopLink Mapping Workbench displays projects and their contents in the Navigator pane. When you select a project, its attributes display in the Editor pane. The OracleAS TopLink Mapping Workbench can log runtime XML calls (in the mw_xml.log file) to help troubleshoot projects (see "General Preferences" on page 1-10 for more information).

Creating new Projects

Use this procedure to create a new OracleAS TopLink Mapping Workbench project.

To Create a New Project:

Description of the illustration creatbtn.gif

Click the Create New Project button on the toolbar. The Create New Project dialog box appears.

You can also create a new project by choosing File > New Project.

Figure 2-1 Create New Project

Description of the illustration create.gif
Enter the database name and platform for the new project and click OK. The Save As dialog box appears.

To select a different database, click Browse. See "Working with Databases" on page 3-1 for more information.
Select a location in which to save the project and click Save.

Note:
Always use a new folder to save a project. After creating the .mwp project, do not rename the file. See "Saving Projects" to save your project with a different name.

The OracleAS TopLink Mapping Workbench window appears, showing the project name in the Navigator pane. Continue with "Working with Project Properties".

Opening Existing Projects

Use this procedure to open an existing project.

Caution:

To upgrade from a previous version of OracleAS TopLink, you must follow specific upgrade procedures and use the Package Rename tool. Refer to the Oracle Application Server TopLink Release Notes and Oracle Application Server TopLink Getting Started Guide for more information.

To Open an Existing Project:

Description of the illustration openbtn.gif

Click the Open Project button on the toolbar. The Choose a File dialog box appears. You can also open a project by choosing File > Open Project from the menu.

Note:
The File > Reopen menu option contains a list of recently opened projects. You can select one of these projects to open.
Select the OracleAS TopLink Mapping Workbench project file ( .mwp) to open and click Open. The OracleAS TopLink Mapping Workbench displays the project information. If you open an OracleAS TopLink Mapping Workbench version 3.x project that contains EJBs, the Potential EJB Descriptors dialog box appears.

Figure 2-2 Potential EJB Descriptors

Description of the illustration potentl.gif
Select which of the descriptors should be imported as EJB descriptors, the project persistence type, and click OK.

You can also specify whether the OracleAS TopLink Mapping Workbench generates methods and attributes that comply with the EJB specification if they are not found within the current class descriptor(s).

Saving Projects

The OracleAS TopLink Mapping Workbench does not automatically save your project. Be sure to save your project often to avoid losing data.

To Save Your Project(s):

Save Selected Project button.
Description of the illustration savebtn.gif

Save All Projects button.
Description of the illustration saveall.gif

Click the Save Selected Project button or Save All Projects button to save your project(s). You can also save a project by choosing File > Save Project or File > Save All from the menu.

To Save Your Project with a Different Name or Location:

Choose File > Save As. The Save As dialog box appears.
Browse to the directory in which to save the project. In the File Name field, type the name of the project and click Save.

Caution:
Do not rename the .mwp file outside of the OracleAS TopLink Mapping Workbench; instead use the Save As option.

Refreshing the Navigator Pane

If the OracleAS TopLink Mapping Workbench interface becomes corrupt, use the Refresh Tree option to refresh the Navigator pane.

To Refresh the Navigator:

Choose File > Refresh from the menu, or press Ctrl+T.

Generating the Project Status Report

Use the Project Status Report to display a list of all warnings and errors in the OracleAS TopLink Mapping Workbench project. This report will quickly identify any incomplete mappings and indicate the project's current status.

To Generate the Status Report:

Choose Tools > Generate Project Status Report from the menu. The Project Status Report dialog box appears, displaying the status of each OracleAS TopLink Mapping Workbench project.

Figure 2-3 Project Status Report

Description of the illustration statrpt.gif

See "Error Messages" on page C-1 for information on each reported error.To copy the report to another application (such as a text editor or e-mail message), click Copy.