Saving Versions
There are various ways in which you can save a new version of an item, both within the Model Manager workspace and from one of the other workspaces. You can, for example, save a new version of the model opened in the COMSOL Desktop from the File menu by clicking Save Draft (), Save as Version (), or Save To () — see Saving Models to Databases.
In the Model Manager workspace, you can save a new version by clicking Save () in the Settings window. For a model this will, for example, update the model’s title, description, and filename, but leave the model tree, as well as any binary data like meshes, geometries, and solutions, unchanged. Other examples of saving versions include:
•
Exporting output from a model directly to the database — see Exporting Output Directly to a Database.
•
Importing files on the file system into the database — see Importing Files.
•
Creating a new tag — see Creating New Tags
•
Renaming an item — see Rename Item
•
Restoring an older item version as a new latest version — see Restore Version.
•
Merging updated items from a source branch to a target branch — see Merging.
•
Reverting a commit that included added, updated, or deleted items — see Reverting.
You generally want to avoid saving a new version of the model opened in the COMSOL Desktop from the Model Manager workspace. Otherwise you will get Save Conflicts when trying to save a new version of the desktop model.
Creating a New Branch does not save new versions of the items included on the new branch — each item version on the new branch is initially the same as that on the parent branch.
Rename Item
From The Model Manager Window or the The Databases Tree, right-click and select Rename (), or press the keyboard shortcut F2, to change the title of an item via the Rename Item dialog box. The Location field shows the database, repository, and branch that the item will be renamed on.
1
Write the new title for the item in the Title field.
2
Write an optional comment in the Comments field.
3
Click OK to save the renamed item as a new version in the database.
Restore Version
You can restore an older version in the version history of an item as the new latest version. This enables you to, for example, recover an older model version without first having to open it in the COMSOL Desktop and manually save it as a new version via Save as Version ().
From The Versions Window, click Restore Version () to open the Restore Item Version dialog box. The Location field shows the database, repository, and branch that the item version will be restored to. The title of the restored version is shown in the Title field.
1
Write an optional comment in the Comments field.
2
Click OK to perform the restore.
Reverting Changes on a Branch
Restoring Versus Reverting
The different use cases for restoring a version and reverting a commit in which a version was saved are best exemplified via two examples:
•
You have created a draft from a model and then saved ten versions of that draft. By the tenth version, you realize that the modeling setup has gone wrong for the draft, and that things started to go bad by version four. Solved by restoring version three from The Versions Window such that a version eleven, identical to version three, is saved directly in the database.
•
You have decided to save what you, initially, think is a finished draft back to its original model. Such an action simultaneously saves a new version of the original model and deletes the draft. You then realize that you did this too soon — there were more things you wanted to first change in the draft. Solved by reverting the commit in which the draft was saved back to the original model from The Commits Window: the draft is added back to the branch and the model is updated to its previous version before it was overwritten by the draft.