To import the Snapshot file in Hyperon Studio, go to Tools → Snapshot import. Choose the snapshot ZIP file in the popup window and click Import.
In Hyperon Studio version 1.6.41, appeared a possibility to define autocommit:
"Publish session after import" - If this checkbox is checked (by default it is unchecked), then if the import was successful - on errors or warning, the system will publish user's session automatically.
If publishing was completed with no errors, then import status will be "OK" with no messages. If there was any problem during publishing, then messages with conflated information will appear. Import + publishing was finished with error, but all elements will be imported to the user's sessions and available there.
In Hyperon Studio version 1.6.43, additional setting was added:
"Consider config.json file during import"
If during import config file is considered then (if set) removal of selected elements which are not in snapshot file will be done. RemoveNotInSnapshot flag is available in config file and in the Hyperon Studio while setting the export configuration. There are three kinds of elements that may be deleted during import:
Only elements not used as domain attribute's values, in parameters as value source, in function's body or as a master for existing aliases may be removed from the environment during import. Since version 1.6.48 search through Hyperon configuration may be expanded by a searchWithinParameterMatrix - then while import process every matrix will be checked for cascade call to parameters and functions marked for deletion.
If during export any filters were applied the same filters will be applied during import (available since version 1.6.39). Only elements fitting those filters, but not within the Snapshot file, will be considered for removal.
After executing the import, a window with the import results is displayed.
Since Hyperon Studio version 1.6.41 the result for every step of the import is visible, and additional information is available if any complication occurred during import.
This screenshot is from import, that was successful, but there were some problems during session publishing for parameters.
Description of columns:
Status - icon depicting the overall status of the import:
Imported files - number of processed elements
Errors - number of elements not imported due to various reason (e.g. import error)
Skipped - number of skipped elements (e.g. imported parameter has no changes to currently available on Hyperon)
Unpublished - number of unpublished elements, if the auto-commit checkbox was checked.
Message - clickable button showing the list of import messages (the eye icon visible on the right side of the Import results popup). For a successful imports there are no messages.
Example: list of import messages
Each line contains a message for one import operation:
Status column displays an icon depicting the result of import:
Path contains a path within the ZIP file to the file containing a definition of the imported element.
If there were multiple files corresponding to the same version of the function with identical code, a wildcard is used instead of file extension (.*)
Message - import message, a warning or an indication of the source of error.