Node Tree (UI Element)
|
⚠ |
This article was migrated from an older version and has not been updated for the current version of Grooper. This tag will be removed upon article review and update. |
|
WIP |
This article is a work-in-progress or created as a placeholder for testing purposes. This article is subject to change and/or expansion. It may be incomplete, inaccurate, or stop abruptly. This tag will be removed upon draft completion. |
|
This article is about the current version of Grooper. Note that some content may still need to be updated. | |
| 2025 | 2023.1 |
The Node Tree is the hierarchical list of Grooper node objects found in the left panel in the Design Page. It is the basis for navigation and creation in the Design Page.
Resources are created in Grooper by adding new "nodes" to the Node Tree. The Node Tree is called a "tree", because it "branches." Each new node added under another creates a new "branch", or a new level down from the node it is created. What object types can be added under a branch are determined by the node(s) above it.
Grooper Nodes
Any single item in the Node Tree is a Grooper Node (also simply referred to as a "node"). Each node has a Node Object Type, which defines what that node is, how it is configured and used throughout the Grooper Repository. For example, a Batch is the 'Node Object Type (often just called "object") that serves as the fundamental document container in Grooper.
Each new node creates a new branch under an existing one, creating the hierarchical structure of the tree.
|
FYI |
In Grooper, nodes and their properties are stored in the database connected to a Grooper Repository. |
How do nodes create hierarchy in the Node Tree?
At the top of the Grooper Repository is the Root node (aka the "Grooper Root").
Under the Root node, there are six main child nodes in the Node Tree. These nodes serve the purpose of organizing Grooper nodes according to their object type to assist Node Tree navigation.
- Batches
- Projects
- Processes
- Queues
- File Stores
- Machines
Every Grooper Repository will contain these nodes and their contents, or "child" nodes.
- For example Project nodes are added as children in the "Projects" folder node.
- Content Model nodes are added as children of an individual Project node.
- Batches are nodes created and stored in either the Batches > Production or Batches > Test folder nodes.
When you create a new node, it is added as a "child" of another node. The node containing a child node is called its "parent"
- As nodes get added to other nodes, the node tree branches off into different levels.
- These different branches create the Node Tree's hierarchical structure.
What's the difference between a node and an object?
A "node" is something you add to the Node Tree. Every node has an object type. An "object" is the type of thing that node is.
For Example: Here, there are three nodes named "Name" "DOB" and "SSN".
- These are individual nodes in the Node Tree.
- However they share the same object type. They are all Data Fields.
BE AWARE: The terms "node" and "object" are so similar many people use the terms interchangeably. You will probably even find occurrences in the Grooper Wiki where we refer to a "node" as an "object".
More on parents and children
Parent nodes determine many things for their children. The parent node's object type dictates what its children can be. It controls what possible object types its child nodes can be. Parents and children will also pass information to each other in different ways, depending on their object types.
The parent node will always determine what object types (if any) can be created as children.
- This may be more restrictive.
- For Example: A Data Model can only have Data Field, Data Section or Data Table nodes as its immediate children.
- Furthermore, Data Tables themselves can only have Data Columns as children.
- This may be more permissive when the parent node is more of a folder organizing child nodes.
- For Example: A Content Model's Local Resources folder or a Project node.
- Many different kinds of node objects can be added as nodes in a Local Resources folder.
- Almost every type of node object can be added to a Project
The parent node's object type also determines what information is passed to and from the parent and child nodes.
- For Example: A Content Model will pass its Export Behavior configuration to child Document Types. This way users don't have to configure Export Behavior settings to multiple Document Types using the same export logic.
- For Example: a Data Type's children Value Readers will pass all results they return to the parent Data Type. Those results will then be collated according to the Data Type's configuration
The Grooper Root
At the top of the Grooper Repository is the Root node (aka the "Grooper Root"). It contains all Grooper nodes as its children. It also stores several settings that apply to the connected Grooper Repository, including:
- The Active File Store location.
- Visit the Install and Setup article for more information on Grooper Repositories and File Stores.
- The License Serial# or URL configuration.
- Visit the License Activation article for more information about how to license your Grooper install.
- Any security settings stored in the the Permission Sets.
|
⚠ |
"Root node" is a common term in computer science. Be careful about commonly interchanged words.
|