New Lotus Domino Designer 8.5 client features - IBM Lotus Notes

In this section, we will explore the new features in Domino Designer 8.5. There are many exciting changes and additions to Domino Designer 8.5. The first feature we will cover is the introduction of the Eclipse-based integrated development environment. Domino Designer 8.5, which is also known as Domino Designer on Eclipse (DDE), takes advantage of Eclipse technology to deliver a more powerful developer environment. The look and feel is more consistent with Notes client version 8.x, with the features and flexibility one would expect of an Eclipse-based IDE. The new UI will be examined at a high level. The next major feature addition that will be covered is XPages. XPages are a new type of design element being introduced in the 8.5 release that will revolutionize Domino Web Applications. XPages enable application developers to quickly and easily create rich Domino web applications with a Web 2.0 look and feel. Finally, we will review improvements to CSS support, enhancements to HTML generation, JavaScript controls, a new method related to ID Vault called Reset User Password and changes to web services.

Domino Designer on Eclipse

Now in 8.5, the Domino Designer client is based on Eclipse, as the Notes client was in 8.x. Eclipse is an award-winning, open source platform for the construction of powerful software development tools and rich desktop applications.

This architectural change allows the new designer client to become an open source pluggable environment. By allowing the use of plugins, objects can be built, re-used, and shared. Some of the differences in the new 8.5 Designer client can be seen when examining the processes associated with Domino Designer. It is useful to know how they relate to one another and what component each controls. Prior to release, 8.5 designer clients, when you launched designer.exe, nlnotes.exe would be spawned. This is the process for the releases prior to 8.5 Domino Designer.

Now, in the 8.5 Designer client, designer.exe loads and spawns nlnotes.exe.

Then the notes2.exe process spawns and designer.exe quits.

Finally, nlnotes.exe spawns ntaskldr.exe after Domino Designer on Eclipse(DDE) opens. Some other things you may notice is that it takes longer to launch and exit DDE than in previous versions. This is due to the Eclipse startup and shutdown sequences. This can lead to problems on exit or launch. If you experience a problem with launch or exit, it may be due to one of the following issues. Due to the longer exit time, the user may have initiated the launch before all prior processes had been killed, or the user may have initiated the launch sequence multiple times. It is also possible that, on prior exit, the client did not shut down all processes.

With a few exceptions, the launch process will be able to compensate for these errors. However, if you still can't launch or exit the 8.5 designer client, you can manually kill the nlnotes.exe and notes2.exe processes with the task manager, or if the client still will not launch or exit, log out of the system to completely kill all process threads.

The new Eclipse-based GUI

Now that the 8.5 Designer client is Eclipse based, there is a new GUI. The default perspective in 8.5 is the Domino Designer perspective. A perspective contains editors and views specific to that task. There are other perspectives available in Domino Designer 8.5, each suited to a particular task. You can select a different perspective from the menu, by selecting Window | Open Perspective | Other, as seen in the following screenshot:

The new Eclipse-based GUI

Not all perspectives have a corresponding layout in the GUI.

Perspectives can be customized to suit individual preferences. One way is by resizing the views and editors.

You can resize views and editors in two ways. They are as follows:

  • Click the Maximize/Restore button located in the title bar of the view or editor, as shown in the screenshot that follows
  • Click and drag the border of a view or editor

Title bar of the view or editor

Views and editors can also be hidden by clicking on the Close button:

Views and editors can also be hidden by clicking on the Close button

In the menu, select Window | Show Eclipse Views to re-open closed views (as shown in the following screenshot). You can use this menu to open any Eclipse view, including those from other perspectives:

Eclipse Views to re-open closed views

To return to the current perspective's default layout, select Window | Reset Perspective...:

current perspective's default layout,


For a while now, it has been difficult to create elegant web applications for Notes/Domino. XPages are a new type of design element being introduced in the Notes Domino 8.5 release, that will allow application developers to quickly and easily create rich Domino web applications with a Web 2.0 look and feel.

Applications built using XPages are supported for web use only, for the 8.5 release. Starting in Lotus Notes 8.5.1, XPages are also supported on the client. To enhance the appearance and functionality for web use, existing applications can be extended to utilize XPages. The standard design elements must be included in the database for use in the Notes client and the application. If a new application is targeted for both the Notes client and web users, then you can also include XPages for use on the Web. XPages are built on top of Java Server Faces (JSF). XPages also have built-in AJAX support, which allows application developers to take advantage of AJAX features such as type-ahead and partial page refresh. They are created in pure XML markup. When the application developer adds controls to XPages using drag and drop, the XML is generated automatically.

XPages do not require any additional steps to install on a Domino server. When you create a new XPage in an application, you start with a blank page similar to what you see when a new form or page is created. You then build the XPage by dragging and dropping controls onto the XPage to add functionality. A wide range of controls are available out of the box, which enables application developers to quickly and easily get a web application up and running. Some examples of the controls available are a pager, rich text editor, date picker, tabbed panel, and many more. Controls can also be combined into a single object, called a custom control. Custom controls are similar to subforms, as they can be used in other XPages in the current application, or copied into other applications for reuse. Just like with subforms, if a change is made to a custom control in an application, that change is propagated out to all other instances of that custom control in that application.

There is a default system template in the 8.5 release that uses XPages. The discussion template has been enhanced to include XPages in 8.5:

Include XPages in 8.5

Improvements to Cascading Style Sheets (CSS) support

In Domino Designer 8.5, you can edit and create CSS. Previously, you would have had to use an external editor to do this. Not only can you create custom stylesheets, but you can import existing ones. You can also group your favorite stylesheets and script resources into a theme to provide a common look and feel in your application and map style classes to UI controls. This will save developer time and effort when adding CSS to applications.

To create a new stylesheet, go to File | New | Style Sheet Resource from the main Eclipse menu. In the New Style Sheet dialog box, do the following:

  1. In the Name field, type the name of the stylesheet, as shown in the
  2. name of the stylesheet

    following screenshot:

    By default, Domino Designer adds a CSS file extension to this name.

  3. In the Application field, select an application for the stylesheet. Click on the OK button.

Another method of creating a stylesheet, is by double-clicking on Style Sheets under Resources in the Applications Navigator and then clicking on the New Style Sheet in the editor.

Enhancements to HTML generation

With the 8.5 Domino Designer, the new enhanced HTML-generation option can be used to leverage a CSS, via a theme, to enhance the look and feel of a traditional Notes application. There is limited support for this functionality in XPages themes. One function that is supported is that HTML pages will include references to the text/CSS resources defined in the theme. Another functionality that is supported is that the body control style property (as defined in the theme) is included in the body tag class attribute. What is not supported is the ability to search for theme design notes beyond the current database or theme inheritance.

To enable this functionality, select the database and go to Design | Design properties. Go to the Web access section of the Database properties box and select Enable enhanced HTML generation:

Enhancements to HTML generation

JavaScript controls

The JavaScript control enhancements in Domino Designer 8.5 focus on the controls for the rich text fields on the Web. Starting in 8.5, you can enable the display of rich text on the Web as a Dojo-based JavaScript control. The Dojo Toolkit is an open source modular JavaScript toolkit designed to ease the rapid development of cross platform, JavaScript/AJAX-based applications and websites. The Dojo-based mechanism uses standard HTML and CSS, so the benefits are similar to using an applet.

To use this new option, go to Comment a rich text field and choose Design | Field Properties. On the Info tab, for Web Access select Using JavaScript Control:

JavaScript controls

The following screenshot is of the Rich Text Editor with this option selected:

Rich Text Editor

Using the JavaScript control, these are now available options for editing, redo, strike through, changing the foreground color, and changing the background color. Table operations, such as delete row, add row, and so on, are not available when using the JavaScript control, but are available when using the preview setting.

New methods related to ID Vault— ResetUserPassword

There is a feature introduced in Notes/Domino 8.5 that allows Domino administrators to manage users' ID files with less effort, called the ID Vault. Domino 8.5.3 Enhancements. In Lotus Notes Domino 8.5, a new method was added, called ResetUserPassword. This new method allows you to leverage the ID Vault feature in custom applications. It can be used to reset the password and download count on an ID file stored in the ID Vault and to set both the password and download count.

Using this method, a developer is able to design an application for the help desk to perform password resets, or a self-serve application that end users can access to reset their passwords.

Lotus Notes Domino 8.5 comes with a sample self-service application, called PwdResetSample.nsf, which uses the new method in a LotusScript agent that you can customize for your needs. In order to run this method from a LotusScript agent or Java agent, you must provide password reset authority with the "Self-service password reset authority" flag to a user identity that has signed the agent. It is recommended that one is registered specifically for this purpose. The server on which you deploy the agent must also have this authority and must give the agent signer Run restricted LotusScript/Java agents access. You must provide password reset authority with the "Self-service password reset authority" flag to the user or server identity under which the application is authorized to run, when the ResetUserPassword method is used in a non-agent application. To set the access, switch to the Configuration tab in the Administrator client and select your ID Vault under Security | ID Vault. Then go to Tools | ID Vaults | Authority to Reset Passwords.

Set both the Vault Administrator (your Server Administrator) and your Domino Server as self-service password reset authorities:

Vault Administrator

Changes to web services

Prior to Domino 8.5, Web Services were treated as a single entity. In Domino 8.5, web services are differentiated between two entities, web service providers and web service consumers. While the categorization and handling has changed a bit, the underlying data is backward compatible. Any web services that you created in a previous version will be displayed as a web service provider in Domino 8.5. In Domino Designer 8.5, a fundamental shift in object creation has occurred. To create an object, a name for the object is now required. The object is then saved in the application as soon as it is created and displayed back to the user.

In previous versions of Domino Designer, web services looked something like what is shown in the following example from Domino Designer 8.0.1. The following screenshot shows where Web Services in the Shared Code folder of a database can be located:

Changes to web services

In Domino Designer 8.5, Web Service Providers and Web Service Consumers items are now found under the Code folder. Selecting the Web Service Providers item in the navigator brings up the Web Service Providers list as shown in the following screenshot:

Service Providers list

What's ahead?

As you know, Domino Designer is used to create Notes/Domino applications. You have seen how it can be used to take a Notes application and build components from the various Notes/Domino design elements using the Property Broker Editor and the Composite Application Editor, and new integration points with actions and view columns.

Future plans for Domino Designer may include merging it with Lotus Component Designer within an Eclipse framework, bringing the two designer tools together into an integrated development framework for Lotus applications. All development will be performed within the Eclipse environment with new script editors and shared design element bookmark navigation:

Eclipse environment with new script editors

Bringing these multiple development tools under a single designer framework will make the developer's job easier by offering them a consolidated view of the development process.

All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd Protection Status

IBM Lotus Notes Topics