Creating a New Project

OracleAS TopLink Mapping Workbench stores project information in the .mwp file and associated folders. Always start an OracleAS TopLink Mapping Workbench project in a new folder.

To create a new project:

Start OracleAS TopLink Mapping Workbench. From the Windows Start menu, select Programs > OracleAS TopLink > Mapping Workbench.

The splash screen appears, followed by the OracleAS TopLink Mapping Workbench window.

Figure B-2 OracleAS TopLink Mapping Workbench

Description of the illustration mwblank.gif
Description of the illustration newprjt.gif

Click the New Project button on the toolbar or select File > New Project from the menu. The Create a New Project dialog box appears.

Figure B-3 Create New Project

Description of the illustration create.gif
From the Create New Project dialog box:
- In the Database Name field, type INTRO_TUTORIAL_DB.
- In the Platform field, click Browse button and select the appropriate database platform. Contact your database administrator if you need additional information.
Click OK. The Save As dialog box appears.

Figure B-4 Save As

Description of the illustration saveas.gif
Select the folder in which to save the Employee project.

Note:
Always use a new folder to save a project.
In the File Name field, type Employee.mwp.
Click Save to save your work and return to the OracleAS TopLink Mapping Workbench window.

Figure B-5 OracleAS TopLink Mapping Workbench

Description of the illustration mwnew.gif
Description of the illustration savebtn.gif

Click Save on the toolbar or select File > Save to save the project.

Note:
OracleAS TopLink Mapping Workbench does not automatically save your work; remember to save periodically.

Setting the Project's Classpath

Each OracleAS TopLink project uses a classpath—a set of directories, .jar files, and .zip files—when importing Java classes and defining object types. In this tutorial, you will use information from the OracleAS TopLink three tier example project. Refer to <ORACLE_HOME>\toplink\doc\examples.htm for complete information.

In the OracleAS TopLink Mapping Workbench, highlight the Employee project in the Navigator pane.
In the Editor pane on the right-hand side of the OracleAS TopLink Mapping Workbench window, click the General tab.

Figure B-6 General Tab

Description of the illustration general.gif
Click Add Entries. The Add Entry dialog box appears.

Figure B-7 Add Entries

Description of the illustration empclsen.gif
Browse to the <ORACLE_HOME>\toplink\examples\foundation\threetier\stage directory and click OK.

Note:
If the stage directory does not exist, you must create the OracleAS TopLink Three Tier example project. See "Before You Begin" for more information.

Figure B-8 General Tab with Classpath Information

Description of the illustration generlzip.gif
Description of the illustration savebtn.gif

Click Save on the toolbar or choose File > Save to save the project.