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 12 Metaconnectors for LEI
This chapter provides an introduction to LEI Metaconnectors and contains information for creating and using the different types of Metaconnectors.
Supported characteristics of the Meter metaconnector
The following list captures supported characteristics of the Meter metaconnector.

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.
    - 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.
      - Introduction to Metaconnectors
        A metaconnector provides preprocessing operations on connection data prior to transfer within a defined activity form.
      - Collapse/Expand Metaconnector
        Use a Collapse/Expand Metaconnector to group or ungroup multiple records, with a common key value, into a single record with multivalue fields. The Collapse/Expand Metaconnector wraps another Connector or Metaconnector and collapses records on Fetch operations. It then expands them on write operations according to user-defined criteria. The Collapse/Expand Metaconnector has no effect on metadata operations; it simply passes through Create, Drop, and Action statements.
      - Collapse/Expand Metaconnection Document
        To create a new Collapse/Expand metaconnection document in IBM® Lotus Enterprise Integrator® (LEI), do the following.
      - Collapse/Expand Metaconnector Properties
        The Collapse/Expand Metaconnector Properties are described as follows.
      - Using the Collapse/Expand Metaconnector with a Replication Activity
        When using a Collapse/Expand Metaconnection with a Replication activity, the key fields and the grouping keys need to be the same and in the same order in the Metaconnection definition as in the Replication activity definition to work properly.
      - Collapse/Expand Metaconnector Data Types
        Since the Collapse/Expand Metaconnector has no external database, it always operates with IBM® Lotus Enterprise Integrator® (LEI) or Domino® Enterprise Connection Services (DECS) data types. For key fields, all LEI or DECS datatypes convert within their class (number, datetime, or stream); in addition, precision and overflow checking are performed as needed. For non-key fields, on Fetch, external single-value data types map to internal multivalue data types, and vice-versa on output. Therefore, an external number class type maps to a number list; a datetime to a datetime list; and text to a text list. Note that binary data types (unformatted BLOB or formatted binary types such as composite) cannot be mapped to multivalue types.
      - Meter Metaconnector
        Use the Meter metaconnector to track data flowing to and from another connection or metaconnection. The Meter metaconnector has no effect on any operations; it simply monitors the data transferred. Results from the metering are logged to a file. The specific information logged is configurable through use of the Meter metaconnection document.
      - Meter Metaconnection Document
        To create a new Meter metaconnection document in IBM® Lotus Enterprise Integrator® (LEI), do the following.
      - Meter Metaconnector Properties
        The Meter Metaconnector Properties are described.
      - Supported characteristics of the Meter metaconnector
        The following list captures supported characteristics of the Meter metaconnector.
      - Order Metaconnector
        Use an Order metaconnector to obtain consistent ordering of result sets from other Connections. The Order metaconnector wraps another connector and orders the result set based on user-defined criteria. Order options are available. The Order Metaconnector has no effect on data operations, other than producing a result set or fetching - it simply passes through Insert, Update, Remove, Create, Drop, and Action statements.
      - Order Metaconnection Document
        To create a new Order metaconnection document in IBM® Lotus Enterprise Integrator® (LEI), do the following.
      - Order Metaconnector Properties
        The Order metaconnector properties are described as follows.
      - Using the Order Metaconnector with a Replication Activity
        Replication depends on an ascending sort to operate properly. Do not use the Sort Descending option of this metaconnector when performing Replication activities.
      - Order Metaconnector Data Types
        Since the Order Metaconnector has no external database, it always operates with IBM® Lotus Enterprise Integrator® (LEI) data types. All LEI data types convert within their class (number, datetime, or stream). Precision and overflow checking are performed as needed.
      - Trace Metaconnector
        The Trace Metaconnector allows you to trace events associated with a specified sub connection. You may specify options including where to capture data (either to the IBM® Lotus Enterprise Integrator® (LEI) console or to a user-specified file name) and whether or not to include a timestamp with each trace log entry.
      - Trace Metaconnection Document
        To create a new Trace metaconnection document in IBM® Lotus Enterprise Integrator® (LEI), do the following.
      - Trace Metaconnector Properties
        The Trace Metaconnector options and their corresponding LotusScript® Extensions (LC LSX) properties are described as follows.
      - Example Trace Metaconnetor LC LSX Code
        Example Trace Metaconnector LotusScript® Extensions (LC LSX) code is shown as follows.
  - 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.

Supported characteristics of the Meter metaconnector

The following list captures supported characteristics of the Meter metaconnector.

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 Lotus® Connector LotusScript® Extensions Guide for more information.

Connection Properties -- As supported by the underlying connector
Standard Functionality -- Full, as supported by the underlying connector
Writeback Support -- Full, as supported by the underlying connector
Writeback Index - N/A
Statement Syntax -- See the underlying connector documentation.
Condition Syntax -- See the underlying connector documentation.
Connection Properties -- Connector, LogRecord, LogSubtotal, LogTotal, SubtotalFrequency, KeyFieldname, MeterFilename, plus those supported by the underlying connector
Array Transfer -- See the underlying connector documentation.
Actions Supported -- See the underlying connector documentation.
Catalog Types -- See the underlying connector documentation.
Create Types -- See the underlying connector documentation.
Drop Types -- See the underlying connector documentation.

All Connections have a set of properties with values that can be assigned and retrieved. See the Lotus® 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 chapter of that same manual.

Meter Metaconnector Data Types

Since the Meter metaconnector has no external database, it always operates with LEI data types. All LEI data types convert within their class (number, datetime, or stream). Precision and overflow checking are performed as needed. For more information, see the underlying connector documentation.