Home
HCL Domino Designer XPages User Guide
This guide focuses on the aspects of creating applications using XPages technology.
Administering applications
HCL Domino Designer provides features for administering and managing your work and related files while developing your application projects.
Source control in Domino® Designer
Source control operations are possible with Domino® Designer. The section provides all the information needed for using the source control enablement feature which makes this functionality available.
Completing common source control tasks with the Source Control Enablement feature
The basic steps of a general workflow are provided to give you an idea of how it works with the Domino® Designer source control enablement feature.

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.
  - Source control in Domino® Designer
    Source control operations are possible with Domino® Designer. The section provides all the information needed for using the source control enablement feature which makes this functionality available.
    - Source control enablement
      Source control enablement feature has been introduced to let you store NSF based design elements into a source control repository and perform common source control operations using Domino® Designer.
    - Prerequisite: Setting up the version source control system used with source control enablement
      This topic describes how to first setup a version source control system so that you can use the source control enablement feature.
    - Setting up the Source Control enablement feature
      The following topics provide information on initial set up tasks that need to be completed in order to begin using the Domino® Designer source control enablement feature as part of your day-to-day source control operations.
    - Completing common source control tasks with the Source Control Enablement feature
      The basic steps of a general workflow are provided to give you an idea of how it works with the Domino® Designer source control enablement feature.
      - Adding an existing Domino® Designer application into source control
        This topic describes how to add an existing Domino® Designer application into source control
      - Bringing in an application from source control
        This topic describes how to bring an application in from source control.
      - Associating an on-disk project with a new NSF
        This topic describes how to associate an on-disk project with a new NSF.
      - Associating an on-disk project with an existing NSF
        This topic describes how to associate an on-disk project with an existing NSF.
      - Example of associating an existing NSF with an on disk project
        This topic provides an example of associating an existing NSF with an on disk project.
      - Handling a file synch conflict
        This topic describes how to handle a file synch conflict with the source control feature.
      - Manually synching the NSF and local source control project
        This topic describes how to manually synching the NSF and a local source control project.
      - Removing associations in source control
        This topic describes how to remove NSF/project associations in source control.
  - Command Line Building of NSFs/NTFs - Headless Designer
    A command line build system has been added to Domino® Designer to let you build NSF and NTF files from source code repositories.
- 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.
- 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.

Completing common source control tasks with the Source Control Enablement feature

The basic steps of a general workflow are provided to give you an idea of how it works with the Domino® Designer source control enablement feature.

Since it is not within the scope of this documentation to explain every detail of basic source control operations for the various source control systems available, the basic steps of a general workflow are provided to give you an idea of how it works with the Domino® Designer source control enablement feature.

A general process could go something like this:

The proper source control plugins are installed into Designer.
Open a database in Designer.
Associate the database (NSF) with an on-disk project (ODP) and export from NSF to the ODP
Commit - send from the Designer ODP to the source control repository.
Checkout - from another machine, pull down the ODP from the source control repository.
Associate a database (NSF) with the ODP and import from ODP to the .NSF.
Modify the .NSF and/or ODP and sync the two (implicitly or explicitly).
Commit the changes to the source control repository.
Update to pull changes down from the source control repository to the ODP.
Sync the updated ODP with the .NSF

As a more specific example, a common tool uses the following basic procedure:

Share Project to add it to Source Control.
Checkout to create a local on-disk project from source control
Commit to send local changes to source control
Update to receive changes from source.

Note: Note: Refer to you source control software documentation for more details on how your system handles basic operations.

The next topics provide more detailed examples of using the Domino® Designer source control enablement feature to complete some of the common source control tasks just mentioned.