Versioned Projects

When you create a Versioned Project, all changes to the project are recorded and stored in the project history. You can use the version history to review changes that you and others have made to the project, and even revert to a previous version if something goes wrong.

The first time you open or create a new project you may be prompted to enter your name and email. This is used to identify changes in the project history.

As you work on your project files, you can commit the files in the project at any time. When you commit the project, a snapshot of the project is saved as a version. Any additional information associated with a resource in the project is recorded alongside the file.

Both the Designer and the DataMapper use Git integration to maintain the history of a Project.

Creating Versioned Projects

Versioned projects are created from the Project menu at the top of the Welcome (or Home) screen. Projects created with the Sample Projects wizard are not versioned.

When you create or open a versioned project, Designer remains in Project mode until the application is closed.

Before you create your first versioned project you should create a new folder under the Documents folder for your projects. This will allow you to commit your project files without committing all of the files in the Documents folder.

Connect is the suggested folder name, with each project having its own folder under Documents/Connect.

To create a new project,

  1. Select Project > New from the Welcome screen.

  2. Navigate to the folder where you want to save your projects (such as My Connect Projects or a folder under that one).

  3. Return to the Welcome (Home) screen, and select New Template.

  4. Select a template context. Options include:

    • Email

    • Print

    • PDF-based Print

    • Word-based Print

    • Web

  5. Specify the parameters for the new template, and then select Finish. Your new project is created and displays in the Designer.

  6. Add your content as usual, then select Save to save the template to disk.

  7. To record this version in the repository, select Commit. This records the saved template as a new version in the repository. Note that you need to save your changes before you can commit.


  8. Enter information to describe the changes, then select OK.



Viewing Project History

The Project History contains the records for all of the changes made to each resource in the project. When you commit a project, a snapshot of the project resources is stored as a version. You can review the versions to see what changes were made, who made them, and when they were made.

To see the history of the project:

  1. With the project open in Designer, select Project > Versioning history from the menu bar.

  2. The history displays in the Versioning History tab.

You can select a version from the list to display more information about the changes made in that version.

To restore a previous version, select the version, then select the restore icon. The project is reset to the state it was in when that version was committed.



Viewing Project Content

Select the Project Files option from the Project menu to display the list of resources in the project.

The files comprising a Project display in the Project Files panel.