The Versions Window
The Versions window in the Model Manager workspace shows the version history of an item — that, is a model, file, or tag — with respect to a branch. These correspond to a subset of Commits on the branch in which the item was either added or updated. Click the link button to select another branch in The Select Location Dialog Box.
The version history shown in the window follows the current item selection in The Databases Window or The Model Manager Window (depending on which window has focus). Click Link with Selection () to disable this automatic linking. You can still update the Versions window with a new item by right-clicking and selecting Versions ().
The versions are shown in a table sorted in chronological order. At most 100 versions are initially shown. Click the Show More button () to append older versions to the table. If the branch was created from another branch, older versions saved on the parent branch are also included in the table. If the viewed model is opened in the COMSOL Desktop, the corresponding model version row is highlighted in bold in the table. As for The Versions Window for the COMSOL Desktop Model, when viewing the version history of a model, the history of any origin model is also appended to the table — see Splitting a Model Version History in Two.
The table columns are:
•
The type column — the type of the item represented by an icon.
•
The Title column — the title set for the item in that version.
•
The Saved column — the time when the version was saved.
•
The Saved By column — the name of the user that saved the version.
•
The Branch column — the target branch of the commit in which the version was saved.
•
The Comments column — the optional comment provided when the version was saved.
The Versions Window Toolbar
The toolbar in the Versions window contains the following toolbar buttons:
•
Click the Refresh button () to refresh the table in case any new versions have been saved. The table will automatically refresh if you save a new version on the branch from the COMSOL Desktop.
•
Click the Show More button () to append older versions to the table.
•
Click the Link with Selection button () to enable or disable whether to automatically update the Versions window based on the current selection in the Databases window or the Model Manager window (which ever had focus last).
•
Click the Version Details button () to open The Version Details Dialog Box containing more information on the version.
•
Click the Open button () to open a selected model version in the COMSOL Desktop.
•
Click the Run button () to launch and run a selected version in the COMSOL Desktop. Only enabled if the selected version is an application.
•
Click the Preview File button () to open a selected file version using the default application for its file type. See Previewing Files.
•
Click the Compare button () to compare a selected model version with the model opened in the COMSOL Desktop. Select two model versions to compare them with each other.
•
Click the References button () to open The References Window to view all references between the selected version and other item versions.
•
Click the Restore Version button () to save the selected version as a new latest version of the model. See Restore Version.
If you right-click a version in the table, you can also
•
Select Export () to export the version to the file system — see Exporting Items.
•
Select Export to New Local Database () to export the version to a new local database — see Export to New Local Database.
•
Select Branch () to create a new branch from the commit that the version was saved in.
•
Select Snapshot () to record a snapshot of the commit that the version was saved in.
•
Select Copy Location () to copy a text string with a URI that uniquely identifies a model or file version in the database to the clipboard. See Copying Model and File Locations for what you can do with this text string.
•
Select Permanently Delete Version () to permanently delete a model or file version in the database. This cannot be undone. See also Permanently Deleting a Version.
•
Select Settings () to update the Settings window with the version. You may find this useful to see settings for an older version not available when searching with respect to a branch or snapshot.
The Version Details Dialog Box
The Version Details dialog box shows further details for an item version. The following is shown for all items:
•
Location — the database, repository, and branch that the version was saved to.
•
Saved — the time when the version was saved.
•
Saved By — the name of the user that saved the version.
•
Title — the title set on the item in the saved version.
•
Comments — the optional comments provided when the version was saved.
For a model version:
•
Saved in — the COMSOL Multiphysics versions that the model version was saved in.
•
Save Type — if the model is a regular model or a draft model.
•
Item Type — if it is a model, application, or physics.
•
Filename. The filename used by the model version when exporting it to the file system.
•
Description. The description of the model in the saved version.
For a file version:
•
Item Type — if it is a file or fileset.
•
File size. The size of the file version when stored on the file system. For a fileset, this is the total size of all files.
•
Description. The description of the file in the saved version.
Click the Edit Comments button () to update the comments for the commit associated with the version — see also The Commit Details Dialog Box. Click Save to save the updated comments to the database. Click Cancel to revert back to the original comments.
For a Model Manager server database, only a root administrator or the user that saved the version can update the comments.