Import Model Elements
File menu > Import Model Elements
Use the Import Model Elements dialog box to bring elements of an existing model into the model you currently have open. Developers can work separately on different sections of a model, import sections into the destination model, and reuse model elements as often as needed.
For more information see...
NOTE: If you are importing a model that contains event handlers, they are imported along with their parent element, however, you must manually copy the Java code from the model source Scripts sub-directory to the corresponding sub-directory in the destination model.
Options that determine how to work with the Import Model Elements dialog box are set on Settings menu > Preferences > Import.
- Import Model
- Browse to the model you want to use as a source for the imported model elements. The source model displays in a tree view, containing the elements you want to import. The first time the Design Tool is opened, the models directory is not visible.
- The model, along with its location, that you previously chose will display each subsequent time the Import Model Elements dialog box re-opens.
- Press Enter twice to immediately open the model you previously worked on. All settings are maintained.
- Use Browse to open a different model.
- Left Panel - Source Model Tree
- Select the different elements you want to import into your destination model.
- When you select an element, its sub elements are also selected.
You can choose to disable the option, Automatically select all sub items, on the Preferences dialog box.
- Use the right-click context menus to select current elements, clear elements that were selected due to default settings, and to select or clear all entities, tables, or variables under each tree node.
- The following indicators help identify the type and import state of a particular element:
|An icon alone
||The element name occurs both in the source and destination model. The name property is used to determine whether an element already exists.
|An icon marked with a green equal sign
||All of the element's properties in the source model are the same as those in the destination model. For example, if an entity exists in both models and all of the entity's sub-items are also marked with a , you do not have to import this element.
|An icon marked with a yellow asterisk
||A new element that you might want to import.
A comparison between old and new model elements can yield unexpected results because the new design tool may add new internal properties that were not added as defaults or weren't available when the old model was imported.
- As you select the elements you are importing, they display in the right pane as an inserted element, an updated element, or an element that is referenced, but not selected for import.
See below for information on elements that are not selected for import.
For a complete list and description of the icons used in the Import Model Elements feature, see Importing Model Elements.
- Right Panel - Import Action Preview
- To copy the Import Action Preview directories and their contents to the clipboard, right-click and select Copy from the context menu.
- The Referenced elements folder contains elements that are referenced, but not selected for import. All referenced elements must be resolved, either manually or automatically, before the new model can be deployed to the Host Integrator server. These new empty elements are inserted into the destination model, because there are referenced dependencies that you have chosen not to ’insert’ into the destination model.
An element, for example an attribute might reference another element, such as a variable. When the attribute is imported, but the variable isn't, then the referenced element is missing. The import function creates a temporary replacement version of the referenced element. These replacements are marked with the
_notImported suffix and inserted into the destination model.
NOTE: If the option Automatically select referenced elements is selected on the Preferences dialog box, then
_notImported elements do not occur. If this option is cleared, then these replacement elements must be resolved manually.
- Review all import actions before you import the model. Inserted and updated elements are listed in their respective folders.
- When you select an element in the Import Action Preview pane, including
_notImported elements, the associated elements are highlighted in the left Import Model pane. If necessary, a parent element expands to reveal the associated element.
- By default, all import models are validated in the Host Integrator Validator. A model must successfully validate before it can be deployed.
- Other Options
- To skip model validation, clear the checkbox. However, each time the dialog box displays, validation is selected, unless you change this setting under Preferences.
- To restore the Confirm before overwriting existing element option, open the Preferences dialog box and select that option.