Setting up the sample application

During the course of the tutorial, you create three XPages named Site, SiteFinder, and SiteList. When you first open the sample application, you see existing XPages with similar names. Three of them are final solutions and are named SiteFinal, SiteFinderFinal, and SiteListFinal. Two of them are intermediate solutions and are named Site1 and SiteList1.

About this task

Launch HCL Domino® Designer and do the following steps:


  1. From the menu, click File > Application > New (Ctrl+N).
  2. In the New Application window, do the following steps:
    1. Leave the Server selection as Local.
    2. Type a title, for example, Site Finder Demo.
    3. Accept or modify the filename, for example, SiteFinderDemo.nsf.
    4. Optional: Click Encryption. Select Do not locally encrypt this database and click OK.

      This step allows other Notes® users to access the application locally, for example, if you mail it to someone. In general, you should encrypt real applications to secure them. Local encryption does not prevent the application from being shared through replication to a server.

    5. Select Create a full text index for searching. You need this later.
    6. Leave the template server selection as Local.
    7. Select Show advanced templates.
    8. In the template list, select Site Finder Demo.
    9. Clear Inherit future design changes.
    Here is what the New Application window should look like.

    New Application window
  3. Click OK.

    Domino Designer creates the new application and its elements display under Applications on the left side of the screen. Expand the elements to explore the design of this application.

  4. Expand Code and double-click Agents. In the list of agents, right-click Create sample data and select Run.

    This agent creates several sample records which you use to test the application. Respond to any dialog boxes. Click the X in the corner to close the pane containing the list of agents.

  5. Expand XPages and double-click SiteFinderFinal (the final solution for SiteFinder).
  6. Click Design > Preview in Web Browser > Default System Web Browser or select a specific browser from among those listed.

    A mini Web server running on your computer opens a browser, generates HTML for the XPage, and sends the page to the browser using localhost for the server name.

    If your computer is not set up to use localhost, the preview URL fails. Open a browser and use or the actual IP address of your computer in the URL, for example,

  7. Specify a value in the Zip code field (for example, 02108) and click Search.

    This step submits the page to the server. The server processes the information from the page and sends another page to the client.

  8. Close the browser when you are done.
  9. In Domino Designer, close the XPage element by clicking the X on its tab.

    The appearance varies. If a pane has more than one tab, you see an X on a tab. If a pane has just one tab, it displays as a window with the X in the corner.


Feel free to explore the application by previewing the XPages with Final in the name. These XPages are the final version of what you are designing as you go through the tutorial.