TreeView
User Guide GeoDMS GUI - TreeView
The Treeview is the main navigation component of the application. It presents the hierarchical structure of a configuration in a view like the Windows Explorer. By default, the first level items are shown (the root item is not shown, it's name in presented in the title bar). Each item in the tree (called a Tree item) is presented with a name and an icon.
The selected item in the Treeview is the active item in the application. This is an important concept, as many functions of the application work on the active tree item. By clicking the right mouse button a pop-up menu can be activated, with a set of menu options that work on this active tree item. The Detail pages also present information on this active item.
The main purpose of the icons is to inform the user on the type of item and, if relevant, show which default viewer will be used for the item. Double-clicking or pressing the Enter key on a selected tree item activates this viewer. The following icons are in use:
| icon | description |
|---|---|
 |
A data item that can be viewed in a map. This implies the domain unit of the data item has a geographic relation (see how to model for How to configure a coordinate system). Dependent on the geographic domain, the data is visualized in a grid, point, arc or polygon layer |
 |
A data item that cannot be visualised on a map (it has no geographic relation), its default viewer is a table. |
 |
A data item that contains a palette (a set of colour values, corresponding to a classification). |
 |
A container, not containing data items as direct subitems. |
 |
A container, containing data items as direct subitems, whose default viewer is a table. |
 |
A tree item with no data item and no subitems, e.g. a unit. |
Starting from version 19.2.0, the TreeView utilises a combination of text colours, background colours, and status badges to provide detailed information about data provenance, calculation states, and integrity.
The colour of the tree item name indicates the origin of the data:
| Color | Description |
|---|---|
| Canal Green | Source data: Data loaded from external files or databases. |
| Black | Calculated data: Data generated by expressions within the GeoDMS. |
| Purple | Template definitions: Items where data depends on the specific instantiation of a template. |
The background colour represents the current status of the calculation process and the application's "interest" in the item:
| Color | Status | Description |
|---|---|---|
| White | Idle | Not calculated and not requested (no current interest). |
| Yellow | Pending | Not yet calculated, but currently requested by a view or process. |
| Green | Available | Calculated/updated and currently available for data retrieval. |
| Blue | Standby | Available for use, but no longer actively requested. Kept in memory/cache for potential future use. |
| Red | Error | Calculation failed (syntax error, calculation error, or data-read error). No data available. |
Small icons (badges) provide additional context regarding data integrity and storage status.
These badges indicate the results of configured integrity checks:
- Red Cross: The integrity check failed on this specific item.
- Orange Cross: An integrity check failed somewhere in the supply chain (upstream) of this item.
- Green Checkmark: The integrity check for this item passed successfully.
- Green Ring: All integrity checks in the supply chain passed successfully.
- Three Dots (...): Integrity checks exist in the supply chain, but not all have been evaluated yet.
These badges indicate the status of data persistence and external access:
Diskette Icons (Data Targets)
- Grey Diskette: A data target is configured, but the data has not been saved yet.
- Black Diskette: Data is successfully saved (Committed).
- Red Diskette: A write error occurred while trying to save the data.
Database Icons (Data Sources)
- Grey DB: Data is available to be read but has not been accessed yet.
- Black DB: Data has been successfully read from the source.
- Red DB: A read error occurred while accessing the external data source.
Older versions:
The color used for a tree item name indicate it's status. Three statuses are distinguished:
- Not yet calculated: an item is are not yet calculated.
- Valid: the results are calculated successfully and the integrity checks configured for the item and its suppliers are met.
- Failed: the application failed in updating the results or the integrity checks are not met. In the first case, the results are not available; an error is raised indicating what problem occurred while updating the tree item. In the second case, the results are available and can be presented in a view; a warning color indicates the results are not valid.
The colors for these statuses can be viewed or edited with the Settings > GUI options dialog, section TreeView, Show state colors.
The application controls when and how to update tree items. If a user requests a view on a data item, the required tree items are first updated, before the results are presented in the view. If a tree item has become valid, this status is ‘stored’ until changes are made in the calculation rules. This means the second time the same view (or another view requiring the same data items) is requested, the data item is already valid and the results can be visualized immediately.
With a right mouse click, a pop-up menu can be requested for actions on the active tree item. This menu contains the following options, some options are only available for data items of for items with the status: failed
- Export primary data : exports the contents of the active data item (or the subitems of a container) with the export dialog.
- Step up to FailReason: if a data item is failed, this option activates the first failed supplier.
- Run up to Causa Prima (i.e. repeated Step up): if a data item is failed, the GeoDMS tries to find the the item for which the first error occurs.
- Open in Editor: Opens the current item in the Configuration File Editor as configured in the Settings > Local machine options dialog, section Configuration File Editor.
- Update TreeItem: update the tree item, without showing the result in a view. The process is visualized with a process scheme.
- Update SubTree: update the tree item and all it's subitems, without showing the result in a view. The process is visualized with a process scheme.
-
Code Analysis: Four options to find out if the item configured is used in calculating results
- set source: set the item as source item to be analysed
- set target: set the item as target item for the calculation process
- add target: add the item as target item for the calculation process
- clear target: clear the item as target item for the calculation process
- Default: calculate the results and use the default views (indicated by the icon) to view the results.
- Table: calculate the results and present the results in a table view
- Map: calculate the results and present the results in a map view
- Statistics: calculate the results and present the results in a statistics window