Document toolboxDocument toolbox

Manage widgets

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 at the top right and top left, indicating the following:

Icon

Description

Icon

Description

 

 

 

 

 

Only with the required permission

This icon only appears if you have the Manage version of the Domain aggregation tasks permission.

The rocket icon appears on widgets with a source query that is not optimized, that is to say, an aggregation task has not been defined from the source query of the widget.

You can create an aggregation task using the option in the ellipsis menu as explained in the table below or the option in the Network manager as explained in Manage and filter Activeboards.

The aggregation task will be automatically used in the widgets that are fed with that query.

  • 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.

This animation will also appear whenever you apply changes to your widgets, while they load the corresponding new data.

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.

Create aggregation task

Only with the required permission

This option is enabled only if you have the Manage version of the Domain aggregation tasks permission.

Open a window where you can introduce the settings for a new aggregation task. Visit Create a new aggregation task for more information about each setting as well as the process in general.

This option will be grayed-out if the widget does not need to be optimized, in other words, if the rocket icon does not appear.

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. Change the name in the properties of the widget.

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 also 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.Â