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.
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.
Before you begin: Creating associations between on-disk projects and NSFs
The source control enablement feature requires you to create an association between an on-disk project managed by the source control and the virtual NSF based project that Designer uses.

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.
      - Before you begin: Creating associations between on-disk projects and NSFs
        The source control enablement feature requires you to create an association between an on-disk project managed by the source control and the virtual NSF based project that Designer uses.
      - Associating the NSF with an existing on-disk project
        The source control enablement feature lets you create an association between an existing on-disk project managed by the source control and the virtual NSF based project that Designer uses.
      - Setting the direction of the initial synchronization operation
        This topic explains the directions available for the initial synchronization operation that occurs when creating the association between an NSF and an on-disk project.
      - Associating the NSF with a new on-disk project
        The source control enablement feature lets you create an association between a new on-disk project and an NSF.
      - Setting source control enablement feature preferences
        This topic explains the preferences you can set to customize your source control enablement feature operations.
      - Selecting the way to represent design elements on disk
        This topic describes the ways to represent the design elements on disk.
    - 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.
  - 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.

Before you begin: Creating associations between on-disk projects and NSFs

The source control enablement feature requires you to create an association between an on-disk project managed by the source control and the virtual NSF based project that Designer uses.

Eclipse based (i.e. open source) source control clients such as SVN and CCRC work on physical files. As such they cannot work directly with Designer projects that contain virtual files mapping to NSF based design elements. They only work with projects that are saved on disk (as on-disk projects). As such, you need to use a project on disk that mirrors the virtual NSF project to perform source control operations.

To accomplish this, the source control enablement feature requires you to create an association between an on-disk project managed by the source control and the virtual NSF based project that Designer uses. This step is a prerequisite that needs to be completed before carrying out any basic source control operations.

The following are the general steps that need to be completed to create this association.

Make sure you have opened or created an NSF application in Designer.
In the Applications Navigator, select the NSF you wish to associate with an on-disk project and, in the right-click context menu, select Team Development - Associate with Existing On-Disk Project. The Domino® Designer source control enablement feature operates by creating an association or mapping between a virtual NSF project and an on-disk project. Selecting this menu choice will complete this association.