List view

Overview Copied

The List View is a dockable that can be configured to display a set of related data items. It can be configured to display:

Beginning Geneos 5.8.x, the undo and redo key functions, CTRL + Z and CTRL + Y, are supported in Active Console and Gateway Setup Editor for the following: text fields, multiline texts, and editable drop-down fields.

By default, a new workspace contains the following list views:

All list views provide the following options on their status bar:

List view options Description

Mode mode

Changes the mode according to:

  • Details — presents the data items and their properties in a tabular view.
  • Icon — classic grid-based explorer view where each data item is represented by an icon. If the data items are Managed Entities, the icon displays a label.
  • Netprobe View — similar to the Icon view, except that it adds the Netprobe host and version.
  • List View — a more compact list of data items represented by an icon. If the data items are Managed Entities, the icon comes with a label.

Sort sort

Sorts the list view by a selected property.

Group group

Groups the list view by a selected property.

Groups are dynamic. If a data item is removed from the view and it is empty, then the list view removes the group.

Each group has an icon and colour that defines the severity within the group.

Pause list view list-view-pause

Resume list view list-view-resume

Stops and resumes the list view to update.

When you pause a list view, the Active Consoledoes not update the list view in general. No items can be added or removed, and the data items do not change.

An indication that a list view has stopped is when the blue bar appears on the status bar.

Refresh the view refresh-the-view

Updates the list view based on the current state of the connected Gateway.

Configure the view configure-the-view

Displays the list view settings where you can edit its properties.

Hide the status bar hide-the-status-bar

Hides the status bar in the list view dockable.

List view settings Copied

A list view setting can be defined on a list view dockable and at the workspace level. To open the List View settings, click Configure the view .

These functions are referred to as the list view settings hierarchy:

These are the properties that you can modify in the List View settings:

Content paths settings Copied

This setting allows you to add, remove, and edit the paths that populate a list view.

These are the fields that you can modify:

Field Description

If enabled, the view is grouped by a property depending on the selected dockable each time a selection occurs.

Note: This setting only works if at least one path is configured as Follow User Selection.

Rename tab name on selection If enabled, renames the tab depending on the selected dockable.
Name Name of the path. It is only significant for static paths.

Type of path. This can be static, dynamic, or follow selection.

For more information, see Types of path.

Enabled Toggles whether the path populates the list view. Otherwise, the path does not contribute data items.
Path Actual path which data items must match to end up in the list view.

Populate list views Copied

To create a path, follow these instructions:

  1. Click Add in the Local settings group.
  2. Enter the name of the path in the Name field.
  3. Click the row in the Type column and select the appropriate type of path.
  4. Click the row in the Path field to edit the path properties.
  5. Click OK to save the changes.

Here are some example paths and data items:


Paths are shown in a user readable form. You cannot enter these directly in the field.

Types of path Copied

There are three main types of path that can be configured within a list view:

Path Description

All data items that match the specified path at any given point in time are displayed in the list view.

If a given data item matches more than one configured dynamic path in a single list view, then that data item only appears once.


Data items that match a path are automatically grouped according to the value of the path’s Name field.

Unlike a dynamic path, a single data item that is matched by multiple configured paths can appear multiple times. For example, if the data item is matched by two configured paths, then that data item appears twice on the list view.

Below is the behaviour of the list view depending on the number of matching data items:

  • Matches 0 data items — displays a question mark.
  • Matches 1 data item — displays the data item in a normal way. For example, if the data item is a Managed Entity, the data item on the list view is represented as a Managed Entity icon with its appropriate Managed Entity name.
  • Matches more than 1 data item — lists data items below a group. The group name is the value configured in the path’s Name field.
Follow Selection

The data items that appear on the list view are dependent on the path configured and the data item selected on either the State Tree or Gateways dockables.

Unlike the static and dynamic paths, a Follow Selection path is composed of a Geneos URL, rather than a data item path.

Here are some examples:

  • • geneos://component(ac)/userselection(//managedEntity//dataview)/append(/ancestor::managedEntity)) — displays the parent Managed Entities of the selected dataviews.
  • • geneos://component(ac)/userselection(//managedEntity/ancestor-or-self::*)/append(descendant-or-self::managedEntity)/?(SimulateSelectionOnStartup) — displays all Managed Entities of a selected Gateway.

Filters settings Copied

Filters can be defined in a list view by applying the configured filter on all the data items that are present in the list view.


Filters can only be defined on a list view. These cannot be defined at a dockable level.

By default, the first logic value of the filter is “None”. These are the settings that you can modify:

To add a filter, follow these steps:

  1. Click Add in the Filters group. This adds a new row.
  2. Click the new row and select the logic value (the Logic displays None if you only have one filter).
  3. Select a property on the Property menu.
  4. Select or clear the Not check box.
  5. Select the appropriate operator on the Operator menu.
  6. Enter the value in the Value field.
  7. Click OK to save the changes.

You may add more filters as needed.

Field Description
Hide empty static date item folders

This only applies to static paths.

When enabled, static paths with zero matches are hidden from the list view.

Filters Enabled Enables and disables the filtering function.

Combines two or more filters using the AND and OR conditional operators.

It defaults to NONE if only one filter is configured.

Property The data item property to which the filter is applied to.
Not When enabled, the inverse of the filter is applied to the list view.

Conditional operators that match the configured value:

  • Equals/Equals no case is similar to "=" operator.
  • Contains/Contains no case is similar to the "like" operator.
Value Actual value that needs to be matched.

Drag and drop settings Copied

When you drag and drop a data from the State Tree, Gateways, or Metrics dockable into a list view, the list view’s configured drag and drop rules are applied to it.

The path of the dropped data item is added as a new row on the Content paths settings.

These are the fields that you can modify:

Field Description

Inherits the drag and drop configuration from the parent dockable or workspace, or define it locally on the list view or dockable.

Default value: Inherit from Dockable level settings

ID Name of the drag and drop rule.
Display name

The value is only applied when the path type field is set to static.

When set to static, it follows the behaviour of a static path type.

If the Path Type field is set to Dynamic, the data items are displayed normally which their icons and relevant data item names are displayed.


Configures the paths of the data items relative to the dropped data item.

For example, it can be configured to display all dropped data item’s children that has a critical severity. The path for this example is as follows:


The modifier’s path also determines the path that is added on the Content Paths settings. Using the modifier path above, the content path resolves to:

sgeneos/gateway[(@name="<data item’s Gateway>")]/directory/probe[(@name="<data item’s

Default value: droppeditem()

Path Type Defines the type of paths to be used on the list view.

In the Modifier field, the modified path is added on the Content Paths settings. If enabled, the path on the Content Path is expanded to include the exact paths of the displayed data item.

Default value: Disabled.

This only works if the path field is set to dynamic.


The paths added to this filter are the only ones displayed on the list view. For example, using the following settings:

  • modifier = droppeditem()
  • pahts = /geneos/gateway/directory/probe/managedEntity

The list view only accepts a dropped data item that is a Managed Entity. If the dropped data item is a Sampler, it displays nothing.

Multiple path filters can be added. The Active Console applies the OR conditional operator to them. For example, using the following setting in the Paths section:

  • /geneos/gateway/directory/probe/managedEntity
  • /geneos/gateway/directory/probe/managedEntity/sampler

The list view only accepts either a Managed Entity or a Sampler dropped data item. This setting is useful when the modifier is configured to display the children of a data item. This prevents accidentally adding a parent that has lots of children, such as a Gateway.

Allow general paths

If enabled, Folders (Logical Attribute Folders) that can be found in the State Tree dockable (Logical Mode should be enabled) can be dropped on the list view.

Apply drag and drop rules Copied

To apply or edit your drag and drop rules:

  1. Go to List View settings > Drag and Drop.
  2. Select Define Locally on the Inheritance menu. Otherwise, the rules inherit the Dockable level settings.
  3. Click Add in the Local settings.
  4. Fill out the ID and Display name.
  5. Click Edit in the Modifier field to modify the path. To know more about editing a path, see Path editor.
  6. Click OK to save the changes.

General visual settings Copied

The General Visual settings allows you to modify the aesthetic properties of the list view.

It contains the following settings:

Field Description

Inherits the visual configuration from the parent dockable or workspace, or define it locally on the list view or dockable.

Default value: Define Locally

Background Colour Defines the background colour of the list view.
Default Mode Defines the mode of the list view.
Custom tab name Name of the list view as it appears on the tab. It can also be edited directly by double-clicking on the tab.

Details mode settings Copied

The Details Mode allows you to modify the visual settings of the list view:

In the Details mode, the columns at the top are defined by the properties that are configured in the list view.

These can be changed in the following ways:

There are two ways of removing columns from the details mode:

The column settings for a list view are persisted in the workspace, and restored on load.

Field Description

Inherits the visual configuration from the parent dockable or workspace, or define it locally on the list view or dockable.

Default value: Some settings are defined locally (RowHeight, ShowRootHandles, ShowTreeNodelines, TreeLineColour, SortEnabled)

Row Height

Defines the height of each row.

Unit: pixels

Show Root Handles

defines whether the expand/retract buttons should be displayed to the left of the root level items (folders).

If these are not displayed, you can still access the expand/retract functions by double-clicking the row.

Show Tree Lines Determines whether to show the lines that connect the child nodes to the parent within the tree.
Tree Line Colour Sets the colour of the tree lines.
Sorted Sorts the view.

Properties settings Copied

The Properties settings modify the columns or properties present on the list view. Its inheritance settings default value is Inherit from Dockable level settings.

The main setting is formatted into a table form, also known as a matrix. The rows contain the property names and the columns contain the data item names, such as the Gateway and sampler.

The check marks that intersect the row and column, also known as the delta, mean that the property is available to the data item. Blank cells denote the inverse which is the property is not available on that data item. For example:

The following row values represent the following:

The search field on the properties settings window can be used to search a given property or a data item. The table changes depending on the keyword used.

Workspace level list view Copied

The Workspace level list view settings allow the modification of a list view at the dockable level. This means that this is the parent setting that is inherited by all child list views.

To access this setting, go to Tools > Workspace Level List View Settings.

Beginning Active Console 5.5.x, the Managed Entity display name is used in the user readable path.

List view template editor Copied

The Template Editor allows you to create a new icon view mode and modify the Netprobe view mode.

To create a new mode, follow these steps:

  1. Go to Tools > Workspace Level List View Settings > Templates.
  2. Click Add in the Template Table group.
  3. Double-click the new icon in the Preview column. The List View Template Editor appears.
  4. Change the size and content of the icon depending on your preference.
  5. Drag and drop variables from the toolbar into the container. Only variables within the container appears in the list view.
  6. Click OK to save the changes.

There is a default outline in the List View Template Editor that represents a single instance of a data item in a list view configured with your selected mode. This contains the number of data item properties to be displayed for all data items represented by the mode.

The size and shape of each data item the template is used to represent is defined by the boundary. You can also add new properties in the editor.

To add or edit the properties of the data item, follow these steps:

  1. Drag and drag any data items in the container.
  2. Right-click the selected data item.
  3. Click Properties.
  4. Go to Layout Variable Settings to modify the properties.

The Layout Variable Settings allows you to modify the following properties:

Import and export list views and list view dockables Copied

Individual list views and entire list view dockables can be exported. This can be useful for sharing list view configurations or for creating a backup for each list view.

To export a list view, follow these steps:

  1. Right-click the list view.
  2. Click Export > Configuration.
  3. Enter the file name.
  4. Click Save. This gives you an .ltv extension name.

To export a list view dockable, follow these steps:

  1. Go to View > Dockable Manager or press CTRL + D.
  2. Right-click the list view dockable you want to export.
  3. Click Export.
  4. Enter the file name.
  5. Click Save. This gives you an .ado extension name. Exporting an entire list view dockable includes all the settings at a dockable level and all existing list views (tab) created within the dockable.

To import a list view and list view dockable into your workspace, go to File > Import.

Entities dockable Copied

The Entities dockable is an instance of a list view. It is configured as default in a new workspace.

When following user selection, it displays all the entities relevant to the selected item:

The first tab is also configured to auto-group based on the user selection.

If additional tabs are added, these are configured only to display the entities. When you drag and drop data items into these tabs, the following occur:

Status overview Copied

To open the Status Overview, click View > Status Overview. By default, the Status Overview displays these tabs:


Beginning Active Console 5.5.x, the Managed Entity display name is used in the user readable path.

When you click a row in the Critical and Warning (Under Selection), it opens the data item in the Metrics dataview. For example, the first data item on this list, which refers to /data1.percentageUsed:

This displays its managed entity and sampler the Metrics dataview:

Further reading Copied

To know more about paths, user selections, and dropped items, see Path editor.

["Geneos"] ["Geneos > Active Console"] ["User Guide"]

Was this topic helpful?