Manage widgets

[ 1 Understanding icons ] [ 2 Managing options ] [ 3 Connect a widget to an input ]

Once you have created your widget, you can manage its various settings and fine-tune the style.

Understanding icons

You will notice various icons appear in next to the widget name, indicating the following:

Icon	Description

Icon	Description
	The yellow warning icon appears on widgets whose source query is not optimized, that is to say, an aggregation task has not been defined from the source query of the widget. To optimize widget performance, copy the widget source query and generate an aggregation task from it. The aggregation task will be automatically used in the widgets that are fed with that query. Learn how to generate an aggregation task in the Create a new aggregation task article. Even though your query is optimized with an aggregation task, you may still see the icon in your widgets. This happens when the date range set for the Activeboard is not within the aggregation task time range. For example, if your aggregation task start date is February 15, 2019 and you set your Activeboard time range to 01/01/2019 - 01/30/2019, your widgets will show the icon. Note that the icon will never appear when you select a period of time of less than one hour for your Activeboard or widget, even though your widget query is not optimized. In case of any problem, contact the Devo support team for further information.
	This icon indicates that the widget has a custom time range. To learn more about custom time ranges, go to Setting a time range in Activeboards.
	When widgets receive real-time data, you will see the Real-Time icon next to the widget title. To learn more about the implications of real-time data, go to Time range options in Activeboards and Widgets.
	When receiving real-time data, data retrieval will be a transparent process you barely notice. However, it might be slightly affected by a number of factors. When this happens, a spinner icon will appear to let you know the process is currently ongoing, together with a percentage to indicate the amount of data already retrieved.

Managing options

Depending on which mode you are in when you click the ellipsis button of a widget, you will see the following options:

Go to query	Open a new browser tab to take you to the search window and show you the data table for the query that feeds the widget.
Full view	View the widget in full-screen mode.
Edit data source (edit mode)	Access the widget data source to change it.
View data source (view mode)	Access the widget data source to view it.
Properties	Access the widget configuration options.
Clone (edit mode)	Copy the widget in the Activeboard with the exact same settings (data source, custom date range, etc.) but with cloned automatically added to the name. Click on the widget's properties to change the name.
Export to CSV	Download a table with the widget's data in a CSV file.
Change widget type (edit mode)	A list of widget types appears and you can easily change between widget types. Alternatively, you can drag the widget type from the widget gallery directly onto your widget in the Activeboard:
Delete (edit mode)	Remove the widget from the Activeboard.

Connect a widget to an input

When you add inputs to your Activeboard, the widgets linked to them must reference the input name in their queries to work properly. Depending on the type of data, you need to add a different expression. Learn more here.

By default, widgets connected to an input don't show any data before you enter or select a specific value in the corresponding input. However, you can make them show data (either query data or a specific value) before using the input. This is made by adding a specific operator to the widget query. Learn more here.