Home
HCL Domino Designer User Guide and Reference
This guide provides information on using HCL Domino Designer and programming language reference information.
Application Management
Welcome to the Application Management section of Domino® Designer Help.
Completing an application and managing design changes
As you prepare to deploy an application, consider these finishing touches:
Creating and displaying more detailed application Help

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.
  - Security in an application
    Domino® offers a multi-layered approach to security. Server administrators can secure databases, servers, and domains. Database designers and managers control the following:
  - Completing an application and managing design changes
    As you prepare to deploy an application, consider these finishing touches:
    - Creating a database icon for a Notes® application
    - Providing online Help for an application
      Including Help with your application improves the chances that users will understand how to use it without asking for individual Help from you or a coworker. Database Help can be integrated throughout the application so that users have information as they need it.
    - Creating Using This Applicationand About This Application documents
    - Creating context-sensitive Help for an application
      You can make an application's Help documents or pages context-sensitive so that users can open them by pressing a key, such as F1, or by clicking a Help button. You can associate a Help document or page with each page, form, subform, view, and folder in an application.
    - Writing Help for fields
    - Creating and displaying more detailed application Help
    - Specifying a home page in the Web site document
      To make a design element the site home page, open the Web site document. Specify a URL that includes the design element in the "Home URL" field.
    - Restricting design changes
      Once an application is complete and available, you decide how to protect the design from changes. An application can have a totally open design, where users can update forms and views and pass along design changes. Or an application can have a totally closed design, where users use the application "as is" and have no access to design elements.
    - Checking the application design before release
      After you complete the design, test the application and correct problems before you release it.
    - Checking form design
      For each form you want to check, create two or three documents and enter a variety of information into the fields. Then use this check list to verify that the form is working as intended.
    - Checking field design
    - Checking view design
      Once the database is complete, make sure the design is working. For testing purposes create a view that uses @SELECTALL to select all documents. Follow these guidelines to check view design.
    - Making a design copy of a completed application
    - Pilot testing an application
    - Renaming a database
    - Renaming design elements
    - Design synopsis
    - Updating documents after redesigning a form
      When you redesign a form, be aware of the effect on existing documents. Some form changes, such as formatting changes, automatically display when users open an existing document. Other changes, such as adding a new field, do not affect the contents of existing documents until you update the documents manually or by running an agent.
    - Checking field values in a document
    - Using agents to update documents affected by form changes
      To update multiple documents affected by form changes, use an agent. To do so, it is best to create private agents and run them manually.
    - Changing database and design properties
    - Setting application launch properties
    - Templates
    - Making and distributing design changes
      When you need to redesign an application, make and distribute the changes in one of these ways:
    - Refreshing a design
    - Replacing a design
    - Design changes and replication
      Unless you distribute design changes through templates, design changes and any document updates made in one database replicate directly to replicas, as long as servers have Designer access or greater in the database ACL. To avoid replication conflicts and unexpected changes, only one person -- the database designer or manager -- should make design changes to only one database and maintain its design. Then let replication distribute the design changes to other replicas.
    - Preventing design changes
    - Modifying multiple design elements
    - Hiding the design of a database
    - Hiding design elements
    - Locking a design element
  - Deploying an application
    The tasks involved with application design, database design, database management, and DominoTMsystem administration may overlap, depending on the size of your organization and the structure of job responsibilities. In some organizations, an application developer may be responsible for both application and database design, while in others, a database manager may handle all database design and management tasks. In addition, database management overlaps with Domino® system administration.
  - Procedure for optimizing and troubleshooting databases
- 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.
- 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.

Creating and displaying more detailed application Help

About this task

In a complex application, an "About Database" document and a "Using Database" might not provide enough documentation. To provide detailed documentation for an application, design a Help form as part of the database and display documents created with that form in a Help view. The following steps describe one way to achieve this.

To create a Help form

Procedure

Create a new form called "Help" and create fields for Help content.
Choose Design - Form Properties.

In the Name box, type a name and alias for the form (for example, Main Topic | Interview). For more information on naming a form, press F1 on the Form Info tab.
Select "Event: Window Title" and enter "Help" as the window title text in the formula window.
Save and close the form.
Choose Create - Help for each Help document.
Click the form you're designing and choose Design - Form Properties.
Deselect "Include in Menu."
Click the form, and then save it.
Create a view that displays the Help documents.

Results

Note: You can also create a separate Help database and open its documents from your application using @Command(OpenHelpDocument). To open documents from a Help database in a window that users can set to overlay other windows as they work, choose File - Application - Properties - Design for your database. Then, turn on "List in Database Catalog" and enter the category "NotesHelp."