The Notes client is an OLE automation controller and server.

Note This feature is not supported under OS/2, under UNIX, or on the Macintosh.

OLE automation controller

Notes is an OLE automation controller. You can use the LotusScript GetObject function to open an OLE automation object, and the CreateObject function to create an OLE automation object. You can also use the CreateObject and GetObject methods of the NotesUIDocument class.

OLE automation server

Notes registers itself as an OLE automation server and provides the following OLE automation objects:

• Notes.NotesUIWorkspace provides access to the Domino UI objects.
• Notes.NotesSession provides access to the Domino Objects (that is, the back-end objects).

Set workspace = CreateObject("Notes.NotesUIWorkspace")
Set doc = workspace.CurrentDocument

Set session = CreateObject("Notes.NotesSession")
Messagebox session.UserName

OLE automation uses late binding. You cannot create new Domino objects as you would in LotusScript. You must create (for example, with CreateObject) a Notes.NotesUIWorkspace or Notes.NotesSession object and work down through the hierarchies using the available methods. For example, if you want to open a Domino back-end database, create a Notes.NotesSession OLE automation object, and then use the GetDatabase method of NotesSession to set a reference variable.

In Visual Basic, declare the reference variables for all Domino objects as type Object. When you finish using a Domino object, set the reference variable to Nothing to free the memory it uses.

Use dot notation, just as in LotusScript, to access the properties and methods of an object.

Constants must be specified by actual numeric value rather than name. In LotusScript, you can get the value by displaying it. For example:

Messagebox ACLLEVEL_AUTHOR,, "ACLLEVEL_AUTHOR"

LotusScript Classes Coding Guidelines

Glossary