Home
IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
Lotus® Connectors
Lotus® Connectors provide native access to a wide variety of DBMS products, ODBC, the platform File system, Enterprise Resource Planning systems, and Transaction Processing systems.
Lotus® Connectors and Connectivity Guide
Chapter 8 Lotus® Connector for Oracle
This chapter provides information about the Lotus® Connector for Oracle, including descriptions of the fields in the connection document.
Introduction to the Lotus® Connector for Oracle
The Lotus® Connector for Oracle allows you to connect to an Oracle database. The Lotus Connector for Oracle can be used with IBM® Lotus Enterprise Integrator® for Domino® (LEI), Domino Enterprise Connection Services (DECS), and Lotus Connector LotusScript® Extensions (LC LSX).

IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
- Application Design
  Welcome to the Application Design section of Domino® Designer Help.
- Domino® Designer templates
  The templates described in the following table are available with Domino® Designer and are specifically intended for use by application developers.
- Importing to and exporting from views
- Developing applications using MAPI
  Domino® Designer Release 6 and later supports the messaging application program interface (MAPI), which allows mail integration between Domino and a MAPI-compliant messaging application, such as Microsoft™ Outlook, Microsoft Office applications, or user-written C++ programs.
- Features to avoid using in Web applications
  Developers creating applications specifically for the Web, or for the dual purpose of serving Notes® and Web clients, should review the following tables for features that are not supported on the Web.
- URL commands for Web applications
  You have a variety of options for programming a Web site. You can directly manipulate objects such as documents or views in an application using Domino® URL commands. Adding Domino URL commands as HTML in forms gives users shortcuts for navigating databases and performing other tasks quickly.
- Application Management
  Welcome to the Application Management section of Domino® Designer Help.
- Composite Applications - Design and Management
  Composite applications are a key element in a service-oriented architecture (SOA) and contextual collaboration strategy. The ability to create and edit composite applications lets you easily integrate different types of components and technologies.
- DB2® Access views
  Domino® Designer includes two types of design elements to assist you in managing data contained in DB2® enabled Notes® databases:
- Programming Overview and User Interface
  This section contains general guidelines and examples that show where to use Java, LotusScript, and the formula language.
- Formula Language
  This section documents the formula language.
- LotusScript® Language
  Welcome to the LotusScript® Language section of Domino® Designer Help.
- LotusScript/COM/OLE Classes
- Java/CORBA Classes
  This section documents the Java/CORBA classes.
- Lotus® Connectors
  Lotus® Connectors provide native access to a wide variety of DBMS products, ODBC, the platform File system, Enterprise Resource Planning systems, and Transaction Processing systems.
  - Lotus® Connectors and Connectivity Guide
    - Chapter 1 DCTEST and CONTEST
      This chapter provides information about DCTEST and CONTEST. These programs test system and application connectivity to external data sources.
    - Chapter 2 Connectivity
      This chapter provides instructions and information for setting up and testing connectivity to the following database systems:
    - Chapter 3 Introduction to Lotus® Connectors
      This chapter provides introductory information about each of the supplied IBM® Lotus® connectors.
    - Chapter 4 Lotus® Connector for Notes®
      This chapter provides information about the Lotus® Connector for Notes®, including descriptions of the fields in the connection document.
    - Chapter 5 Lotus® Connector for DB2®
      This chapter provides information about the Lotus® Connector for DB2®, including descriptions of the fields in the connection document.
    - Chapter 6 Lotus® Connector for File System
      This chapter provides information about the Lotus® Connector for File System, including descriptions of the fields in the connection document.
    - Lotus® Connector for ODBC
      For complete information on the Lotus® Connector for ODBC, refer to the documentation on the Notes® Domino® Application Development wiki.
    - Chapter 8 Lotus® Connector for Oracle
      This chapter provides information about the Lotus® Connector for Oracle, including descriptions of the fields in the connection document.
      - Introduction to the Lotus® Connector for Oracle
        The Lotus® Connector for Oracle allows you to connect to an Oracle database. The Lotus Connector for Oracle can be used with IBM® Lotus Enterprise Integrator® for Domino® (LEI), Domino Enterprise Connection Services (DECS), and Lotus Connector LotusScript® Extensions (LC LSX).
      - Oracle terminology
        The following table lists IBM® Lotus Enterprise Integrator® (LEI) terms and the corresponding terms in Oracle.
      - Supported characteristics of the Connector for Oracle
        The following list captures supported characteristics of the Lotus® Connector for Oracle.
      - Considerations When Working with the Lotus® Connector for Oracle
        This section describes several important considerations for using the Lotus® Connector for Oracle.
      - Oracle Connection Document for LEI
        The Oracle connection document defines a connection to an Oracle database. Connection documents enable you to define your system connections. They contain access information for specific databases and users. When you create an activity, you make connection choices from your set of defined connections.
      - Fields in the LEI Connection Document - 4
        See the following tables for descriptions of the connection document fields.
      - Oracle Connection Document for DECS
        The Domino® Enterprise Connection Services (DECS) connection document for Oracle defines a connection to an Oracle database. Connection documents enable you to define your system connections. They contain access information for specific databases and users. When you create an activity, you make connection choices from your set of defined connections.
      - Fields in the DECS Connection Document - version and user information
        The fields in the Domino® Enterprise Connection Services (DECS) connection document are described as follows.
      - Character Data Types and Key Fields
        When you use data of type CHAR in a key field, the functionality of the Oracle connector in two scenarios must be addressed: trimming spaces and creating an entry.
      - Using Oracle stored procedures
        Wherever procedures are allowed in IBM® Lotus Enterprise Integrator® (LEI) or Domino® Enterprise Connection Services (DECS), an Oracle stored procedure may be used such as the destination of a Direct Transfer or within an Lotus® Connector LotusScript® Extensions (LC LSX) script. The stored procedure being called must have its parameters set up correctly for the call.
      - Example: Oracle Stored Procedure
        The following is an example of an Oracle stored procedure body. This is the format that would be required for the Open event of a Virtual Fields activity assuming that the key field is called NUMBER1 and the data fields are called NUMBER2, TEXT1, and TEXT2. In this context, the key field is the input parameter, and the result set is expected to include the data fields and the key field. To accommodate the fact that one of the output parameter names is the same as a key value in the select statement, the parameter keys should be copied to local variables to avoid scoping problems in the procedure.
      - Example: Sample LC LSX Agent to Call an Oracle Stored Procedure
        This example shows how to call an Oracle stored procedure using the IBM® Lotus® Connector LotusScript® Extensions (LC LSX)
      - Oracle Data Types
        The following tables show the correspondences of Oracle to IBM® Lotus Enterprise Integrator® (LEI) or Domino® Enterprise Connection Services (DECS) data types for various types of activities.
      - Lotus® Connector for Oracle Properties
        See the Lotus® Connectors LotusScript® Extensions Guide for a list of properties for the Lotus Connector for Oracle.
    - Chapter 9 Lotus® Connector for OLE DB
      This chapter provides information about the Lotus® Connector for OLE DB, including descriptions of the fields in the connection document.
    - Chapter 10 Lotus® Connector for Sybase
      This chapter provides information about the Lotus® Connector for Sybase, including descriptions of the fields in the connection document.
    - Chapter 11 Lotus® Connector for Text
      This chapter provides information about the Lotus® Connector for Text, including descriptions of the fields in the connection document.
    - Chapter 12 Metaconnectors for LEI
      This chapter provides an introduction to LEI Metaconnectors and contains information for creating and using the different types of Metaconnectors.
  - LSX for Lotus® Connectors
    LotusScrip Extensions for Lotus® Connectors (LC LSX) enhances the power of Notes® by extending its scripting to data outside of Notes through the use of Lotus Connectors. The programming model is independent of the individual connector. This eliminates the need to learn each individual system, while at the same time allowing experienced users to access the individual features of a specific system.
  - Accessing external databases through LS:DO
    LS:DO has been in maintenance mode since R5. Developers are advised not to use it. Developers should use the Lotus® Connector LSX for (LCLSX) when accessing external data sources.
- Javadoc™ for Domino® Designer related APIs
  As part of providing additional Java™ reference documentation, Domino® Designer ships with a help plugin that contains Javadoc™ for additional Domino Designer related APIs.
- Accessibility and keyboard shortcuts
  Accessibility features assist users who have a disability, such as restricted mobility or limited vision, to use information technology content successfully.

Introduction to the Lotus® Connector for Oracle

The Lotus® Connector for Oracle allows you to connect to an Oracle database. The Lotus® Connector for Oracle can be used with IBM® Lotus Enterprise Integrator® for Domino® (LEI), Domino® Enterprise Connection Services (DECS), and Lotus® Connector LotusScript® Extensions (LC LSX).

When working with multiple text languages and text formats, set the notes.ini variable "EIOracle8NativeText" to a valid Oracle code page to force the translation of all transferred Oracle data to that code page. This variable must be set with a character set name understood by Oracle. Examples of values for this variable are "WE8ISO8859P1" or "JA16SJIS" or "RU8BESTA". See the National Language Support (NLS) section in your Oracle documentation for a list of the available character set names.

For information about configuring and testing connectivity, see chapter 2.

For general information about Lotus® Connectors, see chapter 3.