APPLICATION DESIGN


Events
When users work in IBM® Lotus® Domino(TM) design elements, Domino tracks their operations as events (for example, opening a database, opening a view, opening a document). You can attach programming tasks to these events.

To build a program for an event, you can use:


When to use event programming

Use event programming to run tasks that users shouldn’t have to activate themselves and that are very specific. Event programming is particularly useful when the timing of the program must be precise or the tasks are associated with a particular design element.

For a table of events that can be automated, see Event Descriptions in the Domino Designer Programming Guide.

Examples of event programming


Types of events

Every design element has events that you can program, but they vary according to the design element. In the Programmer’s pane, click the Objects tab to review the events you can program.

Database Script events

Database Script events pinpoint database-wide activities such as opening and closing a database or deleting and undeleting documents. To access the Database Script events, double-click Database Scripts under Code in the Applications Navigator.

Examples:


View and folder events

View events occur when users work in a specific view or folder. View events include opening or closing a view, adding documents to a calendar view, or adding documents to a folder.

Examples of view and folder events


In addition to the events available for all views, calendar views have specific events.

Examples of calendar view events


Form events

Form events occur at the document level when users open or close a document. They are useful for speeding up document display times because they execute only when a specific form event occurs, unlike field recalculations that occur each time a document is saved, opened, or refreshed.

Examples


Field events

Field events capture users’ movements into or away from a field.

Examples


Click events

The Click event occurs when users click actions or hotspots, or choose tasks from the Actions menu. Other events for actions, buttons, and hotspots allow you to add programming to other events. After the object is loaded, the "initialize" event is triggered and then the click event is triggered.

Examples


Agent event

The Initialize event stores all the programming associated with the agent. Always add the programming to the Initialize event for an agent.

See Also