Prev Next

Create a Project in an Oracle Database

To create a project in a Oracle repository, you work through these stages:

  • Stage 1: Create a database user to own the Enterprise Architect tables
  • Stage 2: Setup up a connection to the repository
  • Stage 3: Load initial data

Prerequisites

  • A machine with Oracle 9i or higher installed and running
  • Oracle Client installed on the client machine; if you are not using the Native Connection, please ensure that the OLE DB drivers are installed (you can download the drivers from the Oracle Technology Network web site, as part of the Oracle Data Access Components (ODAC) package; see Learn more)

1. Create Database Repository

Step

Action

See also

1.1

Create a Oracle database user to own the Enterprise Architect table and configure it to your preferences, making sure to configure the correct character set and collation. The exact method you use to create the database is not important to this discussion, therefore use the most convenient or familiar method.

1.2

Open your SQL management console of choice (such as Oracle SQL Developer) and connect to the new Enterprise Architect repository.

1.3

Download  EASchema_1558_Oracle.sql file from the Sparx Systems website and open it in your SQL management console.

1.4

Run EASchema_1558_Oracle.sql to create the required database tables.

2. Set up Connection to Oracle repository

From Enterprise Architect version 16 there is now a third ways that Enterprise Architect can connect to Oracle repositories:

Note: Sparx Systems recommend Native connections as they are much simpler and don't require any other software installed or configured.

3. Load Initial Data

Enterprise Architect repositories require a basic amount of reference data to function correctly.

You can set up this initial data in one of two different ways:

  • Transfer the entire contents of an existing model into the new database, or
  • Run initial data SQL Script

3.1 Load Initial Data - Transfer Existing Model

If you choose to set up your new database with the contents of an existing model then Sparx Systems recommend that a Project Integrity check is performed on the existing model to ensure it is 'clean' and free from data-related errors before being copied into the new database.

The Enterprise Architect installation provides a model called EABase.qea, which is copied into the installation folder specifically for the purpose of providing basic data for a new model. However, if you have customized the various drop-down lists in another model then you might prefer to use that. Regardless of what model you choose to use, the process is the same and is outlined here.

Step

Action

See also

3.1.1

In Enterprise Architect, open the existing repository and select 'Settings > Model > Integrity > Project Integrity' in the ribbon.

3.1.2

Ensure that the 'Action' panel is set to 'Report Only' and that all items in 'Checks to Run' are enabled, then click on the Go button.

3.1.3

If Enterprise Architect detects that the existing model contains integrity issues, they will be listed in the main panel at the bottom of the dialog. These issues should be resolved before continuing with the project transfer.

3.1.4

With Enterprise Architect open, ensure that it there is no project loaded, by selecting 'Close Project' from the Project list button.

3.1.5

Select the 'Settings > Model > Transfer > Project Transfer' ribbon option.

The 'Project Transfer' dialog displays.

3.1.6

In the 'Transfer Type' panel, select 'File to DBMS'.

3.1.7

At the right of the 'Source Project' field, click on the Browse. button and browse for the name of the project file to copy to Oracle.

If the .QEA file has Replication enabled, this must be removed before performing the transfer.

Remove Replication

3.1.8

At the right of the 'Target Project' field, click on the button and select either:

  • 'Native Connection' - the 'Open Server Connection' dialog displays (see the Native Connection to Oracle repository Help topic, then resume at step 3.1.13), or, if using the ODBC DSN
  • 'ODBC Connection Wizard' - The 'Datalink Properties' dialog displays (see the OLEDB Connection to Oracle repository Help topic for details, in particular step Connect to the Repository)
  • 'ODBC Connection Wizard' - The 'Datalink Properties' dialog displays (see the ODBC Connection to Oracle repository Help topic for details, in particular step Connect to the Repository)

3.1.9

If required, select the 'Logfile' checkbox and type a path and filename for the data transfer log file.

3.1.10

Click on the Transfer button to begin the data transfer process.

3.1.11

When the process is complete, you have created a project on an Oracle database and can now connect to it and open it from Enterprise Architect.

3.2. Load Initial Data - SQL Script

Step

Action

See also

3.2.1

Open your SQL management console of choice (such as SQL Developer) and log in as the owner of the newly created Enterprise Architect repository.

3.2.2

Download the EABase_1558_Oracle.sql file from the Sparx Systems website and open it in your SQL management console.

3.2.3

Run EABase_1558_Oracle.sql  to load the required initial data.

Notes

  • When transferring a project to Oracle you must have access rights to execute the CREATE SEQUENCE command

Learn more