You can easily create a new function in a node diagram by copying and pasting modules. You can copy and paste a single module, a group of modules, grouping icons, text objects, or the entire node.
You can copy modules from one node and paste them into another, as long as the node you are pasting to supports the selected modules and has sufficient resources. When pasting modules, you can replace existing modules or add new ones.
You can also copy modules and save them as a framework. You and other users can then reuse this framework in other nodes. Saving a node's configuration as a framework provides a fast and easy way to program a large number of nodes at once.
Note
Persistent modules cannot be deleted, but they can be overwritten during a framework paste. Overwriting a persistent module effectively relinks its outputs and rewrites its label, but its core functionality remains intact (for example, the Master Reset module may be relabeled, but pulsing this module still initiates a master reset). When pasting a default framework onto a meter, use lock-paste to ensure that all persistent modules in the "old" default framework are overwritten by the corresponding persistent module in the "new" default framework. Persistent modules are listed in the "ION Device Template Reference".
Note
The
When you copy a selection of ION modules, you can use Copy, Cut, or Copy to Framework:
Copy saves the selection to the clipboard and leaves the original module(s) intact.
Cut saves the selection to the clipboard and removes the original module(s).
Copy to framework saves the selection as a file and leaves the original modules intact.
Additional considerations include pasting with shortcuts, modules that cannot be pasted, and cloning a node (copying and pasting an entire node configuration from one node diagram to another).
Use the Cut or Copy command to save a temporary copy of the selected modules to the clipboard. You can then use the Paste command to transfer the selection from the clipboard into any node diagram. Each copy retains the setup register values, custom labels, link information and layout of the original selection.
Note
When selecting modules to be cut or copied, you can also include grouping icons and text objects. If you select a grouping icon, all modules within the group are copied, as well as any nested grouping icons.
Select the module(s) you want to cut or copy.
Do one of the following:
To cut the selection to the clipboard and remove the original, select Edit > Cut.
To copy the selection to the clipboard and retain the original, select Edit > Copy.
After the selection has been copied to the clipboard, you can select Edit > Paste to paste it into any user diagram.
You can use the Copy to framework command to create a framework from the selected modules. A framework is a template that you can use to reproduce a group of modules. Unlike regular copying and pasting, a framework is stored as a file so you can paste it later.
When you select Edit > Copy to framework,
You can use frameworks to simplify the process of programming multiple devices with similar configurations. For example, if you wanted to program a single function into several nodes, you could program the first node and then copy the configuration to a framework. You could then quickly program the other nodes by simply opening their node diagrams and pasting the framework you created. You can also use frameworks to program an entire node at once, considerably reducing the amount of time required to set up a large installation.
Before you save a group of modules as a framework, consider carefully which modules you want to include. If you include core modules in your framework, you will not be able to paste them unless you overwrite the existing core modules that correspond to those in your framework. Another approach is to select the modules “downstream” of the core module and save them as a framework. Then when you paste the framework into another node diagram, you can use the Maintain External Inputs option to preserve your links to the original core modules. (See
Note
After you have saved a framework, it can be used in another node diagram, as long as the node supports the modules included in the framework. Although it is possible to create a framework from one node type and use it with another node type, it is advisable to restrict your use of frameworks to nodes of the same type.
Select the group of module icons you want to copy.
Select Edit > Copy to Framework to open the Copy to Framework dialog.
In the File Name field, type a name for the framework, then click Save. The framework filename extension (.fwn) is added automatically and the selection is saved as a framework file.
After you have copied a group to a framework, you can select Edit > Paste from framework to paste it into a node diagram.
You can paste a saved copy of one or more modules into any node diagram.
Paste inserts a selection that has been placed on the clipboard using the Cut or Copy command
Paste from framework inserts a selection that has been saved as a file.
Pasting modules is a little more complicated than copying them, because the action of adding modules to the node may require you to replace existing modules. Whether you choose Paste or Paste from framework,
You can use the Paste Summary box to define how to integrate the source modules into the destination modules. For example, if a source module is being pasted to a destination that is already occupied, you can either lock paste the new module over the existing one or free paste the new module into the next available destination.
If you paste a selection that contains a shortcut,
In some cases,
When pasting modules, the first thing to do is select the node diagram and window where you want the modules to go. If you have more than one window open, you can click on the title bar of the window you want to make it the active window.
Note
You can paste modules into the same node diagram they were copied from or into a different one.
You can paste modules from two sources: the clipboard or a framework. When you paste a selection from either source,
notice
unintended device operation
Do not use the lock paste option to overwrite existing destination modules.
Only use the lock paste option if you are an advanced user familiar with ION architecture.
Failure to follow these instructions can result in operational differences in required modules.
Note
The lock paste option overwrites an existing module but the outputs from that module are retained as inputs of other modules. Consequently, the module may not operate as expected. (See
Open the window where you want the modules to go. Click in the background of the window to clear any selected modules.
Do one of the following:
To paste a selection from the clipboard, select Edit > Paste.
To paste a selection from a framework, select Edit > Paste from Framework. In the Paste from Framework box, select the file you want and then click Open.
The Paste Summary dialog opens. Use the Paste Summary area to review the proposed changes (see
The selection is pasted into the active window. The entire selection is automatically selected so you can easily move it to a clear area in the window. All module icons in the selection appear as pending until you click Send & Save to save the changes to the node.
Before
The Paste Summary dialog lists each module to be pasted and indicates its destination in the node. For each module, a short summary of the proposed modification as well as a more detailed description of how the module is pasted or why it cannot be pasted as requested displays in the dialog.
The following sections describe the various areas of the Paste Summary dialog.
The Source column lists each module that was copied to the clipboard or framework. Each source module is listed by its default label unless a custom label has been specified (in which case the default name appears in brackets after the label). Select a module in this column to view additional information in the Details area at the bottom of the dialog.
The Destination column indicates where the copy of each source module will be placed in the node diagram. The module label listed in the Destination column may or may not match the module label listed in the Source column. (If the destination module is to be overwritten, it is reused; otherwise, the next available module is used.)
The Summary column indicates whether the source module is copied into the destination as a new module or if it replaces (overwrite) an existing module. This column also indicates if a module will not be pasted.
Note
You can sort the paste summary information alphabetically by source or destination, or by importance of summary. Click on the Source, Destination, or Summary column headers to sort the list by the chosen criteria.
The Details area located at the bottom of the dialog provides more detail than the description in the Summary column. When you click on a module in the Source column, you can view a description of the proposed transaction in the Details box. This description explains how a module is pasted or offers reasons why it will not be pasted.
Tip
You can create a copy of the information displayed in the Details section of the Paste Summary box. To copy it, use the mouse to highlight the text you want, right-click the selection, then select Copy. You can then paste this selection into a word-processing program.
The Maintain External Inputs check box allows you to paste the module selection with all external links intact. If this check box is cleared, all external links (links to modules outside the selection) are discarded.
The following example depicts an external link to a Power Meter module.
| A | external link |
If you copied the two modules on the right but omitted the Power Meter module from the selection, the link to the Power Meter module would be external. Upon pasting the selection, the external link to this module would be lost unless you selected “Maintain external inputs” on the Paste Summary box.
The check boxes to the left of each module indicate the proposed action (that is, how the module will be pasted):
A green check mark
indicates a free paste.
A check mark with a lock symbol
indicates a lock paste.
A red “X” symbol
indicates the module will not be pasted.
An “X” symbol without a check box
identifies a module that has no possible destination and cannot be pasted.
You can click on a check box to change the proposed action. For example, if you click on a “free paste”
or a “will not be pasted”
symbol, it changes to a “lock paste”
symbol. When you change the type of paste, the descriptions in the Summary column and the Details box also change to describe the new action. (See
You can use the free paste and lock paste options to instruct
The first option in the above example is a free paste. It can be used to paste new modules into a diagram without deleting any existing modules. This is useful for integrating new functions into a node without disrupting the node's existing functionality. Although this may seem desirable, another option is available. By leaving existing modules intact, a free paste can result in needless duplication of functions. In addition, some groups of modules are interdependent and may require a lock paste to operate correctly.
The second option in the above example is a lock paste. It instructs
You can use a combination of both free paste and lock paste within a single paste operation.
Note
You can pre-select modules for
Note
Overwriting a module is not the same as deleting the module and then pasting a replacement module. If a module is overwritten, links from the outputs of that module are retained as the inputs of other modules. If a module is deleted, these links are also deleted and do not exist after the replacement module is pasted.
Identified by the symbol
, a shortcut icon is a representation of a module icon that is located in another window.
You can copy a shortcut in the same way you copy the original module, but when you paste a shortcut, one of two things happens: It is either pasted as a shortcut to an existing module (if one is available) or as a new module. In either case, it continues to perform its function as before.
There is a basic reason for replacing a shortcut with a module: a shortcut cannot exist in a node without the module it represents. When you paste a selection containing a shortcut,
Some modules cannot be pasted because their settings are non-transferable between nodes. All Factory, Communications, and Diagnostics modules must be individually configured for each node.
When pasting a selection that contains a Factory, Communications or Diagnostics module,
You can quickly configure multiple nodes by cloning a node. Essentially, cloning a node involves copying a node's entire configuration to a framework then pasting it onto another node. This effectively reprograms the node receiving the framework as an exact copy of the original.
Note
When you paste an entire node's configuration, the Factory, Communications, and Diagnostics modules are not pasted because they could disrupt the operation of the device's communications. If you need to change the settings of these modules, you can do so manually.
Open the node diagram of the node you want to copy. Ensure that you are in the main or root window of the diagram.
Select Edit > Select All. All core modules, standard modules, grouping windows and text icons are selected.
Select Edit > Copy to framework to open the Copy to framework dialog.
In the File name box, type a name for the framework and then click Save. The framework filename extension (.fwn) is added automatically and the entire node configuration is saved in this framework file.
After you have saved the source node's configuration as a framework, you can paste it to other nodes of the same type. This file can also serve as a backup in case you want to restore the configuration of the source node.
Open the node diagram of the node to which you want to paste the configuration. Ensure that you are in the main or root window of the diagram.
Select Edit > Select All. Press the Delete key to remove the node's existing configuration. A dialog opens listing the standard modules that will be deleted and the core modules that cannot be deleted. Click OK to continue.
The standard modules and text icons are deleted, and the core modules (and any grouping windows containing core modules) remain.
Select Edit > Select All to select the remaining module (and grouping) icons.
Select Edit > Paste from framework to open the Paste from framework dialog, select the framework file that contains the node configuration you want to paste, and then click Open.
The Paste Summary dialog opens. (See
Select all modules in the list (click last item, hold the SHIFT key, and then click first list item - the entire list appears highlighted).
Change the paste type to lock paste (hold the SHIFT key and then click the paste type check box until all modules are set to lock paste
).
Click OK to complete the procedure.
The selected framework is pasted into the node diagram. All module icons in the selection appear as pending until you select Send & Save to save the changes to the node.