Home
HCL Domino Designer User Guide and Reference
This guide provides information on using HCL Domino Designer 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
Writing formulas in the Programmer's pane
Using the formula window

HCL Domino Designer User Guide and Reference
This guide provides information on using HCL Domino Designer and programming language reference information.
- What's new in Domino Designer 14?
  The following features are new for developers in HCL Domino® Designer 14.
- What's new in Nomad Designer?
  HCL Nomad for web browsers v1.0.10 introduces the capability to design Notes databases. For more information, see HCL Nomad for web browsers User Documentation, Nomad web Designer.
- 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.
  - 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:
    - 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 formula window
    - 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.
- 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.

Using the formula window

About this task

The Formula Window appears anywhere you can enter a formula outside of the Programmer's pane. When entering a formula in the Formula window, you can:

Enter it directly into the small white area on the Hide When tab of a properties box.
Click Formula Window or Zoom to open a larger Formula Window.

To enter a formula in the small Formula window

Procedure

Open a screen containing a Formula Window.
Enter your formula in the Formula window. A check mark and an X appear next to the Formula window when you begin typing. Click the check mark to accept any changes you have made. Click the X to undo any changes made prior to clicking the check mark.
If you receive syntax error messages, edit the formula until the errors are corrected.

To enter a formula in the large Formula window

Procedure

Open the properties box of a design element.
Select the Hide When tab.
Select Formula Window to display a larger Formula window.
To select @functions and fields from a list, select Formula Window, then select "Fields and Functions."
Type your formula.
Click Done.
If you receive syntax error messages, edit the formula until the errors are corrected.

Results

To delete a formula, highlight the formula and press DEL.