Home
HCL Domino Designer Basic User Guide and Reference
This guide provides information on using HCL Domino Designer and programming language reference information.
Connectors
Connectors provide native access to a wide variety of DBMS products, ODBC, the platform File system, Enterprise Resource Planning systems, and Transaction Processing systems.
Connectors and Connectivity Guide
Chapter 8 Connector for Oracle
This chapter provides information about the Connector for Oracle, including descriptions of the fields in the connection document.
Supported characteristics of the Connector for Oracle
The following list captures supported characteristics of the Connector for Oracle.

HCL Domino Designer Basic User Guide and Reference
This guide provides information on using HCL Domino Designer and programming language reference information.
- What's new in HCL Domino Designer 12?
  The following features are new for developers in HCL Domino® Designer 12.
- 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.
- Application Design
  Welcome to the Application Design section of Domino® Designer Help.
- Application Management
  Welcome to the Application Management section of Domino® Designer Help.
- Domino® Query Language
  Domino® Query Language (DQL) is a facility running on a Domino server that provides a terse, shorthand syntax for finding documents. It supports a wide variety and complexity of search terms. It leverages existing design elements, avoiding the need to write detailed code to access them. DQL consolidates all methods in Domino for searching document contents.
- 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.
- Connectors
  Connectors provide native access to a wide variety of DBMS products, ODBC, the platform File system, Enterprise Resource Planning systems, and Transaction Processing systems.
  - 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 Connectors
      This chapter provides introductory information about each of the supplied HCL Connectors.
    - Chapter 4 Connector for Notes®
      This chapter provides information about the Connector for Notes®, including descriptions of the fields in the connection document.
    - Chapter 5 Connector for DB2®
      This chapter provides information about the Connector for DB2®, including descriptions of the fields in the connection document.
    - Chapter 6 Connector for File System
      This chapter provides information about the Connector for File System, including descriptions of the fields in the connection document.
    - Chapter 7 Connector for ODBC
      This chapter provides information about the Connector for ODBC, including descriptions of the fields in the connection document.
    - Chapter 8 Connector for Oracle
      This chapter provides information about the Connector for Oracle, including descriptions of the fields in the connection document.
      - Introduction to the Connector for Oracle
        The Connector for Oracle allows you to connect to an Oracle database. The Connector for Oracle can be used with HCL Enterprise Integrator (HEI), Domino® Enterprise Connection Services (DECS), and Connector LotusScript® Extensions (LC LSX).
      - Oracle terminology
        The following table lists HCL Enterprise Integrator (HEI) terms and the corresponding terms in Oracle.
      - Supported characteristics of the Connector for Oracle
        The following list captures supported characteristics of the Connector for Oracle.
      - Considerations When Working with the Connector for Oracle
        This section describes several important considerations for using the Connector for Oracle.
      - Oracle Connection Document for HEI
        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 HEI 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 HCL Enterprise Integrator (HEI) or Domino® Enterprise Connection Services (DECS), an Oracle stored procedure may be used such as the destination of a Direct Transfer or within a 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 Connector LotusScript® Extensions (LC LSX)
      - Oracle Data Types
        The following tables show the correspondences of Oracle to HCL Enterprise Integrator (HEI) or Domino® Enterprise Connection Services (DECS) data types for various types of activities.
      - Connector for Oracle Properties
        See the Connectors LotusScript® Extensions Guide for a list of properties for the Connector for Oracle.
    - Chapter 9 Connector for OLE DB
      This chapter provides information about the Connector for OLE DB, including descriptions of the fields in the connection document.
    - Chapter 10 Connector for Sybase
      This chapter provides information about the Connector for Sybase, including descriptions of the fields in the connection document.
    - Chapter 11 Connector for Text
      This chapter provides information about the Connector for Text, including descriptions of the fields in the connection document.
    - Chapter 12 Metaconnectors for HEI
      This chapter provides an introduction to HEI Metaconnectors and contains information for creating and using the different types of Metaconnectors.
  - LSX for Connectors
    LotusScript® Extensions for Connectors (LC LSX) enhances the power of Notes® by extending its scripting to data outside of Notes through the use of 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
    Developers are advised not to use LS:DO. Developers should use the 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.

Supported characteristics of the Connector for Oracle

The following list captures supported characteristics of the Connector for Oracle.

For a definition of the terms used in this section, see "Supported Connector Characteristics -- List of Terms" in Chapter 3 of this manual. If you are accessing the Connector using LotusScript®, see the Connector LotusScript® Extensions Guide for more information.

Writeback support -- Full writeback support. The connection supports updatable cursors (update and remove)
Writeback index -- Index strongly advised, but not required. Use the command "create index <indexname> on <tablename> (<column1>, <column2>, ..., <columnN>)"
Statement syntax -- Full PL/SQL syntax. To execute stored procedures, use the following syntax: "BEGIN <stored procedure> (<parm1>, <parm2>, ..., <parmN>) ; END ;"
Condition syntax -- Valid when placed in the following Oracle statement: SELECT ... WHERE <condition> ORDER BY ...
Actions supported -- Clear, Reset, Truncate, Commit, Rollback
Catalog types -- Metadata, Index, Field, Procedure, Parameter
Create types -- Metadata, Index
Drop types -- Metadata, Index

All connections have a set of properties with values that can be assigned and retrieved. See the Connector LotusScript® Extensions Guide for a list of supported properties for each Connector. Also see the "Common Connector Properties" and "LCConnection Properties" sections in the LCConnection Class of that same manual.