Load Model Fragment Dialog
Import elements from a model fragment previously exported in a file.
Purpose
This dialog and the respective Export command allow you to exchange groups of model elements with the file system.
This derives an array of use cases:
-
Undo changes or deletes
Export relevant model areas before making a big change or at regular intervals. This means you can always import this state if you need to restore it.
-
Copy subsystems
Model fragments stored in a file are an excellent way of reusing subsystems within the model or in other models while retaining their structure.
Prerequisite
Roles used for logging-in require the Versioning privilege.
Enter
Enter the file's path in the Model Fragment field or select the file with the model fragments to be imported using the Select... button.
The Identify Elements By Namespace option determines where the elements to be imported are created. Each element has a UUID which can be used to uniquely find it. If this option is set, the element's namespace is used instead of the UUID.
If the Adopt UUID On Import check box is not activated, the UUID is retained when an element is replaced. A new UUID is created if the element does not already exist. However, if this option is set, the UUID is always taken from the model fragment.
If the Adopt UUID On Import check box is activated, the imported UUID may differ from the existing one or the UUID to be adopted may already exist in the model. The Behavior On Conflicts group appears and you can then decide how to treat the conflict.
Inserting to Restore
It normally makes sense to identify elements using namespaces and then adopt UUIDs from the model fragment. The Adopt Imported UUID check box should be activated in the Behavior On Conflicts group.
Inserting as a Copy
Activate the Identify Elements By Namespace check box.
Do not activate the Adopt UUID On Import check box if you are importing in the same model. It may be a good idea to adopt UUIDs from the model fragment if you want to implement the import in another or empty model and you want to activate the importing elements via the API.