55 Creating External Data Sources

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

This chapter contains the following topics:

55.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 55-1 Oracle BAM Architect Function List

Description of Figure 55-1 follows
Description of "Figure 55-1 Oracle BAM Architect Function List"

55.2 Creating External Data Sources

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

55.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_host_name:db_port:db_instance
    

55.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.

55.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.

55.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.

55.3 External Data Source Example

This example uses the sample SCOTT user account and the EMP table in the Oracle database. You may need to unlock the account before proceeding with this example.

Step 1: Create an EDS

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

  2. Click Create.

  3. Enter myDataSource in the External Data Source Name field.

  4. Enter My Example External Data Source in the Description field.

  5. Enter Microsoft ODBC for Oracle in the Driver field.

  6. Enter scott in the Login field and tiger in the Password field.

    This sample account comes with your Oracle database installation. If you do not have this sample account you can create a new account and use it for this example.

  7. Enter server=net_service_name in the Connection string/URL.

    This entry needs to be a Net Service Name defined in your tnsnames.ora file.

  8. Click Save.

  9. Click Continue.

    The EDS information is displayed on the screen.

Step 2: Create a Data Object using the EDS

  1. Select Data Objects from the Oracle BAM Architect function list.

  2. Click Create Data Object.

  3. Enter Employees in the Name for new Data Object field.

  4. Leave the slash (/) in the Location for new Data Object field.

    The data object appears in the top level Data Objects folder.

  5. Leave the Tip text field blank.

  6. Enter Oracle Database Sample EMP Table in the Description field.

  7. Select the External Data Source checkbox.

  8. Select myDataSource from the External Data Source list.

  9. Enter emp in the External Table Name field.

  10. Add the following fields to the data object:

    Table 55-1 Fields in Employees Data Object

    Field External Field Name Field Type

    ename

    ename

    String

    empno

    empno

    Integer

    job

    job

    String

    mgr

    mgr

    Integer

    hiredate

    hiredate

    DateTime

    sal

    sal

    Decimal

    comm

    comm

    Decimal

    deptno

    deptno

    Integer


    Keep default settings for field attributes not specified in the table.

  11. Click Create Data Object.

  12. Click Continue.

  13. Click Contents to view the contents of the data object

    The data in the Employees data object should match the data in the Oracle database sample EMP table.

55.4 Use Case: Creating an EDS Against Oracle Business Intelligence Enterprise Edition

The following are the steps to configure an EDS definition in Oracle BAM Architect to work with Oracle Business Intelligence Enterprise Edition.

  1. Get the bijdbc.jar file and add it to the Oracle WebLogic Server class path.

    Add the JAR to WEBLOGIC_CLASSPATH in

    WLS_HOME/wlserver 10.3/common/bin/commEnv.cmd
    
  2. Create an EDS in Oracle BAM Architect with the following details:

    Driver: oracle.bi.jdbc.AnaJdbcDriver

    Login: User name for the Oracle Business Intelligence Server

    Password: Password for the Oracle Business Intelligence Server

    Connection String/URL: jdbc:oraclebi://host_name:port_number/catalog=catalog_name;

    For example: jdbc:oraclebi://bihost:9703/catalog=Paint;

    See "Step 1: Create an EDS" for an example EDS configuration.

  3. Create a data object based on this EDS. See "Step 2: Create a Data Object using the EDS" for an example.