Home
IBM Domino Designer Basic User Guide and Reference
Basic product usage information and programming language reference information.
Application Design
Welcome to the Application Design section of Domino® Designer Help.
Planning an application
Before you begin any design work, create a plan for how users will access and use your application. At the minimum, your application plan should address these questions:
Planning a traditional Web application
Perhaps your widest range of design options is available when designing an application that will only be accessed via a Web browser. You can build a Web application using the full range of Domino® Designer features and tools, or you can build an application using the latest Web technologies. This range of tools and features, coupled with all of the benefits of a Domino application -- such as the security model and replication -- give you the most control over the design and delivery of an application.
Creating formulas and buttons for the Web
To use certain @commands or create multiple form buttons for Web applications accessed on the Web, select the database property "Web access: Use JavaScript™ when generating pages" on the Database Info tab of the Database Properties box. To open the Database Properties box, open or select the database and choose File - Application - Properties.

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.
  - Introduction to Domino® Designer
    Welcome to Domino® Designer. Domino Designer is an integrated application development environment that lets developers and Web site designers create, manage, and deploy secure, interactive applications.
  - Planning an application
    Before you begin any design work, create a plan for how users will access and use your application. At the minimum, your application plan should address these questions:
    - Planning a traditional Notes® application
      If your application is only intended for use by Notes® clients, use the standard design elements provided by Domino® Designer. When programming, consider using the Notes formula language and LotusScript®, both of which were designed for use with the Notes client.
    - Planning a traditional Notes® and Web application
      If you are planning an application that users will access via a Notes® client or via a Web browser, you will need to do some design work to tailor your application for each platform. For example, a navigation structure that is suited for a Notes client application may not be the best choice for a Web application. When you design an application for both Notes and Web, about 85% of your design will be suitable for both clients, and the remaining 15% will require some modification. Here are some issues to consider when planning an application for Notes and Web users:
    - Planning for integration with WebSphere® and DB2®
      You can use Domino® Designer to build applications that exploit the collaborative features of the Domino server as well as the transactional power of the WebSphere® server and the data storage capacity of a DB2® database, resulting in end-to-end business solutions for applications such as supply chain management, sales force automations, or customer relationship management.
    - Planning a traditional Web application
      Perhaps your widest range of design options is available when designing an application that will only be accessed via a Web browser. You can build a Web application using the full range of Domino® Designer features and tools, or you can build an application using the latest Web technologies. This range of tools and features, coupled with all of the benefits of a Domino application -- such as the security model and replication -- give you the most control over the design and delivery of an application.
      - Tips for designing Web applications
        Databases viewed from a Web browser may look somewhat different than they do when viewed from the Notes® client. Browsers render design elements with slight differences. Be sure to preview your database through each browser that will access it so that you can make adjustments to your design. Also, for databases that will be accessed through Web browsers, it is best to:
      - Creating formulas and buttons for the Web
        To use certain @commands or create multiple form buttons for Web applications accessed on the Web, select the database property "Web access: Use JavaScript™ when generating pages" on the Database Info tab of the Database Properties box. To open the Database Properties box, open or select the database and choose File - Application - Properties.
      - Enabling enhanced HTML generation
        Enhanced HTML generation provides support for Classic web themes, XML compatible HTML, closable HTML tags, no minimized attributes, and auto classes.
    - Planning a composite application
      A major new enhancement in Notes® Release 8 is the support for composite applications, a key element within IBM's service oriented architecture (SOA) and contextual collaboration strategy. Using Domino® Designer, developers can extend Notes applications to be Notes components in composite applications. A composite application can include any combination of Notes components and Eclipse components. The ability to combine multiple technologies into a single application provides significant business value: It enables companies to protect and extend their existing assets with increasing degrees of flexibility, and to respond quickly and cost effectively to their emerging business requirements, with applications that are significantly easier to assemble than alternative application development environments.
    - Planning an application for mobile users
      You may want an application you design for Notes® or Web users to be available to mobile users. You can easily tailor an existing application for mobile users by excluding certain design elements from a mobile application to streamline it for better performance. For example, you may to exclude a large, complex view or a graphical navigator from the design elements that get served to mobile users to avoid performance problems.
    - Hide-when options for all applications
    - HTML tag attributes for a Domino® server
      The HTML tab appears on many properties boxes. If you are designing a Web application and are using HTML 4.0, the HTML tab lets you apply core attributes that are common to a number of objects, such as Cascading Style Sheet (CSS), easily. Domino® incorporates the values of these attributes in the HTML that it creates at runtime. When you are using the HTML tag attributes, remember:
    - Domino® applets
    - Designing an application for maximum accessibility
      When designing an application, there are things you can do to make your application accessible to people with physical disabilities. To meet federal accessibility guidelines, your application must be:
    - Creating multilingual applications
    - Table of Notes® and Domino® known limits
      The following table summarizes the known maximum limits of various Notes® and Domino® features.
  - Creating an application
    All Domino® applications begin with a Domino database. Domino databases are the containers for your application. Databases hold the data, logic, and design elements for your application. Your Domino application can be made up of one or more Domino databases.
  - Designing pages
    Pages and forms are similar in certain ways. A page is a database design element that displays information. Pages can be used anywhere in your application that you have text, graphics, or an embedded control, such as an outline, to present to the user. A page or form can contain the following:
  - Designing forms
    Forms, like pages, display information. Everything that can be done with a page can be done with a form. What sets forms apart from pages is that forms can be used to collect information. A form provides the structure for creating and displaying documents, and documents are the design elements that store data in the database. When a user fills out the information in a form and saves it, the information is saved as a document. When a user opens the document, the document uses the form as a template to provide the structure for displaying the data.
  - Designing fields
    A field is the part of an application that collects data. You create fields on forms, subforms, or in layout regions. Each field stores a single type of information. A field's field type defines the kind of information a field accepts, such as text, numbers, dates, or names. When a user, either in a Notes® client or a Web browser, creates a form, fills out the information in the fields, and saves the form, the data in the fields is stored in an individual document. The contents of the fields can then be displayed in documents and views or can be retrieved for use in formulas. A field can be used on a single form, or you can create shared fields for use in multiple forms in a database.
  - Designing framesets
    A frameset is a collection of frames and can add structure to your Web site or Notes® database. A frame is one section, or pane, of the larger frameset window and is independently scrollable.
  - Designing views
  - Designing navigation for an application
    You can use the following navigational tools in your application:
  - Adding automation to applications
    Automation in an application speeds up repetitive tasks, handles workflow, updates information, performs calculations, runs programs, and checks for errors.
  - Developing applications using third-party tools and WebDAV
    As you are developing an application, you may want to supplement the tools provided with Domino® Designer with tools of your own choosing. For example, you may have a favorite graphics editor you use to design images for your application, or you may have a favorite HTML editor that you want to use to design pages. You launch and use third-party tools from within Designer.
  - Connecting to enterprise data
    Incorporating back-end data into everyday business processes maximizes the value of a Domino® Designer application. Designer includes a range of technologies for the security and control of business processes, forms routing, and approvals management. With enterprise integration technologies, you can incorporate traditionally difficult-to-reach data into your business applications.
  - Including Java™ applets in applications
    Applets are self-contained Java™ programs that can run in your Domino® application. Java applets are often used to add animation to Web applications. Although Java applets are mostly used for Web applications, you can also include them in the following elements of a Domino application:
  - Including Java™ servlets in Web applications
    A servlet is a Java™ program that is run by the Domino® Web server in response to a browser request. Servlets provide a convenient way to add powerful functionality to your Web application. In some ways, servlets act like CGI programs, but they are more tightly integrated with the server and can take advantage of special Java classes. For example, a servlet may connect to a relational database or enterprise system and get data in response to a Web browser request.
  - Including XML in Designer applications
    Extensible Markup Language (XML) is a standard for creating markup languages that describe the structure and meaning of data in a document. XML separates the content of a document from its presentation and provides a common format for transferring data across the World Wide Web (WWW) or company intranet. The result is a technology that makes data available regardless of the proprietary systems involved.
  - Including OLE objects in applications
    Using Object Linking and Embedding (OLE) and OLE tools lets you extend the capability of Domino® Designer. OLE technology lets you integrate data from other applications, such as spreadsheets, graphics tools, and other data sources, into your application.
  - Creating a workflow application
    Workflow applications let you automate tasks. These tasks most often involve automatically sending mail messages or automatically routing documents, such as tracking orders and project plans to be reviewed. All projects need one or more people to complete a series of tasks and can benefit from workflow applications because they guide the project through these tasks automatically. Workflow applications reduce overhead and errors, speed processes, and track the status of a project. For example, a workflow application might automatically send a document in a publishing company from writer to editor to proofreader to production. At each stage, an individual is responsible for specific tasks related to that document. Once the task is complete, the workflow application ensures that the individuals responsible for the next task are notified and receive the data they need to execute their part of the project.
  - Domino® Designer templates
    The templates described in the following table are available with Domino® Designer and are specifically intended for use by application developers.
  - Importing to and exporting from views
  - Developing applications using MAPI
    Domino® Designer Release 6 and later supports the messaging application program interface (MAPI), which allows mail integration between Domino and a MAPI-compliant messaging application, such as Microsoft™ Outlook, Microsoft Office applications, or user-written C++ programs.
  - Features to avoid using in Web applications
    Developers creating applications specifically for the Web, or for the dual purpose of serving Notes® and Web clients, should review the following tables for features that are not supported on the Web.
  - URL commands for Web applications
    You have a variety of options for programming a Web site. You can directly manipulate objects such as documents or views in an application using Domino® URL commands. Adding Domino URL commands as HTML in forms gives users shortcuts for navigating databases and performing other tasks quickly.
- 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.
- 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.

Creating formulas and buttons for the Web

To use certain @commands or create multiple form buttons for Web applications accessed on the Web, select the database property "Web access: Use JavaScript™ when generating pages" on the Database Info tab of the Database Properties box. To open the Database Properties box, open or select the database and choose File - Application - Properties.

Note: There is no Web Formula module in the new dual platform event model. If you write Client Formula code to perform an action in a Web application, check the Hide option "Notes® 4.6 or later clients" on the Hide tab of the properties box for the element you are programming.

Web application performance tips

Selecting the "Web access: Use JavaScript™ when generating pages" affects display, buttons, and @commands throughout the application in the following ways:


If you select "Use JavaScript™"	If you don't select "Use JavaScript™"
Display: Documents and navigators display faster because hotspot formulas are not evaluated until users click each hotspot.	Display: Documents and navigators display more slowly because the hotspot formulas are all evaluated at the display time.
Buttons: Domino® doesn't generate a Submit button automatically.	Buttons: Domino® automatically generates a Submit button, at the end of the form.
To allow users to save and close a form on the Web, you must create a button, hotspot, or action that contains these commands: @Command([FileSave]); @Command([CloseWindow])	If there is already one or more buttons on the form, Domino® converts the first button it recognizes to a Submit button automatically and ignores all other buttons on the form.
You can have multiple buttons on a form.	You can have only one button, a Submit button, on a form.
@Commands: The following commands are supported on the Web: @Command([CloseWindow]) @Command([FileSave]) @Command([ViewRefreshFields])	@Commands: The following commands are not supported on the Web: @Command([CloseWindow]) @Command([FileSave]) @Command([ViewRefreshFields])
Domino® does not check the formulas before displaying pages.	Domino® checks the formulas before displaying pages. Actions that contain unsupported @commands or @functions will not be displayed on the Web.