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.
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:
Web services
Web services on a Domino server
A Web service must exist in a database on a Domino server to be used. Replication is a simple way to move locally designed Web services to servers. Web services on production servers should be properly protected by appropriately signing the Web service and setting the Security tab.

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.5?
  The following features are new for developers in HCL Domino® Designer 14.5.
- 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
  - 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
    - Web services
      - Web services terminology
        A Web service is a self-contained, self-describing, modular application, based on XML, that can be published to and invoked from the Web. Domino Web services are based on the following W3C standards:
      - Web services in Domino Designer
        The Web Service Provider design element exists under "Code" in the Applications Navigator. The design element has a properties box with Basics, Security, and Advanced tabs, and an editor pane. The functional part of a Web service is a compiled program. A Web service also maintains a WSDL document that reflects the program interface. An imported WSDL document is maintained as is. If coding changes affect the interface, the WSDL document is regenerated when a Web service is saved. Note that when the WSDL document is regenerated for a LotusScript Web service, all LotusScript identifiers which become WSDL names appear in upper-case. This is because LotusScript is a case-insensitive language, and identifier names are maintained internally in uppercase only.
      - Previewing Web services
        Web services can be previewed locally before being released. Unlike local previews of forms and views, which simply allow a designer to view the form or view, a local preview of a Web service has two distinct parts. First, a simple form is presented for viewing, which contains a link to the WSDL document for the web service. That link is the complete description of the service as it was designed. In addition, the web server is started on your workstation in preview mode and is able to handle SOAP requests sent to it from any other program on the same machine. Therefore development tools can be used to develop the client-side of the web service.
      - Creating web service consumers
        Version 7.0 introduced the Web Service design element, which lets you write a web service and host it on your Domino server, so that it can be called from other computers.
      - Web services on a Domino server
        A Web service must exist in a database on a Domino server to be used. Replication is a simple way to move locally designed Web services to servers. Web services on production servers should be properly protected by appropriately signing the Web service and setting the Security tab.
      - Java and LotusScript mappings
      - Examples: Web services
      - Examples: Web services data descriptions
      - Web services Java and LotusScript classes
    - 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.
- 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.

Web services on a Domino server

A Web service must exist in a database on a Domino server to be used. Replication is a simple way to move locally designed Web services to servers. Web services on production servers should be properly protected by appropriately signing the Web service and setting the Security tab.

To invoke a Domino Web service, a consumer uses the Domino URL command for opening the design element in a SOAP-encoded Web services HTTP POST request. Domino executes the appropriate implementation code based on the request and sends a SOAP-encoded response to the consumer.

The syntax for the Domino URL command for a Web service is as follows:

http://servername/databasename.nsf/webservicename?OpenWebService

If you send the URL command for opening a Web service to a Domino server in an HTTP GET request (for example, by typing the command in a browser), Domino responds with the Web service's port name and the names of the operations for the port.

The following Domino URL command retrieves the WSDL document for the Web service in response to an HTTP GET:

http://servername/databasename.nsf/webservicename?WSDL

The SOAP address for a Web service is the Domino server responding to the WSDL URL command. The SOAP address in a WSDL document generated by Domino Designer is not valid because the Web service is not properly exposed on a server at that time.