52 Creating External Data Sources

This chapter contains the information needed to create and manage External Data Sources (EDS).

This chapter includes the following sections:

• Section 52.1, "Introduction to External Data Sources"

• Section 52.2, "Creating External Data Sources"

52.1 Introduction to External Data Sources

An External Data Source (EDS) is a connection to an external database. An EDS usually contains data that does not change very much or data that is too large to bring into the Oracle BAM Active Data Cache (ADC).

The EDS definition in Oracle BAM acts as a pointer to the external data. For example, looking up the customer name based on a customer code in a customer management system. The customer name-code mapping is fairly static so that bringing that external data into Oracle BAM is not required.

EDS definitions can be exported and imported using ICommand, but you cannot import or edit the contents using ICommand or Oracle BAM Architect.

Passwords are entered in clear text. You cannot use DSNs (data source names).

To view the existing EDS:

• Select External Data Sources from the Oracle BAM Architect function list.

Figure 52-1 Oracle BAM Architect Function List

Description of "Figure 52-1 Oracle BAM Architect Function List"

52.2 Creating External Data Sources

Oracle BAM external data sources are created, edited, and deleted using Oracle BAM Architect.

52.2.1 How to Create an External Data Source

To define an EDS:

1. Select External Data Sources from the Oracle BAM Architect function list.

2. Click Create.

3. Enter a name and a description for the EDS.

   Caution:

   A single or double quotation mark in an Oracle BAM object name, such as a data object, report, or enterprise message source name, causes a runtime error.

   Do not include single or double quotation marks in an Oracle BAM object name.

4. Enter Driver, for example, oracle.jdbc.driver.OracleDriver for Oracle.

5. Enter database user credentials in the Login and Password fields.

6. Enter Connection string/URL, for example

   jdbc:oracle:thin:@db_hostname:db_port:db_instance
   

52.2.2 What You May Need to Know About Oracle Data Integrator External Data Sources

If you install the integration files for Oracle BAM and Oracle Data Integrator, two EDS definitions are created in Oracle BAM Architect: ODI_Master and ODI_Work. These EDS definitions cannot be deleted from Oracle BAM Architect, and their configuration should not be changed unless you are updating your Oracle Data Integrator host.

52.2.3 How to Edit an External Data Source

To edit an EDS:

1. Select External Data Sources from the Oracle BAM Architect function list.

2. Select the EDS to edit.

   The EDS properties display.

3. Select Edit.

4. Make the changes and click Save.

52.2.4 How to Delete an External Data Source

Note:

If the EDS definitions ODI_Master and ODI_Work appear in Oracle BAM Architect, do not delete them. These EDS definitions are used by the integration between Oracle BAM and Oracle Data Integrator

To delete an EDS:

1. Select External Data Sources from the Oracle BAM Architect function list.

2. Select the EDS to delete.

   The data source properties display.

3. Select Delete.

4. Click OK to confirm deletion of the data source.

   The data source is deleted.