Home
HCL Domino Designer Basic User Guide and Reference
This guide provides information on using HCL Domino Designer and programming language reference information.
LotusScript/COM/OLE Classes
LotusScript® Classes Coding Guidelines
The following topics cover some general guidelines for writing LotusScript® code using Domino® objects:
Accessing supporting Domino® objects
Converting between Domino® Designer and LotusScript® time
The formats of a Domino® Designer date-time item and a LotusScript® date variant differ. For example, you cannot put a LotusScript date variant in a Domino Designer date-time item or manipulate a Domino Designer time-date item with LotusScript date functions.

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 11 for developers?
  The following features are new for developers in HCL Domino® Designer 11.
- 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
  - LotusScript® Classes Coding Guidelines
    The following topics cover some general guidelines for writing LotusScript® code using Domino® objects:
    - Using the Domino® classes
      Domino® Designer defines LotusScript® classes that allow you to access Domino structures on two levels:
    - Using LotusScript® features in Domino®
      All LotusScript® features work in Domino® exactly as specified in generic LotusScript, with the following exceptions and clarifications:
    - Accessing Domino® databases
    - Accessing views and folders
    - Accessing documents in LotusScript® classes
    - Accessing items in LotusScript® classes
    - Accessing rich text items in LotusScript® classes
    - Accessing sessions
    - Accessing supporting Domino® objects
      - Converting between Domino® Designer and LotusScript® time
        The formats of a Domino® Designer date-time item and a LotusScript® date variant differ. For example, you cannot put a LotusScript date variant in a Domino Designer date-time item or manipulate a Domino Designer time-date item with LotusScript date functions.
        Examples: Converting between Domino Designer and LotusScript time
        This example writes the DateComposed item from a Domino Designer document to the LocalTime property of a NotesDateTime object, then accesses the LSLocalTime property of that object with the Weekday LotusScript function.
      - Making a Domino® log
      - Making a Domino® newsletter
        A newsletter is a summary document containing information from and/or links to other documents. The essential steps for creating a newsletter are:
      - Setting up a timer
        A timer allows you to call an event handler every specified number of seconds. The essential steps for creating a timer are:
      - Representing a name
      - Representing a color
      - Working with streams of data
      - Building a note collection (LotusScript®)
    - Handling run-time errors
    - Accessing the Domino® Objects through COM
    - Using OLE
      The Notes® client is an OLE automation controller and server.
    - Using OLE custom controls
      You can embed OLE custom controls in Domino® Designer forms and write scripts for them just as you can for a native object. When a control is active (has focus), the menu is a combination of Domino Designer (File, Applet, and Window) and control items. The control menu items may include one for itself (for example, "Spreadsheet" for a spreadsheet control) and Help--the control help is substituted for Domino Designer help.
  - LotusScript® Classes A-Z
    This documentation lists each class, property, and method in the Domino® class library. Each class is followed by an alphabetical listing of the properties for that class and an alphabetical listing of the methods for that class. To find the property or method you want, turn to the class to which the property or method belongs.
  - LotusScript® Classes Tutorial
    Welcome to LotusScript® and Domino®. "LotusScript Classes Tutorial" consists of three lessons designed to introduce you to using the LotusScript language in Domino. Each lesson includes:
- 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.
- 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.

Converting between Domino® Designer and LotusScript® time

The formats of a Domino® Designer date-time item and a LotusScript® date variant differ. For example, you cannot put a LotusScript® date variant in a Domino® Designer date-time item or manipulate a Domino® Designer time-date item with LotusScript® date functions.

The NotesDateTime class converts between formats by representing both formats as properties. For example, you can get the value of a Domino® Designer date-time item by setting the LocalTime property, which is in Domino® Designer format, and then manipulating the value with LotusScript® functions by accessing the LSLocalTime property of the same object.

The following table lists the NotesDateTime properties:


Property	Data type	Description
DateOnly	String	(Read-only) Date part of Domino® Designer date-time in local time
GMTTime	String	(Read-only) Domino® Designer date-time in Greenwich Mean Time
IsDST	Boolean	(Read-only) True if the time is daylight-saving time
LocalTime	String	(Read-write) Domino® Designer date-time in local time
LSGMTTime	Date variant	(Read-only) LotusScript® date-time in Greenwich Mean Time
LSLocalTime	Date variant	(Read-write) LotusScript® date-time in local time
Parent	NotesSession	(Read-only) The session that contains a DateTime object. For COM only
TimeOnly	String	(Read-only) Time part of Domino® Designer date-time in local time
TimeZone	Integer	(Read-only) Hours that must be added to the time to get Greenwich Mean Time
ZoneTime	String	(Read-only) Domino® Designer date-time adjusted for TimeZone and IsDST, which can be changed with ConvertToZone

The NotesDateRange class represents a range of dates. The following table lists the NotesDateRange properties. When you set a NotesDateRange object, either write to StartDate and EndDate, or Text, but not both. Values written to StartDate or EndDate are immediately transcribed to Text, and vice versa.


Property	Data type	Description
EndDateTime	NotesDateTime	(Read-write) Domino® Designer date-time in local time
Parent	NotesSession	(Read-only) The session that contains a DateRange object For COM only.
StartDateTime	NotesDateTime	(Read-write) The starting date-time of the range
Text	String	(Read-write) The range as two date-time strings separated by a hyphen