Bulk Tree Load
Use this system function to load the entire contents of the tree control from cache.
Parameters
- Tree Control
-
Input, required. The tree control form control (FC) to affect.
- Cache Name
-
Input, required. The name of the cache from which to acquire data for the contents of the tree. Set the parameter to an applicable object from the object list.
- Data Structure
-
Input, required. The name of the data structure used to organize the cache. Double-click <Get Structure Name> to select the structure to use.
- Node Value Column
-
Input, required. The data to use for identification. This value is not a true ID in the traditional sense; in this system function, it is used primarily for matching with values in the Parent Value Column to determine parent/child relationships. If you want to use node value as a true identifier, ensure that each row will have a unique value in this column (many tree control system functions use node value as an ID). Set the parameter to an applicable object from the object list.
- Node Description Column
-
Input, required. The label to display for each node. Set the parameter to an applicable object from the object list.
- Parent Value Column
-
Input, required. The data to use to determine parent/child relationships. This value indicates which row is the parent of the current row. When runtime constructs the tree, it will place the current row as a child of the row with the corresponding value in Node Value Column. Set the parameter to an applicable object from the object list.
- Root Node Value
-
Input, required. The value that indicates the root node. Ultimately, the uppermost node of the tree, the root node, has no parent. Runtime compares this value with the values in the Node Column Value parameter. The row with the matching value becomes the root node.