Creating a New Project

Prerequisite: To create a new project on a server, you must be a DiveLine administrator.

To create a new project:

  1. Open the New Project dialog box by using one of the following methods:

    • Click File > New > New Project
    • In the File > Open Project dialog box, at the lower left, click Create New Project
    • In the Tools > Server Settings > Projects sub-tab, at the top of the project listing, click Add Project

      The ClosedNew Project dialog box displays.

      New Project Dialog Box - empty

  2. In the Project Name box, enter a name for the project.

    NOTE: Project names are ultimately folder names, so any character that is forbidden in folder names is also forbidden in project names. This includes: /, \, *, ?, :, <, >, ", and |.

  3. In the Project Root box, edit the path or folder name if you want to use a root other than the default. The Project Root automatically populates using the currently active DiveLine connection projects path and appends that path with the project name.

  4. Select the Initial Contents.

    • Select Default Folder Structure to automatically generate the recommended project directory structure. For more information, see Default Folder Structure.
    • Select Empty to create an empty project structure. You can then manually create your own project folder structure.
    • Select Copy Project to create a copy of an existing project on the same DiveLine server. See Copying a Project.
    • Select Clone from git to create a repository from an existing URL. Enter the URL after the https:// in the text box. Applies to Workbench 7.1(14) and later.
    • Select Local Repository to set the project to a local Git repository. Use the browse button to locate the appropriate server directory. Applies to Workbench 7.1(14) and later.
  5. In the Description box, enter an optional description for this project.

  6. Prior to Workbench 7.1(14), leave Enable automated version control selected to default to automatic commits every 30 minutes and whenever the project is closed. DI recommends using the automated version control feature for most projects. See Automating Version Control.

    Starting with Workbench 7.1(14), you have the option of using DTAP style release management with version control, allowing developers to control when commits are made. See Managing Software Releases.

    The following image is an example completed ClosedNew Project dialog box.

    New Project Dialog Box - filled

  7. Click OK.

    A new project is created and opens in ClosedWorkbench Explorer.

    New Project Folders

NOTE: The Status below the Description box in the New Project dialog box displays one of the following messages when you enter a project name or navigate to an existing folder:

  • Unnamed projects are not allowed. Please give project a name.

    You have not entered a project name and cannot continue until you enter a project name.

  • New Project Directory will be created.

    You have entered a unique project name and this new project will be created.

  • Project Location is already in use by "<existing_project_name>"

    You have entered a project name that is already in use, or have pointed the Project Root to an existing project. Enter a unique name, or remove the project name from the path in the Project Root box.

  • Project Files already exist at the specified Project Root.

    You have pointed to a folder with existing content. A new project is created using the existing files as the basis.

  • URL should be HTTPS

    You have selected to clone the project from Git and you need to supply the complete URL to locate the remote server.

  • Please provide a local repository path

    You have chosen to clone the project contents from a local Git repository. Enter the local path to that repository.

See also: