Commits
A commit () is a set of related changes made to Items — that is, Models, Files, and Tags — within a single database save operation. This includes anything from saving item versions, changing the assigned tags of items, or deleting items, to creating a new branch, merging into a branch, and reverting a commit. The changes are saved to the database as a “unit” and, as such, can also be reverted as a unit.
A commit saved in the database includes:
See Figure 2-3 for an example of a commit taken from the tutorial Example: Modeling Using Version Control in which a draft has been saved back as a new version of its original model.
Given a particular commit, you can browse and search the versions of items that were the latest versions at the time of that commit. A schematic representation of this is shown in Figure 2-2: In the first commit, a first version of a model A and a model B were saved. In the second commit, a second version of model A was saved, a first version of a tag T was saved, and model B was tagged by T. In the third commit, model A was deleted and a second version of model B was saved. The database can be browsed and searched with respect to each of the three commits, with each big circle surrounding what you will find.
Figure 2-2: A schematic of three hypothetical commits (big circles) saved in a database. You can browse and search versions and tag assignments with respect to any one of these commits.
Commit Settings
The Settings window for a commit shows the branch the commit was saved to, the point in time when the commit was saved, the user that saved the commit, and any comments provided with the commit. You will also find a table with the set of changes made to Items in the commit.
You can update the comments for the commit. Rewrite the text as you see fit and click the Save button ().
The General Section
This section displays the following fields:
Location. The database, repository, and branch that the commit was saved to.
Date. The point in the time when the commit was saved.
User. The name of the user that saved the commit.
Comments. The optionally provided comments when the commit was saved.
The Changes Section
This section shows a table with the set of related item changes made in the commit. Each change entry in the table is represented by the latest version of the affected item at the time of the commit. Apart from changes corresponding to saving a new version, this also includes deletions and tag assignments of items.
From the toolbar below the table, you can:
Click the Open button () to open a model version. Only enabled for a change that involved a model.
Click the Preview File button () to open a file version using the default application for its file type. Only enabled for a change that involved a file.
Click the Version Details button () to open The Version Details Dialog containing more information on a version.
Figure 2-3: The Settings window for a commit in which a new version has been saved of a model, and a draft has been deleted.