Saving Models to Databases
From the Save window, you can save a new version of the model opened in the COMSOL Desktop to one of your configured databases. Choose the database that you want to save a model to in the list of options. Choose Add Database () if you want to add a new database.
The Save Window in the COMSOL Multiphysics Reference Manual
The Save window can appear with four different headers depending on the model’s presence in the selected database:
•
Save new: The opened model has never before been saved to the database. A new model will be created in the database with an associated first version.
•
Save version: The database contains previously saved versions of the opened model. A new version of an existing model will be saved to the database.
•
Save version from draft: The opened model is a draft version. A new version of the regular model that the draft was created from will be saved to the database.
•
Save new from draft: The opened model is a draft version, but the regular model that the draft was created from does not exist in the database. This may happen if you, or another user, permanently deletes the regular model in the database while the draft is open in the COMSOL Desktop, or if you decide to save the draft to another database. As for Save new, a new model will be created in the database with an associated first version.
Saving Drafts of Models
To save a new model version:
1
Write the title for the model version in the Title field.
This title is kept in sync with the corresponding field in the Presentation section in the root node’s Settings window. The title cannot be left empty.
2
Write an optional save comment in the Comments field.
You can later read these save comments from The Versions Window and the The Commits Window.
3
Change the target branch for the save by clicking the Location link button and selecting another branch in The Select Location Dialog Box.
The Location link button is hidden if the database only contains a single branch, which is the default for a new database.
4
Click the Save button () to save a new version of the model.
If you want to force the creation of a new model instead, click on the expand button next to the Save button () and select Save as New () — see also Splitting a Model History in Two.
Only changing the title of a model already saved in a database does not mean that you will create a new model. While providing a descriptive title helps you with later finding it in the database, it has no bearing on the database identity of the model.
Save Information
The Information panel displays additional information concerning the save. When saving a new version of an existing model in the database, this includes both when, and by whom, various versions were saved:
•
Latest version: The most recent version of the model being saved. The latest version depends on the target branch set in the Location field.
•
Current version: The version that the current model in the COMSOL Desktop was opened from. Only shown for Save version if the current version is not the same as the latest version — see also Save Conflicts.
•
Current draft version: The version that the current draft in the COMSOL Desktop was opened from. Only shown for Save new from draft.
The panel can also contain information messages () that may be of interest, as well as warning messages () signaling, for example, that the opened model is in conflict with the latest version.
Save Conflicts
When the Save window is shown, Model Manager will make a preemptive check that the model being saved is not in conflict with the latest, saved, version in the database. Such a conflict can arise if:
•
The latest version saved in the database is not the same version that the model in the COMSOL Desktop was opened from. Your coworker may, for example, have opened the same model as you, made some changes, and then saved before you now try to save it.
•
The latest version saved in the database is not be the same version as a draft was originally created from. You and your coworker may, for example, have both started working on two separate drafts, and then your coworker saved their draft back to the original model before you now try to save it back to the same model. See also Saving Drafts of Models.
•
The model in the COMSOL Desktop has been deleted on the target branch before you now try to save it.
Clicking the Save button () while there are save conflicts opens a dialog box asking if you want to save anyway. Click Save to ignore all conflicts, or Cancel for closing the dialog box without saving. You can also click Compare with Latest () to open the Comparison Result window to compare the opened COMSOL Desktop model with the latest version in the database. See also Comparing the Opened Model in the COMSOL Desktop With the Latest Version.
Permission Check
When saving to a server database via a Model Manager server, Model Manager will check that you fulfill the permission requirements to save a new version of the model. This involves checking that you are permitted to:
•
Save in the repository containing the target branch.
•
Save in the target branch.
•
Save versions of the model.
Only the first two requirements apply when creating a new model in the database.
Permission Levels
A preemptive permission check is performed when the Save window is shown. If the check fails, a link button () that opens a dialog box explaining why it failed is shown next to the Save button () — see The Permission Requirements Dialog Box.