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.
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.
Appendix D Character Sets
This appendix provides information about character sets, including character set translation, character sort order, and a list of the character sets supported by the Connector LotusScript® Extensions (LC LSX).
International Character Set Translation
Not all computer systems treat text data the same. Systems around the world have different character sets and sending text data from one country to another may not yield expected results. As well, different database products treat this problem differently.

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
  - 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.
    - Chapter 1 Introduction
      This chapter provides an introduction to the LotusScript® Extension for Connectors (LC LSX) and explains the organization of this manual.
    - Chapter 2 LCConnection Class
      This chapter provides information about the LCConnection class methods and properties.
    - Chapter 3 LCCurrency Class
      This chapter provides information about the LCCurrency class methods and properties.
    - Chapter 4 LCDatetime Class
      This chapter provides information about the LCDatetime class methods and properties.
    - Chapter 5 LCField Class
      This chapter provides information about the LCField class methods and properties.
    - Chapter 6 LCFieldlist Class
      This chapter provides information about the LCFieldlist class methods and properties.
    - Chapter 7 LCNumeric Class
      This chapter provides information about the LCNumeric class methods and properties.
    - Chapter 8 LCSession Class
      This chapter provides information about LCSession class methods and properties.
    - Chapter 9 LCStream Class
      This chapter provides information about the LCStream class methods and properties.
    - Appendix A Error Messages
      This appendix provides information about error messages.
    - Appendix B Connector Property Tokens
      This appendix provides information about the property tokens used in the LotusScript® Extensions (LC LSX).
    - Appendix C Connector Properties
      This chapter provides information about connector properties. These properties are used when creating connections using the Lotus® Connector LotusScript® Extensions.
    - Appendix D Character Sets
      This appendix provides information about character sets, including character set translation, character sort order, and a list of the character sets supported by the Connector LotusScript® Extensions (LC LSX).
      - International Character Set Translation
        Not all computer systems treat text data the same. Systems around the world have different character sets and sending text data from one country to another may not yield expected results. As well, different database products treat this problem differently.
      - Forcing HEI or DECS to Use a Character Set as Native
        HCL Enterprise Integrator (HEI) and Domino® Enterprise Connection Services (DECS) determines the native character set on the local machine during startup and uses this setting whenever the native character set is required. HEI and DECS can be forced to use a different character set as native by setting the EINativeText variable in the notes.ini file to the suffix of an HEI text stream format.
      - Character Sort Order in HEI
        HCL Enterprise Integrator (HEI) cannot control the sort order specified in the databases that it accesses. If the sort orders used in two databases are not the same, mismatches can arise during Replication activities, causing excessive insert/delete operations and thereby affecting performance. The use of the Order MetaConnector for databases which sort differently is designed to solve sort order differences. Replication also provides an option for case-insensitive string comparison when excessive insert/delete pairs occur during replication between databases that use case-insensitive sorting.
      - Character Set Considerations
        Considerations when working with character sets are listed as follows.
      - List of Supported Character Sets
        The list is given as text stream format constants. Any of these values may be used as a stream format for a text stream when creating scripts using the Connector LotusScript® Extensions (LC LSX) To indicate the character set on the local machine, use the constant LCSTREAMFMT_NATIVE. When providing a character set on the HCL Enterprise Integrator (HEI) Administrator, use the stream format constant with the prefix "LCSTREAMFMT_" removed. For Domino® Enterprise Connection Services (DECS) see "Forcing HEI or DECS to Use a Character Set as Native" in this chapter.
    - Appendix E Additional Scripting Capability for HEI
      This appendix provides information about additional methods and properties provided for HCL Enterprise Integrator (HEI) with the LCSession class that expand on the Connector LotusScript® Extensions (LC LSX).
  - 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.

International Character Set Translation

Not all computer systems treat text data the same. Systems around the world have different character sets and sending text data from one country to another may not yield expected results. As well, different database products treat this problem differently.

HCL Enterprise Integrator (HEI) and Domino® Enterprise Connection Services (DECS) support international character sets and support over 200 different character set mappings, including US English, Asian, Far East, and Western and Eastern European languages, as well as multi-lingual characters sets such as LMBCS and Unicode. HEI provides support for translating characters from one set to another.

All text data within HEI and DECS maintains a reference to its own character set. This reference is determined automatically by the connector when the data is fetched from a database. If the data is inserted into a database with a different character set, HEI and DECS automatically translates the text data just prior to storing it. This process maintains maximum performance by eliminating any unnecessary translation.

Performance may be further enhanced through three levels of translation support. The translation support choices are described as follows:

Disabled -- For maximum performance and when all text data is in compatible character sets, translation is disabled completely.
LMBCS only -- Only Notes® text data is translated. This is appropriate when all non-Notes text data is in compatible character sets.
Enabled -- Translation between different character sets always occurs.

Regardless of the setting, Unicode text is always translated.

Note: In HEI, the text translation setting is available for each HEI server, allowing different servers to have different levels of support. The translation support level is set during the installation of an HEI server. It may also be viewed and edited in the server configuration document in the HEI Administrator. In DECS, the text translation setting is controlled by the notes.ini file, see "Forcing HEI or DECS to Use a Character Set as Native" in this chapter.