Interact with widgets

Interact with widgets

The types of widgets available in your operation view and how you can interact with them depend on how the view was authored. An author can include and configure many types of widgets, although not all types will be part of every operation view. Typically, the operation view contains one map widget, plus a few other types. Because there are many different ways to build an operation view and many tools and options that can be included, the author should provide you with instructions on how to use a widget.

A widget displays information from a particular data source. In some cases, the author configures the data source for a widget to include all features (up to a maximum number of values) in a layer. However, widgets can be configured with the data source being only the topmost or selected item in a list, the result of a query, or the selected feature on a map. In those cases, you need to provide the data source before the contents of the widget will display. For example, a gauge widget can require you to select a feature on the map or in a list; until then, the gauge window will be blank.

Widgets interact with features on the map through feature actions. Feature actions are supported on the map, bar charts, histograms, lists, feature details, and pie charts. The feature actions available are determined by the author, and the author can also set a default feature action. For example, the author can configure a list so you can highlight that feature on the map by double-tapping or double-clicking the entry in the list, or pan to the feature using a context menu accessed by pressing and holding or right-clicking an entry in the list.

Type of widget

What it does

How you can interact with the widget

Bar Chart

Displays the values or counts of feature attributes as bars.

If enabled by the author, you can tap or click a bar to use the default feature action. Press and hold or right-click to use additional feature actions.

Chat

Allows quick and interactive communication between operation view users.

You can start a chat conversation, join a room, send map extents, and so on. Learn how to use a chat widget.

Description

Displays static text in a window.

No interaction available.

Feature Details

Displays detailed information about one feature or row, including a title, description, field information, and one or more media elements.

Tap or click the ellipses at the bottom of the feature details to use feature actions. If there are multiple selected features or input features, you can browse through the features displaying in the widget.

Gauge

Depicts the value or count of a certain attribute as a percentage of a target value.

No interaction available.

Histogram

Displays the values of attributes to show distribution.

If enabled by the author, you can tap or click a bar to use the default feature action. Press and hold or right-click to use additional feature actions.

Indicator

Depicts the state of the value or count of a certain attribute against a target value.

No interaction available.

Legend

Displays a legend for a map. The legend automatically updates when you turn a layer on or off in the map widget.

No interaction available.

List

Displays the contents as a sorted list of items.

If enabled by the author, you can double-tap or double-click an item to use the default feature action. Press and hold or right-click to use additional feature actions. You can also search and filter which features appear in the list. If the top item is selected by default, you might be able to tap or click another feature to select it, and resume focus on the top item in the list.

Map

Displays a map, which is often the primary data source for the operation view and other widgets.

Depending on the tools and feature actions included by the author, you can zoom to features, flash or select features, measure distances, and so on. Learn how to navigate in a map and interact with features in a map.

Pie Chart

Displays the values or counts of feature attributes as proportions of a pie.

If enabled by the author, you can tap or click a pie segment to use the default feature action. Press and hold or right-click to use additional feature actions.

Query

Runs predefined queries about features.

You can execute a query. The query can either be a static filter or be configured to allow you to enter an input parameter.

Summary

Displays a count of features or a summary statistic for a field for a collection of features.

No interaction available.

Custom

Capabilities determined by the developer and author.

Interactions determined by the developer and author.

Arrange widget windows

Widget windows can be either docked or floating, also referred to as popped out. To dock a window and lock it with either the application frame or another window, drag the window onto the preview arrows that appear as you move the window. To make a docked window float so you can move or resize it, use the pop-out control Pop-Out.

Preview docking arrows
The preview arrows indicate where the window will be docked.
Docked windows
Result of docking the windows

To make a widget use the full extent of one of your displays, maximize a floating, popped-out window. If your workstation has multiple monitors, you can pop out a window and drag it onto your secondary monitor. Docked windows cannot be maximized; you need to pop out the window first. You can restore a maximized window to its original size and position from the title bar.

When you minimize a widget window, the widget continues to run in the background. A minimized widget is hidden from the main window and displayed in the Windows task bar. You can see a preview of the widget from the task bar. If a widget is minimized and an event occurs that requires your attention, you'll see an alert in the task bar. For example, if you minimize a chat widget and an incoming chat message is received, a notification appears to let you know that you have a new message. Other widgets can be configured to show alerts, such as having a gauge widget notify you when a threshold is met or an indicator widget that displays when values change.