Edit module hierarchy
- Last UpdatedOct 04, 2024
- 3 minute read
- PI System
- PI Server 2018
- PI Server
You can reorganize and edit the entire module database structure displayed in the Module Database tool.
Note: To modify a module's hierarchy, you need Read/Write access permissions to the parent module you are moving from, the module you are moving, and the module to which you move it. See Module Database security permissions for more information.
These rules apply under the following circumstances.
For all copying
-
When a copied entity represents a collection of modules, PIUnits, aliases or properties, all items in the collection are copied to the clipboard.
-
To paste a copied entity below it, right-click the entity in the target database.
-
Pasting an entity with a duplicate name prompts you to confirm the replacement of the existing entity.
-
Pasting a heading into a set with a heading of the same level number prompts you to confirm the reassignment to a different level.
For copying data within a Data Archive server
-
Module links are maintained in all cases. Pasting a linked module creates a new copy of the module.
-
Hierarchical relationships are maintained. You cannot make a parent a child of any of its children.
For copying data between servers
-
Modules can be copied, but you cannot insert or link modules between servers.
-
Module links are maintained within branches that are copied.
-
Heading sets and headings are automatically created on the target server if headings of copied modules do not exist. If local headings with the same name already exist on the target server, they are used even if their heading level is different.
For drag-and-drop copying and moving
-
To copy an object and its value without the tree structure, drag the object to a new location.
-
To copy the entire tree branch structure, press and hold CTRL and drag. To copy values as well, press CTRL+ALT.
-
To move the tree branch structure, press and hold SHIFT and drag. To copy values as well, press SHIFT+ALT.
-
To insert and link a module, Press and hold ALT and drag.
-
To show options for copying and moving, right-click and drag.
Context menu commands
To edit the module hierarchy, right-click a module in the tree control and select one of the following options.
Note: The options displayed depend on which node is selected in the module database tree. For most modules, you can also double-click a module to edit attributes specific to the module.
|
Right-click Option |
Result |
|---|---|
|
New |
Add a new module database entity below the selected item |
|
Copy |
Copy the selected item and its associated values, but not child items |
|
Paste |
Paste the copied module database item from the clipboard below the selected tree item |
|
Paste Values |
Paste only the item and associated values (the item's effective dates), and not child items |
|
Paste Hierarchy |
Paste the item and child items |
|
Paste Value Hierarchy |
Paste the item, child items, and associated values (effective dates) |
|
Insert Link |
Insert a link to the copied item below the selected item |
|
Delete |
Delete the item. If the item is linked, all instances are deleted from the module database. |
|
Delete Link |
Delete a selected link to an item, leaving other linked instances in the module database |
|
View All Parents |
View all parent relationships for a selected linked item |
|
Make Root Node |
Create a link to the item making it the root node for the current server |
|
Refresh |
Refresh the tree control with updated values |
|
Edit |
|
|
Edit Values |