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.
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:
JavaScript
Domino objects

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
  - 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
      The formula language works, with restrictions, for Web applications. The formula language is particularly useful for implementing Notes client menu commands as buttons, hotspots, and actions in the browser environment where the Notes client menu is not available. This section describes:
    - Web agents
      Agents cannot run in a browser. They can be activated from a browser but run on the Domino server containing the agent.
    - JavaScript
      - JavaScript events
      - JavaScript in HTML
        You can use JavaScript anywhere HTML can be placed by using the standard SCRIPT LANGUAGE tag as shown.
      - JavaScript object model
        Domino supports the standard JavaScript object model. For information on the JavaScript object model, see http://developer.netscape.com/tech/javascript, http://developer.netscape.com/docs/manuals/js/client/jsguide, and http://msdn.microsoft.com/scripting.
      - Domino objects
        Examples: Domino objects
        These examples are on a page that contains one Java applet whose source code is:
    - Web services
    - Server configuration for Web browsers
    - RSS feeds
    - Domino Web logs (blogs)
- 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.

Domino objects

You can access through JavaScript the Domino Objects available through Java and CORBA. See Java/CORBA classes in Domino Designer Programming Guide, Volume 3.

Take the following steps:

On the form or page that will include the JavaScript code, create an applet that extends AppletBase. See Running a Java program and the associated examples in Domino Designer Programming Guide, Volume 3 for coding such an applet. See Including Java Applets in Applications in Application Development with Domino Designer for instructions on including applets on forms and pages. The applet can do anything. It is there just as a gateway to the Domino Objects.
In the Java Applets Properties box, select Applet uses Notes CORBA classes.
For Notes client deployment, select Enable Java access from JavaScript in the User Preferences box. Also click the Security Options button, then select the Java applet security radio button, and make sure Access to Notes Java classes is selected for the appropriate users.
For access to the classes through CORBA, make sure the Server record in the Domino Directory correctly records who can Run restricted Java/JavaScript and Run unrestricted Java/JavaScript in the IIOP Restrictions section under the Security tab.
In the JavaScript code, refer to the applet to access the classes and methods for the Domino objects. You first want to call AppletBase.openSession( ) or AppletBase.openSession (username, password) to obtain a Session object. For example, if the applet extending AppletBase is the first applet on the form or page, and a user name and password are not needed, the following code works:
```
session = document.applets[0].openSession()
```

You can then use the returned Session object to get at the other Domino objects. If you instantiate other Domino objects in the Java applet, you can use them directly in the JavaScript code.

In the Notes client, you can call AppletBase.getContext(Session) to get a NotesAppletContext object. This object contains the following methods: getServer( ) returns the name of the server containing the applet or a blank string for a workstation; getDatabase( ) returns the file path and name of the database containing the applet; getDocument( ) returns the universal ID of the document containing the applet or null if the document has not been saved.