Oracle® Application Server TopLink Mapping Workbench User's Guide
10g Release 2 (10.1.2) Part No. B15900-01 |
|
Previous |
Next |
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).
Use this procedure to create a new OracleAS TopLink Mapping Workbench 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.
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".
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. |
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.
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.
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).
The OracleAS TopLink Mapping Workbench does not automatically save your project. Be sure to save your project often to avoid losing data.
Description of the illustration savebtn.gif
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.
If the OracleAS TopLink Mapping Workbench interface becomes corrupt, use the Refresh Tree option to refresh the Navigator pane.
Choose File > Refresh from the menu, or press Ctrl+T.
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.
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.