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.
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.
Appendix E Additional Scripting Capability for LEI
This appendix provides information about additional methods and properties provided for IBM® Lotus Enterprise Integrator® (LEI) with the LCSession class that expand on the IBM Lotus® Connector LotusScript® Extensions (LC LSX).
AddProperty Method for LCSession
This method creates a new property and assigns it a property token.

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
  - 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.
    - Chapter 1 Introduction
      This chapter provides an introduction to the LotusScript® Extension for Lotus® 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 Lotus® Connector LotusScript® Extensions (LC LSX).
    - Appendix E Additional Scripting Capability for LEI
      This appendix provides information about additional methods and properties provided for IBM® Lotus Enterprise Integrator® (LEI) with the LCSession class that expand on the IBM Lotus® Connector LotusScript® Extensions (LC LSX).
      - Expanded LCSession Functionality
        IBM® Lotus Enterprise Integrator® (LEI) expands the LCSession Class functionality with properties not available for non-LEI users. The LCSession class also provides additional methods to support activity-level properties and logging. The additional features of the Lotus® Connector classes for LEI are only available when used in conjunction with LEI and the LEI Administrator.
      - Additional Scripting for LEI
        There are additional properties and methods provided for IBM® Lotus Enterprise Integrator® (LEI) with the LCSession class that expand on the IBM Lotus® Connector LotusScript® Extensions (LC LSX).
      - AddProperty Method for LCSession
        This method creates a new property and assigns it a property token.
      - GetProperty Method for LCSession
        This method obtains a copy of the current value for an activity property.
      - GetProperty<Type> Method for LCSession
        The GetProperty<Type> methods return a session property value as a specific data type. Supported data types are Boolean, Currency, Datetime, Float, Int, Numeric, and Text.
      - ListProperty Method for LCSession
        This method lets you retrieve information about each of the properties supported by the Session. Information about one property is returned with each call to ListProperty.
      - LookupProperty Method for LCSession
        This method determines if the specified property has been defined in the activity.
      - Log Method for LCSession
        This method adds a new entry to the log for this activity.
      - LogEx Method for LCSession
        This method adds a new extended entry to the log for this activity. The values supplied are a status code, such as you would supply to the Log method, plus various additional parameters that supply additional information about the particular error code being returned.
      - LogText Method for LCSession
        This method adds a new external entry to the log for this activity.
      - LogTextEx Method for LCSession
        This method adds a new external extended entry to the log for this activity.
      - RunActivity Method for LCSession
        This method causes one or more LEI activities to be executed.
      - SetProperty Method for LCSession
        This method assigns the current value for an activity property.
      - SetProperty<Type> Method for LCSession
        The SetProperty<Type> methods assign a property value as a specific data type. Supported data types include Boolean, Currency, Datetime, Float, Int, Numeric, and Text.
  - 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.

AddProperty Method for LCSession

This method creates a new property and assigns it a property token.

Defined In

LCSession Class

Syntax

tokenID = lcSession. AddProperty (propertyName, storageType

Parameters


Parameter	Description
propertyName	String. Name of the property to be created. The name must be unique among properties of this storage type. Using the same name as an existing property creates a new token if the storage type differs, but simply returns the previously assigned token if the storage type is the same.
storageType	Long. Optional. One of the following: LCPROPSTORE_STATIC --This value is read from or written to the activity document. LCPROPSTORE_DYNAMIC --This value will only exist during this run. LCPROPSTORE_SYSTEM -- This value is read from and written to operating system environment variables. Note: System properties are not persistent across executions.

Return Value


Value	Description
tokenID	Long. Token assigned to the property. The token is only valid for this run of the activity. The token will be a value between the highest token defined by the activity itself and the maximum base token value, 65535.

Note: Any added properties are in addition to the properties defined by an activity. There are three types of properties which may be added. Static properties will be stored in the activity document itself in the IBM® Lotus Enterprise Integrator® (LEI) Administrator database, and their values may be retrieved for future executions of the same activity. Dynamic properties are defined only for the current execution of the activity, and are discarded when the activity terminates. System properties are represented by operating system environment variables, and any retrieval or assignment of values immediately alters the environment variable's value.