Working With Projects

Using TopLink Workbench, you can perform the following project functions:

• Opening Existing Projects

• Saving Projects

• Generating the Project Status Report

See Chapter 22, "Configuring a Project" for additional information on working with TopLink Workbench projects.

Opening Existing Projects

Use this procedure to open an existing project:

Caution: For most prior release projects, simply opening the project in TopLink Workbench will upgrade your project. However, to upgrade release 9.0.3 (and earlier) projects, you must follow specific upgrade procedures and use the Package Rename tool. Refer to Oracle TopLink Release Notes and Oracle TopLink Getting Started Guide for more information.

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

   
   

   Note: The File menu option contains a list of recently opened projects. You can select one of these projects to open. See "General Preferences" for information on customizing this list.

   
   

2. Select the TopLink Workbench project file ( .mwp) to open, and click Open. TopLink Workbench displays the project information.

   If you open a TopLink Workbench version 3.n project that contains EJB information, the Potential EJB Descriptors dialog box appears.

   Figure 21-3 Potential EJB Descriptors Dialog Box

   
   

3. Select which of the descriptors should be imported as EJB descriptors, the project persistence type, and click OK.

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

If you open a TopLink Workbench version 9.0.3 (or later) project, the Create New TopLink Workbench Project from Previous Version dialog box appears.

Figure 21-4 Create New TopLink Workbench Project From Previous Version Dialog Box

Description of "Figure 21-4 Create New TopLink Workbench Project From Previous Version Dialog Box"

To convert the old project to the current format and view the project immediately, click Save Later.

To convert the old project to the current format and save it to a new location and then view the project, click Save Now.

Saving Projects

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

To save your project(s), use this procedure:

1. 
   
   Click Save or Save All to save your project(s).

   You can also save a project by choosing File > Save or File > Save All from the menu.

2. If you close TopLink Workbench while there are currently unsaved changes, the Save Project dialog box appears.

   Figure 21-5 Save Projects Dialog Box

   
   

3. Select the project(s) to save and click OK.

   Click Select All to select all the available projects.

Saving Projects With a New Name or Location

To save your project with a different name or location, use this procedure:

1. 
   Choose File > Save As. The Save As dialog box appears.

   Figure 21-6 Save As Dialog Box

   
   

2. Select a name and location, then click Save.

Caution: Do not rename the .mwp file outside of TopLink Workbench. To rename a project, use the Save As option.

Generating the Project Status Report

Use the project status report to display a list of all warnings and errors in the TopLink Workbench project. This report is similar to the Problems window (see "Working With TopLink Workbench"), but lets you easily copy and paste the errors into documents or messages. To generate the project status report, use this procedure:

1. 
   Right-click the Problems label above the Problems window and select Problem Report. The Project Status Report dialog box appears, displaying the status of each TopLink Workbench project.

   You can also generate the project status report by selecting Tools > Problem Report from the menu.

   Figure 21-7 Project Status Report Dialog Box

   
   Description of "Figure 21-7 Project Status Report Dialog Box"
   
   

See Chapter 14, "TopLink Workbench Error Reference" for information on each reported error.

To copy the report to another application, click Copy.