Home
HCL Domino Designer XPages User Guide
This guide focuses on the aspects of creating applications using XPages technology.
Designing XPages applications
HCL Domino® Designer provides the means to populate an XPage with controls and other artifacts, and to associate an XPage with data stores.
Previewing and running XPages
XPages run in Domino® server and Notes® client environments. From Domino Designer, you can preview XPages in both environments.
Previewing an XPage
You can preview an XPage in a Domino® server or Notes® client environment.

HCL Domino Designer XPages User Guide
This guide focuses on the aspects of creating applications using XPages technology.
- Product overview
  HCL Domino® Designer supports applications development for the HCL Domino platform using XPages, forms, views, and other elements such as controls.
- Tutorials
  This section contains tutorials and information about tutorials.
- Administering applications
  HCL Domino Designer provides features for administering and managing your work and related files while developing your application projects.
- Designing XPages applications
  HCL Domino® Designer provides the means to populate an XPage with controls and other artifacts, and to associate an XPage with data stores.
  - Previewing and running XPages
    XPages run in Domino® server and Notes® client environments. From Domino Designer, you can preview XPages in both environments.
    - Previewing an XPage
      You can preview an XPage in a Domino® server or Notes® client environment.
    - Opening an XPage upon application launch
      You can open an XPage upon application launch.
    - Opening another XPage
      From an XPage, users can open other XPages through navigation rules, a simple action, XSPContext methods, and opening the URL.
    - Opening an XPage instead of a view
      For Web access only, you can open an XPage instead of a view.
    - Signing XPages
      XPages are signed with the ID of the current Domino® Designer user upon saving the XPage design element, and/or upon generating its implementation (i.e .class) file(s).
    - Using XPages in the Notes® client
      You can run XPages applications in the HCL Notes® rich client.
    - Designing single copy XPages
      You can store XPage design elements in one database and redirect other databases there at run-time.
    - Creating accessible applications with XPages - an overview
      For Domino® developers creating Web applications, XPages is the recommended accessible solution.
    - Specific accessibility guidelines for XPages
      Making sure that an XPages application and controls are accessible.
  - Adding controls
    Controls are visual elements such as edit boxes, buttons, images, and text that allow users to manipulate data on an XPage.
  - Adding controls from the XPages Extension Library
    The XPages Extension Library provides additional controls ready to use. The controls include an application layout object, an improved dialog, pickers, in place forms, Dojo components, dynamic content, and much more. The controls support enhancements to the Domino(r)® templates.
  - Binding and submitting data
    The data store for XPages is Domino®. You can access the data store through Domino forms and views.
  - Adding images, styles, and themes
    You can enhance your design with images, styles, and themes.
  - Responsive web design support in XPages
    The XPages Extension Library supports Bootstrap, a Responsive Web Design (RWD) framework. This support comes in the form of an XPages Responsive Bootstrap plugin that you can use in your XPages applications.
- Designing composite applications
  You can create composite applications from XPages.
- Programming
  XPages uses JavaScript™ for programming while the forms-based design elements use the formula language, LotusScript®, Java™, and JavaScript.

Previewing an XPage

You can preview an XPage in a Domino® server or Notes® client environment.

Before you begin

For a Web preview, you must first adjust the access control list (ACL) for the application. Right-click the application in the navigator and select Application > Access Control. Add an entry for Anonymous and set an appropriate level of access (at least Author with the ability to create documents).

Note: Also, make sure that the HTTP task is running on the Domino® server in order to successfully perform a Web preview.

Procedure

Right-click an XPage and select Preview in Notes or Preview in Web Browser.
Alternatively, with focus on an XPage, you can click Design > Preview in Notes or Design > Preview in Web Browser on the menu.
Alternatively, with focus on an XPage, you can click the Preview in Notes or Preview in Web Browser icon on the tool bar.
For Preview in Web Browser, select the browser type.

Results

A Notes® preview starts the Notes® client if necessary then opens the XPage in the client. The client handles requests from the XPage.

A Web preview starts a Domino® local preview server then opens the XPage in a browser. The local preview server handles requests from the XPage.

Previewing an XPage on the Web may differ from running the XPage in the context of the full application. Results may also depend on whether you are previewing a local or remote application. Previewing a local application always uses Anonymous for access control, and the local preview server lacks some advanced functions of a production server. However, scripts run and documents are created, signed with Anonymous for local previews and with the current ID for previews on a server, giving you a realistic look at the application.