73 Configuring an EIS Project

This chapter describes the various components that you must configure in order to use an EIS project.

This chapter includes the following sections:

Introduction to EIS Project Configuration
Configuring EIS Data Source Platform at the Project Level
Configuring EIS Connection Specification Options at the Project Level

For information on how to configure TopLink project options common to two or more project types, see Chapter 117, "Configuring a Project".

Table 73-1 lists the configurable options for EIS projects.

73.1 Introduction to EIS Project Configuration

Table 73-1 lists the configurable options for EIS projects.

Table 73-1 Configurable Options for EIS Projects

Option to Configure	Oracle JDeveloper	TopLink Workbench	Java
Project save location (see Section 117.2, "Configuring Project Save Location")
Persistence type (see Section 117.5, "Configuring Persistence Type")
Project classpath (see Section 117.3, "Configuring Project Classpath")
Comments (see Section 117.14, "Configuring Project Comments")
Method or direct field access (see Section 117.4, "Configuring Method or Direct Field Access at the Project Level")
Default descriptor advanced properties (see Section 117.6, "Configuring Default Descriptor Advanced Properties")
Existence checking (see Section 117.7, "Configuring Existence Checking at the Project Level")
Project deployment XML options (see Section 117.8, "Configuring Project Deployment XML Options")
Model Java source code options (see Section 117.9, "Configuring Model Java Source Code Options")
EIS data source platform (see Section 73.2, "Configuring EIS Data Source Platform at the Project Level")
EIS connection specification options (see Section 73.3, "Configuring EIS Connection Specification Options at the Project Level")
XML parser platform (see Section 8.2.2.1, "Configuring XML Parser Platform")
Importing an XML schema (see Section 5.6.3, "How to Import an XML Schema")
XML schema namespace (see Section 5.6.5, "How to Configure XML Schema Namespace")
Cache type and size (see Section 117.10, "Configuring Cache Type and Size at the Project Level")
Cache isolation (see Section 117.11, "Configuring Cache Isolation at the Project Level")
Cache coordination change propagation (see Section 117.12, "Configuring Cache Coordination Change Propagation at the Project Level")
Cache expiration (see Section 117.13, "Configuring Cache Expiration at the Project Level")

For more information, see Chapter 71, "Introduction to EIS Projects".

73.2 Configuring EIS Data Source Platform at the Project Level

For each EIS project, you must specify one of the following JCA data source platforms that you will be using:

Oracle AQ
Attunity Connect
IBM MQSeries
JMS
Sun Black Box
XML File

This platform configuration is overridden by the session login, if configured.

For more information, see the following:

73.2.1 How to Configure EIS Data Source Platform at the Project Level Using TopLink Workbench

To specify the data source platform of an EIS project, use this procedure:

Select an EIS project object in the Navigator.
Select the Connection Specifications tab in the Editor. The Connection Specifications tab appears.
Select the Connection tab. The Connection tab appears.

Figure 73-1 Connection Tab, Platform Option

Description of "Figure 73-1 Connection Tab, Platform Option"

Select the EIS platform for this project from the list of options. For more information, see Section 96.1.3, "Data Source Platform Types".

73.3 Configuring EIS Connection Specification Options at the Project Level

You can configure connection information at the project level for an EIS application. This information is stored in the project.xml file. The Oracle TopLink runtime uses this information as its deployment login: whenever your EIS application performs a persistence operation when deployed in a Java EE application server.

This connection configuration is overridden by the connection information at the session level, if configured. For more information about session level configuration, see Section 99.3, "Configuring EIS Connection Specification Options at the Session Level".

73.3.1 How to Configure EIS Connection Specification Options at the Project Level Using TopLink Workbench

To specify the connection information for an EIS project, use this procedure.

Select an EIS project object in the Navigator.
Select the Connection Specifications tab in the Editor. The Connection Specifications tab appears.
Select the Connection tab. The Connection tab appears.

Figure 73-2 Connection Tab, Connection Specification Options

Description of "Figure 73-2 Connection Tab, Connection Specification Options"

Use this table to enter data in the following fields to configure the connection specification options:

Field	Description
Connection Specification Class	Specify the appropriate connection specification class for the selected Platform. Click Browse to choose from all the classes in the TopLink class path. (example: if Platform is `oracle.toplink.eis.aq.AQPlatform`, use `oracle.toplink.eis.aq.AQEISConnectionSpec`). For more information on platform configuration, see Section 99.2, "Configuring an EIS Data Source Platform at the Session Level".
Connection Factory URL	Specify the appropriate connection factory URL (as a Java EE JNDI name) for the selected Connection Specification Class (example: `java:comp/env/eis/attuntiy`).
Username	Specify the name required to log in to the data source.
Password	Specify the password required to log in to the data source. Note: When exporting Java source and deployment XML (see Section 116.3, "Exporting Project Information"), TopLink Workbench writes the database password (if applicable) using JCE encryption (when using JDK 1.4). For information on how to specify password encryption options, see Section 97.3, "Configuring Password Encryption".