Share
 
 

Model Group window

This window is a hierarchical representation of the data associated with a glossary-termmodel group. The window provides a range of facilities to manage the model group.

The window is opened by selecting Window | Model Group window.

Item Description
Title bar

Shows database and the version number.

Toolbar
Tree view

Up Up

Click this button to move one level up the tree view.

This button will be disabled if the top level (database) is already displayed.

Refresh Refresh

Click this button to Refresh the tree view to take account of recent changes.

Show detail Show detail

Click this button to display or hide details for each item in the tree. The details displayed are:

  • Type - type of item (network, for example)
  • User - name of the user who created the item
  • Description - user-defined description added via the item's properties dialog
  • Date - date when the item was last modified
  • Hyperlink - the first hyperlink associated with the item via the item's Properties dialog. If there is more than one hyperlink associated with the database item, '(more)' will also be displayed to indicate that there are additional hyperlinks

Sort columns Sort columns

Click this button to enable items in columns to be sorted by name by clicking the column header.

Sort by Sort by

Click this button to sort tree items alphabetically by a selected parameter within their model groups. The options are:

  • ID - items are sorted by identifier as displayed in the item's properties dialog.
  • Item - items are sorted alphabetically by name
  • Type - items are sorted by type (network, for example)
  • User - items are sorted by name of user who created the item
  • Description - items are sorted by user-defined description added via the item's properties dialog
  • Date - items are sorted by the date last modified
  • Hyperlink - items are sorted by hyperlinks associated with the item via the item's properties dialog

Version controlled items are sorted only at the top level. Any branches below that level are not sorted.

The above details can be displayed in the window by clicking the Show detail (Show detail) button, or by right-clicking in the white space in the tree view section of the window and selecting Tools | Show details.

Find Find

Click this button to select an option to find items in the tree. The options are:

  • Find Modified - searches for items with uncommitted changes and displays them in the Results window
  • Find Associated - searches for items associated with the item currently selected in the tree and displays them in the Results window. For example, click a network in the database tree and use this option to find any workspaces or runs that use the network.
  • Find - displays the Find In Database dialog. Type in text to search for and the property to search, for example name or type. Items found will be displayed in the Results window.
Show hidden

Show hidden

Click this button to display or hide objects in the tree.

Show results

Show results

Click this button to display the Results window in the lower part of the Model Group window.
Shows the database, model group(s), and its contents.

Initially shows only object names, but you can show object details by clicking the Show detail (Show detail) icon on the toolbar.

You can move up the levels of the tree by clicking the Up (Up) icon on the toolbar. If you want to show a model group in the tree exclusively, double-click its name.

You can open a context menu for carrying out actions on an item in the tree view by right-clicking the item.

Recycle Bin The last item in the tree view is the Recycle Bin. Deleted objects are automatically sent to the recycle bin. The number in brackets shows how many items are currently in the recycle bin. Double-clicking this item opens the Recycle Bin window, from which you can restore deleted objects.
Results window

Shown if the Show results (Show results) icon is selected on the toolbar. Show image

Results window

Title bar Describes the search that was performed to obtain the current results.
Find (button)

Find Modified - Searches for items with uncommitted changes.

Find Associated - Searches for associated items. For example, click a network in the database tree and use this option to find any workspaces or runs that use the network.

Find - Displays the Find In Database dialog, letting you search by entering text and object type.

Results area

Lists items that meet the search criteria. The listed items each have a context menu, from which the following actions can be performed:

  • Open - Opens the selected item in the GeoPlan window or, if this is not applicable, opens the properties dialog for the selected item.
  • Select in tree - Selects the item in the tree view above.
  • Select in new window - Opens a new results window for the item and clears the item from the current results window.
  • Properties - Opens the properties dialog for the selected item.
Context menu

Available by right-clicking an item in the tree view.

The following options affect the appearance of the Model Group window.

Model Group window options
Refresh view Refreshes the view to take account of recent changes.
Tools | Show details

Displays or hides details for the items in the tree.

The details displayed are:

  • type of item (run group or network for example)
  • name of the user who created the item
  • user-defined description (added via the properties dialog)
  • date when the item was last modified
  • hyperlinks associated with the item (added via the properties dialog)
  • if user permissions are turned on, the role of the current user in relation to the item (owner, branch owner or viewer)
Tools | Sort columns Enables items in columns to be sorted by name by clicking the column header.
Tools | Sort by

Sorts items by selected parameter.

See Sorting database objects for further information.

Tools | Find checked-out objects Opens up all branches that contain checked out items, so that these items are visible.
Tools | Show hidden items

Displays or hides hidden objects in the tree.

Objects can be flagged as hidden only by Administrators.

The following options are the common actions available for items in the tree. Other actions are available for specific items or sets of items.

Common actions
Open Opens the item in its associated editor, or opens the associated properties dialog.
New Opens a sub menu for creating database objects subsidiary to the current object.
Import /Export Available for some database items. Opens sub menus with origin and target options appropriate for the item.
Delete Deletes the item. You are asked to confirm before deletion takes place.
Rename Opens the Rename dialog, through which you can enter a new name for the item.
Properties Displays the properties dialog for an item.

The following options are the some actions available for items in the Run Group. Other actions are available for specific items or sets of items.

Run common actions
Open WSMarshaller run log Opens the WSMarshaller run log detail in a text format.
Open Validation result This option allows you to examine a network for missing values, errors, and inconsistencies. Refer to Validating networks for more information.
Run/Re-run

This is the standard option. If a run is new, you can select Run to generate results. If results have been deleted, you can Re-run in order to regenerate them.

Once a run has been executed it becomes read only and its setup cannot be modified. This ensures that the results correspond to the model data. The exception to this occurs when a user reserves a run (only applies to cloud database).

In a cloud database, when a Run is reserved by the current user, the following sub-run options are available:

  • Committing changes first
  • Using local changes

It supports the workflow: edit > run > edit > run and it is accepted that current results might not correspond to model data, if an edit is taking place.

The user can regenerate results at any time. The two options allow changes to network and control to be committed, or to be retained on the local machine (i.e. until work is complete).

Clone

Clone is available for cloud and on-premise database.

Selecting this option opens the run in the Schedule Hydraulic Run dialog. The cloned run will have a ! in the run name, which you can change accordingly.

When you click the Save or Run button, it will save the run in the same Run group.

In a cloud database, if the original run is reserved by the current user, then the cloned copy will also be reserved. If reserved to a different user, the clone will be unreserved

Associate live data A live data configuration can be associated with a run once the run has been scheduled. Refer to Associating live data with a run for further information.
Advanced In a cloud database, the following options are available:
  • Reserve for Testing applies to any run that is not currently reserved.
  • Unreserve is available for any reserved run. If that run is reserved by a different user, then confirmation is required (via a dialog box).

In addition to Run, these options are also available for Network and Control in a versioned object.

A "Reserved" status is indicated by the following:

  • Reserved by field in the Object Page of the Properties dialog, showing the username of the reserving user.
  • When a run is Reserved, the username of the reserving user is indicated in the Run context menu.
  • The tooltip shows Reserved by field, displaying the username of the reserving user.
  • An orange border in the icon of Network, Control, and Run appears in the tree view when they are reserved.

Additionally, options for version control are available depending on the version control method in use and the current status of the item. See Managing version controlled objects.

Notes:

  • The Model Group window is a dockable window.
  • The meaning of the different icons displayed in the tree is given in the Database items topic.
  • Model groups can also be displayed in the similar General Group window. The intended use of the General Group window is to display a general model group containing a number of standard items used by other model groups in the database.

Was this information helpful?