Home
IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
Programming Overview and User Interface
This section contains general guidelines and examples that show where to use Java, LotusScript, and the formula language.
User Interface
Using the Objects tab
The Objects tab is located in the Info List. It contains a context-sensitive list of objects and events available for the selected programming language. The Objects tab allows you to:
Programming an object's properties and events

IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
- 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 in Domino core allowing for a terse shorthand syntax for finding documents according to a wide variety of complexity of terms. It leverages existing design elements without the need to write detailed code to access them.
- 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.
  - Programming Overview
    This documentation describes how to attach Java, JavaScript, LotusScript, and formula code to Domino design elements. Here are some overview topics:
  - User Interface
    - Accessing the Programmer's pane
    - Exploring the Programmer's pane
      The Programmer's pane is located in Domino Designer following the Work pane, or by itself in some design elements and resources such as agents and shared fields. The Programmer's pane is context-sensitive and may change slightly depending on the programming language you select.
    - Exploring the Java interface in the Programmer's pane
      Java programming can be done in the Programmer's pane of an agent or a script library.
    - Using the Info List
      The Info List appears on the left side of the Programmer's pane and contains the following context-sensitive tabs:
    - Using the Objects tab
      The Objects tab is located in the Info List. It contains a context-sensitive list of objects and events available for the selected programming language. The Objects tab allows you to:
      - Programming an object's properties and events
    - Using the Reference tab
      The Reference tab provides you with context-sensitive information for each programming language recognized in the Programmer's pane. You can view this information by clicking the Reference tab and selecting the desired topic from the Reference list.
    - Using the Errors box
      The Errors box is present for Java and LotusScript. Use the Errors box to view error messages that occur during script entry and compilation. The Errors box displays only one error at a time. To view other errors, click on the box and select the error from the list. When you select an error from the list, the line containing the error is highlighted in the Script area.
    - Using the Script area
      The Script area formats LotusScript automatically by indenting and adjusting the case of keywords as needed. There is no automatic formatting for other programming languages in Lotus Domino Designer.
    - Writing Java in an agent
    - Writing JavaScript in the Programmer's pane
      JavaScript allows you to write scripts that function on the Web as well as in the Domino client. The Objects tab provides a list of JavaScript events supported in Lotus Domino Designer. JavaScript is not available for agents. For LotusScript Web agents, you can use Print statements to output HTML to the browser, including script statements. For example, Print "<script>function changeLocation(){...}</script>."
    - Writing LotusScript in the Programmer's pane
      The Programmer's pane allows you to:
    - Exploring the LotusScript Debugger
      The debugger allows you to:
    - Using the Remote Debugger
    - Debugging Java code remotely
    - Using Script Libraries
    - Recompiling all LotusScript
    - Writing formulas in the Programmer's pane
    - Using the Programmer's pane for Simple action(s)
  - XML for Domino
    The following topics cover some general guidelines for using XML in Domino applications and list all the elements, attributes, and entities in the Domino Document Type Definition (DTD):
  - JSP Custom Tag Libraries
    A JavaServer Page (JSP) is a HTML Web page that contains code which executes application logic to generate dynamic content. The page is created at the time it is requested. JSP pages are compiled into servlets; the code they contain is executed by the server. For more information on JSPs, see the Sun Microsystems Web site: http://java.sun.com/products/jsp/.
  - Programming Domino for Web Applications
    You should be aware of certain procedures, restrictions, and enhancements available to you when using Domino Designer to program Web applications. This section describes the following areas:
- 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.
- 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.

Programming an object's properties and events

Select the desired run-time platform and language, if available, from the Run menu.
Select the object's property or event from the Objects tab.
Type or paste code into the Script area.

Locating code within an object

To locate code within an object, click on the object in the Work pane. The pointer on the Objects tab jumps to the appropriate object. The code can be viewed by clicking the appropriate event. For example, to find code attached to a button, click the button in the Work pane, the Objects tab jumps to the button object place holder and displays the code attached to the click event. To find code attached to the onBlur event of a field, click the field in the Work pane, the Objects tab jumps to the field object place holder and displays the first coded event in the list. If the onBlur event is not the first coded event for the field object, you must click the onBlur event to display its code in the Script area.

Note: When you click from one object to another of the same type, the event selected for the first object is also selected for the second object. For example, if you click a field in the Work pane and select the Default Value event, then click a different field, the event selected for the second field is Default Value. Clicking objects of different types in the Work pane moves the Objects tab pointer to the first coded event for each object.

Color-coding event icons

All events that contain code are color-coded for the appropriate run-time platforms. An event coded to run in the Notes client displays a green icon. An event coded to run on the Web displays as a yellow icon. An event coded for both platforms displays half green and half yellow with a red dividing line down the center.

Determining the programming language at a glance

Each programming language recognized in the Programmer's pane has an icon related to it. These icons appear to the left of the object or event on the Objects tab. The following table shows the relationship of each icon to its respective programming language.


Programming language	Icon
Formula language
JavaScript
LotusScript
Simple Action(s)
System Command(s)