The Object List widget displays a list of the objects available in the environment.

The Object List widget displays a data grid with objects in the inventory. The default configuration of the data grid appears in Object List Widget Options section. You can customize it by adding or removing default columns. You can use the Additional Column option to add metrics when you configure the widget.

You edit an Object List widget after you add it to a dashboard. Configuration of the widget enables you to observe parent and child objects. You can configure the widget to display the child objects of an object selected from another widget, for example, another Object List or Object Relationship widget, in the same dashboard.

The widget might be included on any of your custom dashboards. In the left pane, click Home to see your configured dashboards.

To customize the data that appears in the dashboard widget, click Content in the left pane, and click Dashboards. On the Dashboards toolbar, click the plus sign to add a dashboard or the pencil to edit the selected dashboard. In the Dashboard workspace, on the left, click Widget List, and drag a widget to the right pane of the dashboard. On the title bar of the selected widget, click the pencil to access the configuration options.

The object list widget includes toolbar options and data grid options.

Object List Widget Toolbar




Selects from a set of actions specific for each object type. To see available actions, select an object from the list of objects and click the toolbar icon to select an action. For example, when you select a datastore object in the graph, you can select Delete Unused Snapshots for Datastore.

Dashboard Navigation

Navigates you to the object. For example, when you select a datastore from the list of objects and click Dashboard Navigation, you can open the datastore in vSphere Web Client.

Reset Grid Sort

Returns the list of resources to its original order.

Reset Interaction

Returns the widget to its initial configured state and undoes any interactions selected in a providing widget.

Interactions are usually between widgets in the same dashboard, or you can configure interactions between widgets on different dashboards.

Object Detail

Select an object and click this icon to show the Object Detail page for the object.

Perform Multi-Select Interaction

If the widget is a provider for another widget on the dashboard, you can select multiple rows and click this button. The receiving widget then displays only the data related to the selected interaction items.

Use Ctrl+click for Windows, or Cmd+click for Mac OS X, to select multiple individual objects or Shift+click to select a range of objects, and click the icon to enable the interaction.

Display Filtering Criteria

Displays the object information on which this widget is based.


Locate data in the widget.

The data grid provides a list of inventory objects on which you can sort and search.

Object List Widget Data Grid




Unique ID for each object in the inventory, randomly generated and produced by vRealize Operations Manager.


Name of the object in the inventory.


Displays the short description of the object given during creation of the object

Adapter Type

Shows the adapter type for each object .

Object Type

Displays the type of the object in the inventory.


Displays policies that are applied to the object. To see policy details and create policy configurations, select Administration > Policies.

Creation Time

Displays the date, time, and time zone of the creation of an object that was created in the inventory.

Identifier 1

Can contain the custom name of the object in the inventory or default unique identifier, depending on the type of inventory object. For example, My_VM_1 for a VM in the inventory, or 64-bit hexadecimal value for vRealize Operations Manager Node.

Identifier 2

Can contain the abbreviation of an object type and the unique decimal number or parent instance, depending on the type of the object. For example, vm-457 for a VM and an IP address for vRealize Operations Manager Node .

Identifier 3

Can contain a unique number identifying an adapter type. For example, 64-bit hexadecimal value for vCenter Adapter

Identifier 4

Additional unique identifiers for the object. This option varies and depends on the adapter type that the object uses.

Identifier 5

Additional unique identifiers for the object. This option varies and depends on the adapter type that the object uses.

Object Flag

Displays a badge icon for each object. You can see the status when you point to the badge.

Collection State

Displays the collection state of an adapter instance of each object. You can see the name of the adapter instance and its state in a tool tip when you point to the state icon. To manage an adapter instance to start and stop collection of data, select Administration > Inventory Explorer.

Collection Status

Displays the collection status of the adapter instance of each object. You can see the name of the adapter instance and its status in a tool tip when you point to the status icon. To manage an adapter instance to start and stop collection of data, select Administration > Inventory Explorer.

Internal ID

Unique number that vRealize Operations Manager uses to identiy the object internally. For example, the internal ID appears in log files used for troubleshooting.

Following are the Object List Widget configuration options.

Object List Widget Configuration Options




Enter a custom title that identifies this widget from other instances that are based on the same widget template.

Refresh Content

Enable or disable the automatic refreshing of the data in this widget.

If not enabled, the widget is updated only when the dashboard is opened or when you click the Refresh button on the widget in the dashboard.

Refresh Interval

If you enable the Refresh Content option, specify how often to refresh the data in this widget .


You can select the Self, Children , or Parent mode of the widget in the dashboard. For example, you can add two Object List widgets to a dashboard, with names Object List 1 and Object List 2. You can configure Object List 1 as a sender and Object List 2 as a receiver in the Widget Interactions option when you edit the dashboard. If Object List 2 is in self mode and you select an object from Object List 1, Object List 2 displays information only for the object that you selected. If you select parent mode for Object List 1 and children mode for Object List 2, the Object List 2 widget displays only children objects of an object that you select from Object List 1. For example, if you select host system from Object List 1, the Object List 2 widget displays all VMs on this host.

Auto Select First Row

Determines whether to start with the first row of data.

Select which tags to filter

Selects an object or objects from an object tree to observe. For example, to observe information about the VMs and vCenter Server in the inventory, you must click Collapse All and select Virtual Machine and vCenter Server under Object Types .

Additional Column

Adds columns with metrics that are specific for each object to the data grid.

To add a metric, click Pick Metrics to go to the Pick Metrics with Object Type dialog box . You can explore available metrics for an object type and select a metric.

Object Types pane - Use to select the object type from the tree with object types. Metrics in Metric Picker Tree depend on your selection of an object type.

Adapter Type drop-down menu - Use to filter objects in the list based on an adapter that they use. All available adapter types are selected by default. You can select a concrete type using drop-down menu. You can select all adapter types using the close sign next to the drop-down.

Metric Picker - Use to select one or more metrics to observe. The metrics list is different for each object depending on its type and its instance. Each metric that you select is added to the Selected Metrics data grid.

Perform Multi-Select Interaction - Use to select several metrics from the metrics tree.

Select Object - Use to select an object to pick-up metrics.

Selected Metrics - Use to remove selected metric, sort the metrics, reorder them and manipulate the data grid columns.